Skip to main content

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 clientId from your site's settings
  • WordPress 4.9+
  • PHP 7.2+ with ext-sodium installed

Install

  1. In your WordPress admin, go to Plugins > Add New Plugin
  2. Search for Zero Ad Network
  3. 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 screenCDN / proxy config
Plugin main config pageProxy / CDN config examples

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)

PluginWordPress.org slug
Ads For WPads-for-wp
Ad Inserterad-inserter
Advanced Adsadvanced-ads
WP Quadsquick-adsense-reloaded
AdRotateadrotate
Raptive Adscmb2
Advanced Ads - Google AdSense In-feedadvanced-ads-adsense-in-feed
AdWidget-
WP AdCenterwpadcenter
Corner Adcorner-ad
Ad Injectionad-injection
Simple Ads Managersimple-ads-manager
BuddyPress Adsbuddypress-ads
Google Site Kit (AdSense)google-site-kit
PluginWordPress.org slug
Cookiebotcookiebot
Beautiful Cookie Consent Bannerbar-cookie-consent
Real Cookie Bannerreal-cookie-banner
GDPR Cookie Consentgdpr-cookie-consent
Pressidium Cookie Consentpressidium-cookie-consent
WPConsentwpconsent-cookies-banner-privacy-suite
GDPR Cookie Compliancegdpr-cookie-compliance
Complianz | GDPR/CCPA Cookie Consentcomplianz-gdpr
CookieYes | GDPR Cookie Consentcookie-law-info
Cookie Notice & Compliance for GDPR / CCPAcookie-notice
CookieAdmincookieadmin
Cookie Notice and Consent Bannercookie-notice-and-consent-banner
Cookies and Content Security Policycookies-and-content-security-policy
Termly - GDPR/CCPA Cookie Consent Banneruk-cookie-consent
GDPR Cookie Consentgdpr
Cookie Consent Box by Supsysticgdpr-cookie-consent-by-supsystic

Marketing Dialogs & Popups (Clean Web)

PluginWordPress.org slug
Popup Makerpopup-maker
OptinMonsteroptin-monster-api
Popup by Supsysticpopup-by-supsystic
PopupKitpopup-builder-block
Popup Anything - A Marketing Popuppopup-anything-on-click
Advanced Popupsadvanced-popups
Popup Boxays-popup-box
Depicter - Popup & Slider Builderdepicter
FooBox Image Lightboxfoobox-image-lightbox
MailOptinmailoptin
Poptinpoptin
Popup Builderpopup-builder
Popups for Dividivi-popup
Hustlehustle
WP Popups Litewp-popups-lite
Icegram Expressemail-subscribers
Convert Proconvertpro
Newsletter Popupnewsletter-popup
Ninja Popupsninja-popups

Content Paywalls (One Pass)

PluginWordPress.org slug
Content Controlcontent-control
Leaky Paywallleaky-paywall
MemberFulmemberful-wp
Protected Videoprotected-video
s2Member Frameworks2member
Secure Copy Content Protectionsecure-copy-content-protection
Steady for WordPresssteady-wp
Pay For Post with WooCommercewc_pay_per_post
ProfilePresswp-user-avatar
Zlick Paywallzlick-paywall
Easy Digital Downloadseasy-digital-downloads
Flexible Subscriptionsflexible-subscriptions
SureCartsurecart
Restrict Contentrestrict-content
Simple Membershipsimple-membership
WP-Memberswp-members
Membership For WooCommercemembership-for-woocommerce

Subscription Access (One Pass)

PluginWordPress.org slug
Paid Memberships Propaid-memberships-pro
MemberPressmemberpress
Restrict Content Prorestrict-content-pro
WooCommerce Subscriptionswoocommerce-subscriptions
s2Member Frameworks2member
Simple Membershipsimple-membership
WP-Memberswp-members
Leaky Paywallleaky-paywall
Content Controlcontent-control
Paid Member Subscriptionspaid-member-subscriptions
WPSubscriptionwp_subscription
Subscriptions For WooCommercesubscriptions-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.