=== DeBlocker Plus ===
Contributors: deblocker, merkulove
Tags: ad blocker, adblock, adblock detector, anti adblock, adblock detection
Requires at least: 6.5
Tested up to: 7.0
Stable tag: 1.0.0
Requires PHP: 8.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Detect visitors using an ad blocker and show a customizable, multilingual popup asking them to disable it to keep supporting your content.

== Description ==

DeBlocker Plus detects when a visitor is browsing your site with an ad blocker enabled and displays a fully customizable notice — a popup or a full-screen overlay — inviting them to disable it. You control the title, the message, the appearance, the close and action buttons, and exactly where the notice appears.

Key features:

* Reliable ad blocker detection using a lightweight front-end script.
* Customizable popup or full-screen overlay with your own title, message and buttons.
* Granular display scopes — target by post type, individual posts, categories, tags, author archives, front page, search, 404 and more.
* Audience targeting by user role and device (desktop or mobile).
* Multilingual, with WPML and Polylang support (25+ languages).
* Insights dashboard to track detections, redirects and closes over time.

The front-end and admin assets are compiled from React/TypeScript and Sass. The complete, unminified source and build instructions are included in the plugin's `sources/` directory.

== External Services ==

This plugin relies on the DeBlocker Plus API service (https://web.deblocker.app) to operate. The service is required to build the detection scripts served to your visitors, validate your license key, and generate the insights shown in the dashboard.

The following data is sent to the DeBlocker Plus API:

* Your site URL, admin-ajax URL and REST endpoint base.
* Your WordPress version, PHP version and plugin version.
* Your DeBlocker Plus API key, used to authenticate requests.
* Detection, redirect and close events used to generate the insights dashboard.

Data is sent when the plugin builds or rebuilds its scripts, when it validates your API key, when a detection/redirect/close event occurs, and when the insights dashboard is loaded.

By using this plugin you agree to the DeBlocker Plus service terms and privacy policy:

* Terms of Service: https://web.deblocker.app/terms
* Privacy Policy: https://web.deblocker.app/privacy

== Installation ==

1. Install using the WordPress built-in Plugin installer, or extract the zip file and drop the contents in the `wp-content/plugins/` directory of your WordPress installation.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to the plugin settings and paste your API key to connect to the DeBlocker Plus service.

== Minimum Requirements ==

* WordPress 6.5 or greater
* PHP version 8.0 or greater
* MySQL version 5.0 or greater

== Recommended Hosting Requirements ==

* WordPress 7.0 or greater
* PHP version 8.2 or greater
* MySQL version 8.0 or greater OR MariaDB version 10.4 or greater.
* Nginx or Apache with mod_rewrite module
* WordPress Memory limit of 64 MB or greater (128 MB or higher is preferred)
* HTTPS support

== Screenshots ==

1. The DeBlocker Plus detection popup shown to visitors using an ad blocker.

== Changelog ==

= 1.0.0 =
* Initial release of the DeBlocker Plus plugin.

== Upgrade Notice ==

= 1.0.0 =
* Initial release of the DeBlocker Plus plugin.
