The Ad Blocker Detector add-on detects when a visitor is using an ad-blocking browser extension and displays a full-page overlay asking them to disable it — helping you protect your advertising revenue.
Pricing: This is a paid add-on, available from the Larapen Marketplace.
Key Features
- Dual detection — Uses both DOM-based cosmetic filter detection and network-level request blocking detection for high accuracy against popular ad-blocking extensions (uBlock Origin, AdBlock Plus, etc.).
- Full-page overlay — When an ad blocker is detected, a full-page modal overlay appears with a shield icon, a configurable title and message, step-by-step instructions, and an “I’ve Disabled It” recheck button.
- Configurable detection delay — Set a delay (100–5000 ms) before running detection. Higher values reduce false positives.
- Dismiss option — Optionally allow visitors to dismiss the overlay and continue browsing without disabling their ad blocker.
- Custom overlay text — Configure the overlay title and message per language from the admin panel. Leave empty to use the default translations.
- Auto-injection via middleware — The detector is automatically injected into all front-end pages. No template modifications needed. Admin pages are excluded.
- Theme override support — Themes can provide their own overlay design by overriding the default view.
- Accessible overlay — The overlay uses
role="dialog",aria-labelledby,aria-modal="true", and meets WCAG AA color contrast standards.
Admin Panel
| Section | Description |
|---|---|
| Settings | Enable/disable detection, set detection delay (100–5000 ms), configure the dismiss behavior, and customize the overlay title and message per language. |
Configuration
| Setting | Default | Description |
|---|---|---|
| Enabled | Yes | Enable or disable ad blocker detection globally. |
| Detection delay | 300 ms | Delay in milliseconds before checking for ad blockers. |
| Allow dismiss | No | Whether users can close the overlay without disabling their ad blocker. |
| Custom title | empty | Custom overlay title per locale (JSON). Leave empty for the default translation. |
| Custom message | empty | Custom overlay message per locale (JSON). Leave empty for the default translation. |
Front-end
- Invisible detection script that runs on page load after the configured delay.
- Full-page overlay displayed only when an ad blocker is detected. The overlay locks page scrolling and is fully responsive.
- The “I’ve Disabled It” button rechecks detection and reloads the page if the ad blocker has been turned off.
Dependencies
None — the Ad Blocker Detector add-on works independently. No database tables are created; all settings are stored in the core settings table.
Ideal for
- Websites that rely on advertising revenue.
- Content publishers wanting to protect their ad income.
- Media sites with display ad monetization.
- Freemium models where free users see ads.