Description
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
- Flexible JavaScript loading options (external or inline)
- Optional minified script for better performance
- Lightweight and fast
- Easy to install and use
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
Screenshots
Plugin settings page – Configure JavaScript loading method and minification options 
Adblock detection overlay – Clean, modern design that appears when an adblocker is detected
Installation
- 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)
- The plugin will automatically start working
FAQ
-
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
Reviews
Contributors & Developers
“ZDN Adblock Detector” is open source software. The following people have contributed to this plugin.
Contributors
Translate “ZDN Adblock Detector” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
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