=== Adqiro — Ad Blocker Detector === Contributors: pluginaddictor, freemius Tags: ad blocker, adblock, anti adblock, advertising, monetization Requires at least: 6.0 Tested up to: 7.1 Requires PHP: 7.4 Stable tag: 3.1.1 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Detect common ad blockers and show visitors clear multilingual instructions for allowing ads on your website. == Description == Adqiro is an ad-blocker detector for WordPress. It uses multiple local detection signals and displays a responsive notice when blocking is detected. The free edition is fully functional and includes: * Multi-signal ad-block detection using local plugin assets and DOM checks. * Classic Light responsive notice design. * Instructions for mobile browsers, Opera / Opera GX, and browser extensions. * English and Russian popup languages with automatic visitor-language selection and a manual language switcher. * Custom English title, message, and reload-button text. * Administrator bypass while logged in. * URL-path exclusions for checkout, cart, account, login, or other sensitive flows. * No required promotional branding on the public-facing notice. * Multi-signal detection combines cosmetic bait elements and lightweight first-party probe files, without running external advertising-network scripts. The detector combines several independent methods because different blockers filter different kinds of advertising resources. The separately distributed Premium edition additionally includes: * Nine additional professionally designed notice layouts. * Strict access mode that removes the visitor bypass link. * Multiple popup color palettes. * Background overlay opacity control. * Adjustable background blur behind the popup. * Automatic dark-mode adaptation. * Full 8-language popup switcher: English, Russian, Polish, German, Spanish, French, Ukrainian, and Hindi. Premium-only implementation files and code are not included in the WordPress.org free package. Freemius Deployment removes all premium-only code from the generated free build. Adqiro is an independent plugin and is not affiliated with Opera or with any browser, ad-blocking extension, or ad-blocking service vendor mentioned in instructional text. == Installation == 1. Upload the plugin files to `/wp-content/plugins/adqiro-ad-blocker-detector/`, or install the ZIP through **Plugins > Add New > Upload Plugin**. 2. Activate **Adqiro — Ad Blocker Detector**. 3. Open **Adqiro** in the WordPress admin menu. 4. Configure detection, text, and any URL exclusions you need. 5. If you use a page-cache plugin or CDN, purge its cache after changing Adqiro settings. == Frequently Asked Questions == = Does the free plugin stop visitors from continuing? = The free edition always provides a visitor bypass link. This keeps the free plugin fully functional while avoiding an unnecessarily aggressive lockout. = What is different in the Premium edition? = The Premium package is distributed separately through Freemius and contains premium-only code that is not present in the WordPress.org free package. It adds nine additional designs, strict access mode, palettes, overlay opacity and background-blur controls, automatic dark mode, and the full 8-language popup switcher. = Can I exclude checkout or account pages? = Yes. Add one URL path per line in **Adqiro > Excluded URL paths**. Matching is performed from the beginning of the URL path and query strings are ignored. = Does the detector request third-party ad-network scripts? = No. Since version 3.1.1, detection uses only local first-party probe scripts and DOM signals. This avoids executing advertising-network code on visitors' pages. = Can every ad blocker be detected? = No browser-side detector can guarantee detection against every blocker or a visitor who deliberately modifies or disables site JavaScript. Adqiro uses multiple signals to make ordinary detection more reliable while reducing false positives. == External services == This plugin includes the Freemius SDK for optional product analytics, licensing, upgrade checkout, and update delivery. When a site administrator chooses to opt in to Freemius, the SDK may communicate with Freemius servers and send installation, site, plugin, and account-related information as described by Freemius. Freemius also handles Premium licensing and Premium update delivery. The core ad-block detection itself runs locally in the visitor's browser and does not require Freemius. Freemius Terms of Service: https://freemius.com/terms/ Freemius Privacy Policy: https://freemius.com/privacy/ == Privacy == Adqiro itself does not store visitor browsing activity on the site server as part of detection. Detection uses first-party resources only. The selected popup language may be stored in the visitor's browser using localStorage so it can be reused on later pages. See the **External services** section for information about the optional Freemius SDK connection used by site administrators. == Changelog == = 3.1.1 = * Prevented a Premium strict-mode MutationObserver feedback loop that could freeze visitor browsers. * Removed execution of third-party advertising-network scripts during detection. * Deduplicated and throttled focus/visibility rechecks to reduce runtime load. * Improved popup dismissal and recovery in non-strict mode. * Updated bundled Freemius SDK to 2.13.5 with upstream security fixes. = 3.1.0 = * Replaced the 3.0.x detector with the complete multi-probe detection engine used by MoveToPoland Anti-Adblock 1.9. * Restored legacy cosmetic bait patterns and ad-named local script probes. * Restored external Google, DoubleClick, GoogleTagServices and Taboola script probes for blockers that allow first-party plugin assets. * Opera / Opera GX uses the legacy lower external-block threshold that successfully detects the browser's built-in ad blocker in the source plugin. * Removed the ineffective 3.0.9 fetch-based Opera fallback. = 3.0.9 = * Added an Opera-specific fallback for the browser's native ad blocker when first-party local probes are allowed. * Requires a successful neutral control request and at least two blocked ad-service probes to avoid treating Opera itself as an ad blocker. * External Opera probes are non-executing and run only when local detection is inconclusive. = 3.0.8 = * Improved real-world ad-block detection using a neutral control bait plus multiple independent cosmetic and local script signals. * Fixed false negatives where blockers hid ad elements but allowed same-origin probe scripts. * Added cache-busting to runtime probes so stale browser cache cannot mask a blocking change. = 3.0.7 = * Fixed a false-positive detection bug caused by cosmetic bait elements being measured inside the hidden popup. * Moved detector bait elements outside the hidden overlay so unblocked browsers no longer report zero-size bait elements. * Tightened detection so generic site CSS alone cannot trigger the blocker notice. * Added a confirmation pass before showing the popup to reduce transient false positives. * Added automatic rechecks while the popup is visible so disabling a blocker can release the notice without a stale strict-mode lock. = 3.0.6 = * Free edition now includes English and Russian popup languages only. * Premium edition adds the full 8-language popup switcher with Polish, German, Spanish, French, Ukrainian, and Hindi. * Replaced the Pro-card License & Pro updates item with the multilingual switcher feature. = 3.0.4 = * Restored iPhone / iPad instruction steps. * Removed divider/outline artifacts from expanded instruction cards. = 3.0.3 = * Added a prominent Pro overview card with direct Freemius upgrade or subscription-management access. * Added an adjustable Premium background-blur control independent from overlay color and opacity. * Added live value updates for Premium opacity and blur sliders. * Consolidated the Free admin upsell into one clear Pro section. = 3.0.2 = * Rebuilt the plugin for WordPress.org free/premium compliance. * Renamed the plugin to Adqiro — Ad Blocker Detector and updated the plugin slug/text domain. * Removed all required public-facing promotional branding. * Moved all Premium implementation into Freemius premium-only files and blocks so it is physically removed from generated free builds. * Reworked detection to use multiple local signals with fewer requests and reduced false positives. * Added URL-path exclusions for sensitive pages. * Replaced vendor-style instruction icons with generic plugin-owned line icons. * Removed automatic activation/deactivation behavior affecting other plugins. * Added WordPress translation-ready admin strings. * Added uninstall option cleanup through Freemius. * Split Premium themes into independent stylesheets loaded only when selected.