
ZDN Adblock Detector
by cuongquach on WordPress.org

Plugin settings page - Configure JavaScript loading method and minification options
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
- Smart modal reappearance control – configure when the modal shows again after being closed
- NEW: Enable/disable toggle to turn popup detection on or off
- NEW: Front page only option to restrict popup to homepage only
- NEW: Popup logging system to track which users see the popup
- NEW: Admin dashboard with paginated popup logs and analytics
- 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 & Reappearance Options
Version 1.0.5 introduces advanced modal control with flexible closing and smart reappearance 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
-
Reappearance Control: When modal closing is enabled, choose how the modal behaves after being closed:
- No popup again (Default): Modal never appears again once closed
- Popup each visit: Modal appears on every new browser session
- Popup after N days: Modal reappears after specified days (1-365)
Administrators can easily configure these options in the plugin settings to match their site’s approach to adblock detection.
Popup Logging & Analytics
Version 1.0.6 introduces comprehensive popup tracking and analytics features:
- User Activity Tracking: Monitor which logged-in users encounter the adblock popup
- Detailed Analytics: View popup counts, timestamps, and user agent information
- Paginated Admin Dashboard: Browse logs with customizable page sizes (10, 25, 50, 100, 200 items)
- Privacy Controls: Enable or disable logging as needed
- User Management: Track individual users with display names, emails, and popup frequency
- Quick Access: User names in logs link directly to their WordPress profile for fast management
The logging system helps administrators understand:
* Which users are using adblockers
* How often the popup appears to specific users
* Browser and device information for better insights
* Trends in adblock usage across your user base
All logging respects user privacy and only tracks logged-in users when explicitly enabled.
Enable/Disable Controls
Version 1.0.6 also adds granular control options:
- Master Enable/Disable: Turn the entire popup system on or off instantly
- Front Page Only: Restrict popup detection to your homepage/front page only
- Logging Toggle: Enable popup tracking independently of the detection system
These controls allow administrators to fine-tune when and where the adblock detection appears.
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