WP Manifestindependent plugin directory
manifest / privacy / npbn-cookie-consent

NPBN Cookie Consent

PDPA-compliant cookie consent banner for WordPress

by Nopphan Bunnag · github.com/nopphanb/npbn-cookie-consent · website

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/nopphanb/npbn-cookie-consent/archive/refs/heads/main.zip
Readme github.com/nopphanb/npbn-cookie-consent ↗

PDPA-compliant cookie consent banner for WordPress. Auto-blocks third-party tracking scripts until the visitor gives consent.

Features

  • Granular consent — 4 categories: Necessary, Functional, Analytics, Marketing
  • Dual-layer script blocking — server-side output buffer + client-side MutationObserver
  • No page reload — scripts unblock dynamically when consent is given
  • Settings modal — visitors can toggle individual cookie categories
  • Consent logging — stores consent records with IP, user agent, and categories
  • Shortcode — [npbn_cookie_settings] renders cookie toggles on any page
  • Floating settings button — lets visitors change consent after dismissing the banner
  • PDPA / GDPR ready — opt-in model, easy consent withdrawal
  • Multi-language — built-in Thai/English switch, WPML & Polylang compatible
  • Theme font — inherits the active theme's font family
  • Full-width & backdrop blur — optional appearance settings
  • Auto-update from GitHub — updates appear in the WordPress dashboard

Requirements

  • WordPress 5.8+
  • PHP 7.4+

Installation

  1. Download the latest release zip from Releases
  2. In WordPress admin, go to Plugins > Add New > Upload Plugin
  3. Upload the zip and activate

Or clone into your plugins directory:

cd wp-content/plugins
git clone https://github.com/nopphanb/npbn-cookie-consent.git

Auto-Updates

The plugin checks GitHub Releases for new versions automatically. When a new release is published, you'll see the update in Dashboard > Updates just like any wp.org plugin.

Multi-Language Support

Built-in Language Switch

Select Thai or English in Cookie Consent > Settings > Language. This switches all banner text, button labels, category names, and descriptions.

WPML / Polylang

The plugin is fully compatible with WPML and Polylang:

  • wpml-config.xml included — all text settings (banner heading, button labels, category descriptions, privacy URL) are automatically registered for translation in WPML's String Translation
  • The plugin detects the current frontend language from WPML/Polylang and serves the correct text
  • Category labels and UI strings adapt per language automatically
  • No extra configuration needed — activate WPML or Polylang and translate the strings

Shortcode

Use [npbn_cookie_settings] on any page to render cookie category toggles inline. This is useful for a dedicated "Cookie Settings" or "Privacy Policy" page.

Blocked Domains

Scripts from these domains are auto-blocked until consent is given:

Category Domains
Analytics Google Analytics, GTM, Hotjar, Plausible, Clarity, Segment
Marketing Facebook Pixel, LinkedIn, Bing, Google Ads, TikTok, LINE Tag

Settings

Configure in Cookie Consent > Settings:

  • Language (Thai / English)
  • Banner text, heading, and button labels
  • Banner position (top, bottom, modal)
  • Colors (background, text, button)
  • Full-width banner option
  • Backdrop blur for settings modal
  • Cookie expiry days
  • Category descriptions
  • Show/hide reject-all on banner
  • Show/hide floating settings button
  • Privacy policy URL
  • Reset text to defaults

License

GPL-2.0-or-later