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.

jabedbd

<p>An Easiest solution for showing message to the user to whitelist the site on their adblocker</p>


Unblock Adblocker

An Easiest solution for showing message to the user to whitelist the site on their adblocker

CaphLabs – Advanced Ad Blocker Fence vs Unblock Adblocker