Description
WPSP Ad Blocker Alert checks whether a visitor’s browser is blocking ads, using two tests (a CSS bait element and a script bait request), and shows a notification popup over blurred page content.
Features
- Detects common ad blockers, including uBlock Origin, AdBlock Plus, Brave Shields and AdGuard
- Customizable notification message (HTML allowed)
- Blur + popup overlay with adjustable intensity and colors
- Permanent or temporary display mode
- Whitelist specific URL paths to bypass detection on chosen pages
- Random element IDs on every page load, which makes the popup harder for filter lists to target
- Inline script delivery: the detection script is printed into the page instead of loaded from a separate file
- Test mode: append
?wpsp_ad_blocker_alert_test=1to any URL to preview without an ad blocker - Debug mode: append
?wpsp_ad_blocker_alert_debug=1to see a diagnostic overlay
Upgrade to Pro
WPSP Ad Blocker Alert Pro adds:
- Polite Notice — non-blocking top banner instead of a hard popup
- Content Paywall — hides content below the fold with a gradient gate
- Email Opt-in — show a newsletter signup form as the gate (Mailchimp integration included)
- Analytics Dashboard — charts and tables tracking blocked vs clean visits over time
- Consent / GDPR mode — skip detection if the visitor hasn’t accepted cookies
- Export opt-in emails to CSV
Installation
- Upload the
wpsp-ad-blocker-alertfolder to/wp-content/plugins/ - Activate the plugin via the Plugins menu
- Go to the WPSP Ad Blocker Alert menu item in the main admin sidebar to configure
FAQ
-
Does it work with page caching?
-
Yes. Detection runs in the visitor’s browser, so cached pages are not a problem.
-
Which ad blockers are detected?
-
The plugin tests whether typical ad elements and ad scripts are blocked, so it works with common blockers such as uBlock Origin, AdBlock Plus, Brave Shields and AdGuard. No detection method is perfect: a blocker that is configured not to block these tests, or a visitor with the blocker paused for your site, will not be detected.
-
Can I test without an ad blocker?
-
Yes. Append
?wpsp_ad_blocker_alert_test=1to any URL on your site to force the popup to appear. -
Will the popup reappear on every page?
-
Yes. It appears on every page the visitor loads, unless that page is on your Whitelist URLs list.
-
Is this plugin Multisite compatible?
-
No, WPSP Ad Blocker Alert is designed for single-site use only.
-
Where can I get support?
-
Ask on the WordPress.org support forum — the Support tab in the plugin’s own settings links there too. WPSP Ad Blocker Alert Pro customers get priority support instead of the forum queue.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“WPSP Ad Blocker Alert” is open source software. The following people have contributed to this plugin.
Contributors
Translate “WPSP Ad Blocker Alert” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
4.4.4
- Initial release on WordPress.org.