Descripción
ZDN Adblock Detector is a lightweight plugin that detects when visitors are using ad blockers and displays a friendly message asking them to disable their ad blocker. The plugin features:
- Reliable adblock detection
- Clean and modern overlay design
- Customizable message and overlay content
- Flexible modal closing options – let visitors close easily or enforce page reload
- Multiple closing methods: X button, click outside, or main button
- Flexible JavaScript loading options (external or inline)
- Optional minified script for better performance
- Proper internationalization support
- Lightweight and fast
- Easy to install and use
Modal Closing Options
Version 1.0.4 introduces flexible modal closing behavior:
-
Flexible Mode: Visitors can close the modal using multiple intuitive methods:
- Click the X button in the top-right corner
- Click outside the modal area
- Click the main button without forcing a page reload
-
Force Reload Mode (Default): Maintains the original strict behavior where visitors must reload the page to continue
Administrators can easily toggle between these modes in the plugin settings to match their site’s approach to adblock detection.
JavaScript Loading Options
The plugin offers two methods for loading the detection script:
- External File (Default): Loads the JavaScript from a separate file
- Inline JavaScript: Embeds the code directly in the page
Some browsers like Chrome may block external JavaScript files that detect ad blockers. If the detector stops working, you can switch to Inline JavaScript mode in the settings.
Performance and Security
The plugin includes both regular and minified versions of the detection script. Using the minified version (enabled by default) provides:
* Better performance through reduced file size
* Additional protection against adblockers by making the code harder to detect
* Faster page load times
Plugin Images
Banner: banner-772×250.png
Icon: icon-256×256.png
Capturas
Plugin settings page – Configure JavaScript loading method and minification options 
Adblock detection overlay – Clean, modern design that appears when an adblocker is detected
Instalación
- Upload the plugin files to the
/wp-content/plugins/zdn-adblock-detectordirectory, or install the plugin through the WordPress plugins screen directly. - Activate the plugin through the ‘Plugins’ screen in WordPress
- Go to Settings > ZDN Adblock Detector to configure:
- JavaScript loading method (external or inline)
- Script version (minified or regular)
- Modal closing behavior (flexible or force reload)
- Customize overlay text and messages
- The plugin will automatically start working
Preguntas frecuentes
-
How does it detect ad blockers?
-
The plugin uses multiple detection methods to reliably identify when ad blockers are being used, including bait elements and behavior analysis.
-
Is it compatible with my theme?
-
Yes, the plugin is designed to work with any WordPress theme.
-
The detector stopped working in Chrome, what should I do?
-
If the detector stops working in Chrome:
1. Go to Settings > ZDN Adblock Detector
2. Change the JavaScript Loading Method to “Inline JavaScript”
3. Make sure “Use minified version” is enabled
These settings will make the detection code harder for browsers and adblockers to block. -
Should I use the minified version?
-
Yes, we recommend using the minified version (enabled by default) as it:
* Improves performance
* Makes the code harder for adblockers to detect
* Reduces bandwidth usage -
Can visitors close the modal without disabling their adblocker?
-
Yes! Version 1.0.4 introduces the “Allow Modal Closing” setting that gives administrators full control:
When Enabled (Flexible Mode):
* Visitors can click the X button to close the modal
* Visitors can click outside the modal to dismiss it
* The main button closes the modal without forcing a page reloadWhen Disabled (Default – Force Reload Mode):
* Visitors must click the main button, which forces a page reload
* This maintains the original strict behavior for maximum effectivenessYou can find this setting in Settings > ZDN Adblock Detector > Overlay Content section.
Reseñas
Colaboradores y desarrolladores
“ZDN Adblock Detector” es un software de código abierto. Las siguientes personas han colaborado con este plugin.
Colaboradores
Traduce “ZDN Adblock Detector” a tu idioma.
¿Interesado en el desarrollo?
Revisa el código , echa un vistazo al repositorio SVN , o suscríbete al log de desarrollo por RSS .
Registro de cambios
1.0.4
- Added flexible modal closing feature – administrators can now configure whether visitors can close the modal without reloading
- New “Allow Modal Closing” setting with multiple closing options (X button, click outside, main button)
- Enhanced user experience with intuitive modal closing methods when flexible mode is enabled
- Fixed WordPress translation loading warning – translations now load at proper init hook
- Added proper internationalization support with POT template file
1.0.3
- Added customizable overlay text options in settings
- Improved adblock detection efficiency
- Fixed minor UI issues
1.0.2
- Update detection script for better detection (ublock origin lite)
1.0.1
- Added settings page for JavaScript loading method
- Added option to use minified version of the script
- Updated button text
- Improved overlay behavior with page refresh
1.0.0
- Initial release