=== WPSP Ad Blocker Alert ===
Contributors: wpsmallplugins
Tags: adblock, ad blocker, adblock detection, popup, notification
Requires at least: 5.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 4.4.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Detects visitors using ad blockers and shows a polite, customizable notification popup asking them to disable it.

== 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=1` to any URL to preview without an ad blocker
* Debug mode: append `?wpsp_ad_blocker_alert_debug=1` to see a diagnostic overlay

= Upgrade to Pro =
**[WPSP Ad Blocker Alert Pro](https://wpsmallplugins.com/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 ==

1. Upload the `wpsp-ad-blocker-alert` folder to `/wp-content/plugins/`
2. Activate the plugin via the **Plugins** menu
3. Go to the **WPSP Ad Blocker Alert** menu item in the main admin sidebar to configure

== Frequently Asked Questions ==

= 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=1` to 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](https://wordpress.org/support/plugin/wpsp-ad-blocker-alert/) — 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.

== Screenshots ==

1. The blur + popup overlay as seen by a visitor with an ad blocker enabled.
2. Settings → Basic tab.
3. Settings → Style tab.

== Changelog ==

= 4.4.4 =
* Initial release on WordPress.org.
