CaphLabs

<p>Ad blockers can reduce the revenue that keeps your site running. <strong>CaphLabs – Advanced Ad Blocker Fence</strong> helps you respond in a user-friendly way:</p>
<ul>
<li>Detects common ad blocking behavior (including blocking Google Ad scripts).</li>
<li>Optionally shows a <strong>small warning tag</strong> for a set number of adblocked page views (grace pages).</li>
<li>Then displays a <strong>fence popup</strong> asking visitors to whitelist your site or disable their blocker.</li>
<li>Includes optional <strong>refresh</strong> and <strong>close</strong> buttons, with configurable button text.</li>
<li>Uses lightweight assets and can render in the <strong>footer</strong> or via <strong>wp_body_open</strong>.</li>
</ul>
<p>This plugin is designed to be simple to set up: enable it, write your message, decide your grace count, and you’re done.</p>
<h3>TESTED WITH:</h3>
<ul>
<li>✓ Adblock Plus</li>
<li>✓ Adblock</li>
<li>✓ ExpressVPN Keys</li>
<li>✓ Tampermonkey</li>
<li>✓ NordVPN </li>
<li>✓ AdLock</li>
<li>✓ Total Adblock</li>
<li>✓ Adguard</li>
<li>✓ Privacy Badger</li>
<li>✓ Adremover</li>
<li>✓ Adblock for Chrome™</li>
<li>✓ Brave</li>
<li>✓ Surfshark CleanWeb</li>
<li>✓ Ghostery</li>
<li>✓ uBlocker</li>
<li>✓ Pi-hole</li>
<li>✓ uBlock Origin</li>
<li>✓ Ultrablock</li>
<li>✓ Privacy Badger</li>
<li>✓ DuckDuckGo</li>
<li>✓ Disconnect</li>
<li>✓ Microsoft Edge AdBlock extension</li>
<li>✓ Firefox Tracking Protection</li>
<li>✓ uBlock Origin</li>
<li>✓ Fair AdBlocker</li>
<li>✓ Hola ad remover</li>
<li>✓ Comodo AdBlocker</li>
<li>✓ Opera Built-in AdBlock extension</li>
</ul>
<blockquote>
<p>Note: Ad blockers change frequently. The list above reflects testing on common blockers and privacy tools, but no detection method can guarantee 100% coverage forever.</p>
</blockquote>
<h3>External Services</h3>
<p>This plugin connects to external services:</p>
<p>1) Google AdSense script (ad blocker detection)<br />
This plugin loads https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js to detect when ad scripts are blocked. This helps determine whether an ad blocker is active.<br />
Data sent: This plugin does not intentionally collect or transmit personal data as part of this detection.<br />
Google Terms: https://policies.google.com/terms<br />
Google Privacy Policy: https://policies.google.com/privacy</p>
<p>2) Freemius checkout (optional Pro upgrade)<br />
This plugin may link to Freemius hosted checkout pages if you choose to upgrade to the Pro version.<br />
Data sent: If you click an upgrade/trial link and complete checkout, information you provide during checkout is handled by Freemius.<br />
Freemius Terms: https://freemius.com/terms/</p>
<p>Freemius Privacy Policy: https://freemius.com/privacy/</p>
<h3>How it works (plain-English, step-by-step)</h3>
<h3>1) The plugin loads your saved settings</h3>
<p>Your settings are stored by the plugin and read on each request to decide whether to output the fence markup/scripts and how to behave (grace count, button visibility, etc.).</p>
<h3>2) Front-end CSS is loaded early (wp_head)</h3>
<p>The plugin outputs its front-end CSS so the popup and grace tag can display correctly and immediately.</p>
<h3>3) Front-end JavaScript is output (wp_footer or wp_body_open)</h3>
<p>Depending on your setting (<strong>Include in Header</strong>), the plugin outputs the fence markup + JavaScript in one of these locations:</p>
<ul>
<li><strong>Default:</strong> <code>wp_footer</code> (most compatible)</li>
<li><strong>Optional:</strong> <code>wp_body_open</code> (earlier output; requires theme support)</li>
</ul>
<p>If your theme does not support <code>wp_body_open</code>, the plugin safely falls back to the footer.</p>
<h3>4) Detection runs in the browser</h3>
<p>The plugin uses a practical “real world” detection approach:</p>
<ul>
<li>It attempts to load Google’s Ads script (<code>adsbygoogle.js</code>).</li>
<li>If the script is blocked or fails in certain ways, ad blocking is assumed.</li>
<li>It also performs additional lightweight checks to handle blockers that intercept requests or alter responses.</li>
</ul>
<h3>5) Grace countdown (optional)</h3>
<p>If <strong>Fence after (adblocked pages)</strong> is set above 0:</p>
<ul>
<li>The plugin shows a small warning tag (not the full popup) while the visitor is still within their grace limit.</li>
<li>Once the visitor exceeds the grace limit on adblocked page views, the full fence popup appears.</li>
</ul>
<p>This helps avoid instantly “slamming the door” on first-time visitors while still protecting your monetization over time.</p>
<h3>6) Fence popup behavior</h3>
<p>When the popup is shown:</p>
<ul>
<li>Your <strong>Title</strong> and <strong>Content</strong> are displayed.</li>
<li>The visitor can:
<ul>
<li>Click the <strong>Refresh</strong> button (if enabled) to reload after whitelisting</li>
<li>Click the <strong>Close</strong> button (if enabled) to dismiss (depending on your configuration)</li>
</ul>
</li>
</ul>
<h3>7) Reset countdown after X days (optional)</h3>
<p>If the visitor stops triggering adblock detection for a while, the plugin can reset the grace counter after your configured number of days.</p>
<h3>Settings page: Every option explained (point-by-point)</h3>
<p>Go to: <strong>WP Admin <span aria-hidden="true" class="wp-exclude-emoji">→</span> Settings <span aria-hidden="true" class="wp-exclude-emoji">→</span> Advanced Ad Blocker Fence</strong> (or wherever your plugin places its menu entry).</p>
<h3>Enable Fence</h3>
<p>Turns the plugin on/off. When disabled, the plugin does not show the fence.</p>
<h3>Enable Noscript</h3>
<p>Adds a <code><noscript></code> fallback message for users who have JavaScript disabled.</p>
<p>Why it matters:<br />
– Adblock detection is primarily JavaScript-based.<br />
– A noscript message ensures users with JS disabled still see guidance.</p>
<h3>Title</h3>
<p>The headline shown on the fence popup.</p>
<p>Tips:<br />
– Keep it short and clear (example: “Please support our site”).<br />
– Avoid aggressive language; polite messaging improves whitelist rates.</p>
<h3>Content</h3>
<p>A small WYSIWYG editor for the popup body text.</p>
<p>Use it to explain:<br />
– Ads help fund hosting/content<br />
– How to whitelist your site (simple steps)<br />
– A friendly “thank you”</p>
<p>Note:<br />
– The editor is intentionally lightweight (limited toolbar) to keep output clean.</p>
<h3>Width (in %)</h3>
<p>Controls how wide the popup content area is as a <strong>percentage</strong>.</p>
<p>Examples:<br />
– 40 = compact popup<br />
– 60 = larger popup for more text<br />
– 80 = very wide popup (use carefully on mobile)</p>
<h3>Fence after (adblocked pages)</h3>
<p>This is your grace counter.</p>
<ul>
<li><strong>0</strong> = show the fence immediately on the first detected adblocked page view</li>
<li><strong>3</strong> = show the warning tag for 3 adblocked page views, then fence on the next</li>
</ul>
<p>Recommended starting point:<br />
– 2–3 grace pages for content sites<br />
– 0 grace pages for high-monetization landing pages (use cautiously)</p>
<h3>Reset countdown after (days)</h3>
<p>If adblock is detected again after this many days without a warning, the countdown resets back to the full value.</p>
<p>Examples:<br />
– 7 = weekly reset (reasonable default)<br />
– 30 = monthly reset</p>
<h3>Show Refresh Button</h3>
<p>When enabled, a “refresh” button is shown in the popup.</p>
<p>Typical use:<br />
– Visitor whitelists your site<br />
– Visitor clicks refresh to reload the page cleanly</p>
<h3>Refresh Button (Text)</h3>
<p>Changes the refresh button label.</p>
<p>Examples:<br />
– “I whitelisted — refresh”<br />
– “Refresh page”<br />
– “Try again”</p>
<h3>Show Close Button</h3>
<p>When enabled, shows a close/dismiss button on the popup.</p>
<p>Site owners often choose:<br />
– Enable close for softer approach (less friction)<br />
– Disable close for stricter enforcement</p>
<h3>Close Button (Text)</h3>
<p>Changes the close button label.</p>
<p>Examples:<br />
– “Close”<br />
– “Not now”<br />
– “Continue without ads” (avoid promises you can’t enforce)</p>
<h3>Include in Header</h3>
<p>If enabled, the plugin will attempt to output the fence JS earlier using <code>wp_body_open</code>.</p>
<p>Important:<br />
– Your theme must support the <code>wp_body_open</code> hook<br />
– If not supported, the plugin automatically falls back to footer output</p>
<h3>Minify JS</h3>
<p>Enables an optional inline script packing toggle (where applicable) to reduce output size and make the front-end logic harder to fingerprint.</p>
<p>Note:<br />
Some caching/minify plugins already compress JavaScript globally. If you experience conflicts, disable this option and let your caching plugin handle optimization.</p>
<h3>Branding</h3>
<p>Free version includes a small “Powered by” style badge while the popup is open.</p>
<p>“Branding is optional / administrator opt-in” And extremely appreciated <3</p>
<p>—</p>
<h3>Developer notes (hooks/filters)</h3>
<p>This plugin exposes filters that allow advanced users to alter behavior.</p>
<p>If you are building custom integrations, you may encounter legacy filter names. Some are preserved for backward compatibility.</p>
<p>Common examples include:<br />
– Minify toggle filter<br />
– Branding behavior filter<br />
– Icon and HTML icon customization filters</p>
<p>(Exact hook names may differ by version/build. If you rely on hooks, test after updating.)</p>


CaphLabs – Advanced Ad Blocker Fence

Detect ad blockers and show a clean, customizable “support us” fence (popup) after a configurable grace countdown.

cuongquach

<p>ZDN Adblock Detector is a lightweight plugin that detects when visitors are using ad blockers and displays a friendly message asking them to disable their ad blocker. The plugin features:</p>
<ul>
<li>Reliable adblock detection</li>
<li>Clean and modern overlay design</li>
<li>Customizable message and overlay content</li>
<li>Flexible modal closing options – let visitors close easily or enforce page reload</li>
<li>Multiple closing methods: X button, click outside, or main button</li>
<li>Smart modal reappearance control – configure when the modal shows again after being closed</li>
<li><strong>NEW</strong>: Support for HTML code and links in the message area via Rich Text Editor</li>
<li><strong>NEW</strong>: Enable/disable toggle to turn popup detection on or off</li>
<li><strong>NEW</strong>: Front page only option to restrict popup to homepage only</li>
<li><strong>NEW</strong>: Popup logging system to track which users see the popup</li>
<li><strong>NEW</strong>: Admin dashboard with paginated popup logs and analytics</li>
<li><strong>NEW</strong>: Delayed popup feature – show popup only after configurable page views</li>
<li>Flexible JavaScript loading options (external or inline)</li>
<li>Optional minified script for better performance</li>
<li>Proper internationalization support</li>
<li>Lightweight and fast</li>
<li>Easy to install and use</li>
</ul>
<h4>Modal Closing & Reappearance Options</h4>
<p>Version 1.0.5 introduces advanced modal control with flexible closing and smart reappearance behavior:</p>
<ol>
<li>
<p><strong>Flexible Mode</strong>: Visitors can close the modal using multiple intuitive methods:</p>
<ul>
<li>Click the X button in the top-right corner</li>
<li>Click outside the modal area</li>
<li>Click the main button without forcing a page reload</li>
</ul>
</li>
<li>
<p><strong>Force Reload Mode</strong> (Default): Maintains the original strict behavior where visitors must reload the page to continue</p>
</li>
<li>
<p><strong>Reappearance Control</strong>: When modal closing is enabled, choose how the modal behaves after being closed:</p>
<ul>
<li><strong>No popup again</strong> (Default): Modal never appears again once closed</li>
<li><strong>Popup each visit</strong>: Modal appears on every new browser session</li>
<li><strong>Popup after N days</strong>: Modal reappears after specified days (1-365)</li>
</ul>
</li>
</ol>
<p>Administrators can easily configure these options in the plugin settings to match their site’s approach to adblock detection.</p>
<h4>Popup Logging & Analytics</h4>
<p>Version 1.0.6 introduces comprehensive popup tracking and analytics features:</p>
<ol>
<li><strong>User Activity Tracking</strong>: Monitor which logged-in users encounter the adblock popup</li>
<li><strong>Detailed Analytics</strong>: View popup counts, timestamps, and user agent information</li>
<li><strong>Paginated Admin Dashboard</strong>: Browse logs with customizable page sizes (10, 25, 50, 100, 200 items)</li>
<li><strong>Privacy Controls</strong>: Enable or disable logging as needed</li>
<li><strong>User Management</strong>: Track individual users with display names, emails, and popup frequency</li>
<li><strong>Quick Access</strong>: User names in logs link directly to their WordPress profile for fast management</li>
</ol>
<p>The logging system helps administrators understand:<br />
* Which users are using adblockers<br />
* How often the popup appears to specific users<br />
* Browser and device information for better insights<br />
* Trends in adblock usage across your user base</p>
<p>All logging respects user privacy and only tracks logged-in users when explicitly enabled.</p>
<h4>Enable/Disable Controls</h4>
<p>Version 1.0.6 also adds granular control options:</p>
<ol>
<li><strong>Master Enable/Disable</strong>: Turn the entire popup system on or off instantly</li>
<li><strong>Front Page Only</strong>: Restrict popup detection to your homepage/front page only</li>
<li><strong>Logging Toggle</strong>: Enable popup tracking independently of the detection system</li>
</ol>
<p>These controls allow administrators to fine-tune when and where the adblock detection appears.</p>
<h4>JavaScript Loading Options</h4>
<p>The plugin offers two methods for loading the detection script:</p>
<ol>
<li>External File (Default): Loads the JavaScript from a separate file</li>
<li>Inline JavaScript: Embeds the code directly in the page</li>
</ol>
<p>Some browsers like Chrome may block external JavaScript files that detect ad blockers. If the detector stops working, you can switch to Inline JavaScript mode in the settings.</p>
<h4>Performance and Security</h4>
<p>The plugin includes both regular and minified versions of the detection script. Using the minified version (enabled by default) provides:<br />
* Better performance through reduced file size<br />
* Additional protection against adblockers by making the code harder to detect<br />
* Faster page load times</p>
<h3>Plugin Images</h3>
<p>Banner: banner-772×250.png<br />
Icon: icon-256×256.png</p>


ZDN Adblock Detector

Detects adblockers and shows a cloaking mask to users with active adblockers.

CaphLabs – Advanced Ad Blocker Fence vs ZDN Adblock Detector