=== WPSP Ad Blocker Alert ===
Contributors: wpsmallplugins
Tags: ad blocker, adblock detection, anti adblock, popup, notification
Requires at least: 5.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 4.4.7
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 collect data or contact other servers? =
No. Detection runs in the visitor's browser, nothing is stored or sent anywhere, and the plugin sets no cookies and makes no requests to outside servers.

= 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.
4. Settings → Display tab (permanent or temporary display, and how long the temporary notice stays).

== Changelog ==

= 4.4.7 =
* Fixed: the settings page no longer scrolls to unrelated notices on every visit.
* Improved: background requests (AJAX, cron) are no longer redirected by the plugin screen checks.

= 4.4.6 =
* Fixed: a blank line in the whitelist no longer switches the detection off for the whole site.
* Fixed: the popup no longer appears for visitors on a poor connection, or when the bait file is missing.
* Fixed: the popup fits small screens and no longer covers the Customizer or post previews.
* Fixed: an invalid colour value no longer causes errors, and a zero popup duration becomes one second.

= 4.4.4 =
* Initial release on WordPress.org.
