WordPress Plugin
The Zero Ad Network WordPress plugin is the fastest path to integration. Install it from the Plugin Directory, enter your clientId, and it handles everything else: injecting the partner header, detecting subscribers, and automatically suppressing ads, cookie banners, popups, and paywalls for Zero Ad Network users.
No code required.
Prerequisites
- A registered site on zeroad.network - you'll need the
clientIdfrom your site's settings - WordPress 4.9+
- PHP 7.2+ with
ext-sodiuminstalled
Install
- In your WordPress admin, go to Plugins > Add New Plugin
- Search for Zero Ad Network
- Click Install Now, then Activate
Alternatively, install manually:
# From your WordPress root
wp plugin install zero-ad-network --activate
Or download from WordPress.org/plugins/zero-ad-network and upload via Plugins > Add New > Upload Plugin.
The source code is available on GitHub.
Configure
After activation, go to Settings > Zero Ad Network and enter:
- Client ID - your site's unique identifier from zeroad.network
- Features - check the features your site supports (Clean Web, One Pass, or both)
| Admin screen | CDN / proxy config |
|---|---|
![]() | ![]() |
Save settings. The plugin immediately starts injecting the X-Better-Web-Welcome header and checking subscriber tokens on every page request.
What the plugin does automatically
Once active, the plugin applies features based on the overlap between the visitor's subscription and your site's declared features. Non-subscribers see your site exactly as before.
Clean Web
For subscribers with a Clean Web plan visiting a Clean Web site:
- Disables supported advertisement plugins (Google AdSense, Advanced Ads, AdRotate, and more)
- Removes cookie consent banners (Cookiebot, CookieYes, Complianz, and more)
- Suppresses marketing popups (Popup Maker, OptinMonster, and more)
- Disables many known third-party non-functional trackers
One Pass
For subscribers with a One Pass plan visiting a One Pass site:
- Bypasses supported paywall plugins (s2Member, MemberPress, Easy Digital Downloads, and more)
- Grants access to content behind subscription plugins (Paid Memberships Pro, WooCommerce Subscriptions, and more)
- Bypasses WordPress password-protected posts
Using with a CDN or proxy cache
If your site sits behind a CDN (Cloudflare, Fastly, etc.) or a caching proxy, you need to ensure pages are not served from cache to subscribers - they need fresh, personalised responses.
The plugin settings page includes a Proxy / CDN Config tab with ready-to-use configuration examples for common setups. Vary the cache key on the X-Better-Web-Hello request header so subscribers and non-subscribers receive different cached versions.
Supported plugins reference
The plugin detects and suppresses the following plugins when the corresponding feature is active for the current visitor.
Advertisements (Clean Web)
| Plugin | WordPress.org slug |
|---|---|
| Ads For WP | ads-for-wp |
| Ad Inserter | ad-inserter |
| Advanced Ads | advanced-ads |
| WP Quads | quick-adsense-reloaded |
| AdRotate | adrotate |
| Raptive Ads | cmb2 |
| Advanced Ads - Google AdSense In-feed | advanced-ads-adsense-in-feed |
| AdWidget | - |
| WP AdCenter | wpadcenter |
| Corner Ad | corner-ad |
| Ad Injection | ad-injection |
| Simple Ads Manager | simple-ads-manager |
| BuddyPress Ads | buddypress-ads |
| Google Site Kit (AdSense) | google-site-kit |
Cookie Consent Banners (Clean Web)
| Plugin | WordPress.org slug |
|---|---|
| Cookiebot | cookiebot |
| Beautiful Cookie Consent Banner | bar-cookie-consent |
| Real Cookie Banner | real-cookie-banner |
| GDPR Cookie Consent | gdpr-cookie-consent |
| Pressidium Cookie Consent | pressidium-cookie-consent |
| WPConsent | wpconsent-cookies-banner-privacy-suite |
| GDPR Cookie Compliance | gdpr-cookie-compliance |
| Complianz | GDPR/CCPA Cookie Consent | complianz-gdpr |
| CookieYes | GDPR Cookie Consent | cookie-law-info |
| Cookie Notice & Compliance for GDPR / CCPA | cookie-notice |
| CookieAdmin | cookieadmin |
| Cookie Notice and Consent Banner | cookie-notice-and-consent-banner |
| Cookies and Content Security Policy | cookies-and-content-security-policy |
| Termly - GDPR/CCPA Cookie Consent Banner | uk-cookie-consent |
| GDPR Cookie Consent | gdpr |
| Cookie Consent Box by Supsystic | gdpr-cookie-consent-by-supsystic |
Marketing Dialogs & Popups (Clean Web)
| Plugin | WordPress.org slug |
|---|---|
| Popup Maker | popup-maker |
| OptinMonster | optin-monster-api |
| Popup by Supsystic | popup-by-supsystic |
| PopupKit | popup-builder-block |
| Popup Anything - A Marketing Popup | popup-anything-on-click |
| Advanced Popups | advanced-popups |
| Popup Box | ays-popup-box |
| Depicter - Popup & Slider Builder | depicter |
| FooBox Image Lightbox | foobox-image-lightbox |
| MailOptin | mailoptin |
| Poptin | poptin |
| Popup Builder | popup-builder |
| Popups for Divi | divi-popup |
| Hustle | hustle |
| WP Popups Lite | wp-popups-lite |
| Icegram Express | email-subscribers |
| Convert Pro | convertpro |
| Newsletter Popup | newsletter-popup |
| Ninja Popups | ninja-popups |
Content Paywalls (One Pass)
| Plugin | WordPress.org slug |
|---|---|
| Content Control | content-control |
| Leaky Paywall | leaky-paywall |
| MemberFul | memberful-wp |
| Protected Video | protected-video |
| s2Member Framework | s2member |
| Secure Copy Content Protection | secure-copy-content-protection |
| Steady for WordPress | steady-wp |
| Pay For Post with WooCommerce | wc_pay_per_post |
| ProfilePress | wp-user-avatar |
| Zlick Paywall | zlick-paywall |
| Easy Digital Downloads | easy-digital-downloads |
| Flexible Subscriptions | flexible-subscriptions |
| SureCart | surecart |
| Restrict Content | restrict-content |
| Simple Membership | simple-membership |
| WP-Members | wp-members |
| Membership For WooCommerce | membership-for-woocommerce |
Subscription Access (One Pass)
| Plugin | WordPress.org slug |
|---|---|
| Paid Memberships Pro | paid-memberships-pro |
| MemberPress | memberpress |
| Restrict Content Pro | restrict-content-pro |
| WooCommerce Subscriptions | woocommerce-subscriptions |
| s2Member Framework | s2member |
| Simple Membership | simple-membership |
| WP-Members | wp-members |
| Leaky Paywall | leaky-paywall |
| Content Control | content-control |
| Paid Member Subscriptions | paid-member-subscriptions |
| WPSubscription | wp_subscription |
| Subscriptions For WooCommerce | subscriptions-for-woocommerce |
WordPress password-protected posts are also bypassed for One Pass subscribers.
Don't see your plugin listed? Contact us - we're actively expanding coverage.

