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.

adamx8

<p>This widget is everything I ever wanted (so far) in a WordPress widget. Built to stand on it’s own, you can create as many these in different sidebars that you want. I wanted a unique widget for every podcast I was hosting on the AM Podcast Network. Each podcast could have it’s own support widget and it opened up new doors immediately.</p>
<p>There are 3 main areas of this widget to ensure you get your financial support, social support, and newsletter support. While I designed this for podcasting, it can be used on every single WordPress site. You have full control of all the controls and it uses Font Awesome for social icons that you can size. The widget supports Sendy and Mailchimp. I will consider adding more in the future.</p>
<p>I found it frustrating that getting widgets or plugins that are built with Sendy either suck or are premium plugins. This is the reason it’s free with no “Premium” version planned. If you are able to donate or support at all, it’s appreciated. No support is required to use this. All further updates will come as needed.</p>
<p>Let’s dissect this a little further:</p>
<p>Patreon</p>
<ul>
<li>The image for Patreon support should be a 300 x 300px.</li>
<li>Add your Patreon link and it will be an easy click for your supporters.</li>
<li>You can check the box on the widget to disable Patreon support.</li>
<li>Future platform support will be considered.</li>
</ul>
<p>Social Network Icons</p>
<ul>
<li>You choose the color & text size.</li>
<li>Only links you fill in will show.</li>
<li>This has 20 support links: A few notes about the sections above: Android (Google Play), Apple (iTunes), Behance, BTC (Bitcoin), Facebook, Github, Google Plus, Home (website link), Instagram, LinkedIn, Medium, Pinterest, RSS, SoundCloud, Trello, Twitch, Tumblr, Twitter, and YouTube.</li>
<li>All clicks open new tab/window.</li>
</ul>
<p>Newsletter Section</p>
<ul>
<li>You can choose Sendy or Mailchimp.</li>
<li>Add your API URL, API Key, and List ID for Sendy.</li>
<li>Add API Key & List ID for Mailchimp.</li>
<li>The widget can only use one or the other, not both at the same time.</li>
<li>Change the Successful Subscription Message to your own message.</li>
</ul>
<p>Support can be provided at <a href="https://www.ampodcastnetwork.com/forum/forums/total-support-widget/" title="AMPN Support Forum" rel="nofollow ugc">the AM Podcast Network Community</a>. You can ask for help, suggest future changes, or leave a comment.</p>


Total Support Widget

The Total Support Widget gives you Patreon, 20 social & support links, and Sendy or Mailchimp signup.

CaphLabs – Advanced Ad Blocker Fence vs Total Support Widget