Universal Consent Mode (GCMv2)

Universal WordPress plugin for Google Consent Mode v2 – multilingual (EN, RU, UA, PL), stateless (No-DB), GDPR and Polish PKE 2024 compliant.

🇵🇱 Dokumentacja w języku polskim: README_PL.md

Features

• 3-button consent model: Essential Only / Marketing / Accept All + Customize modal
• Native <dialog> for granular per-category preferences (no polyfill required)
• No-DB Architecture: consent stored in consent_preferences cookie only – no SQL tables
• Google Consent Mode v2: gtag('consent', 'default'|'update', ...) with all 7 parameters
• Google Tag Manager: optional auto-loading, validated GTM ID, noscript fallback
• Script Guard: blocks tracking scripts until consent, dual-attribute (data-consent-category + data-rcm-consent), auto-reactivation
• 4 Languages: EN, RU, UA, PL – auto-detected from WordPress locale (WPML/Polylang compatible)
• Admin Language Manager: tabbed UI to edit all banner/modal texts per language
• Revocation button: permanent floating cookie button on every page (GDPR Art. 7 compliant)
• Geolocation: Cloudflare headers / WP timezone fallback – strict mode for EU/EEA users
• Accessibility: ARIA roles, native focus trap, :focus-visible outlines

Requirements

• WordPress 6.2+
• PHP 8.1+

Quick Setup

1. Activate plugin (consent-mode.php)
2. Go to Settings → Consent Mode Settings
3. Configure GTM Container ID (if needed)
4. Add script handles to Script Guard categories
5. Customize banner text in Language Manager tab

PHP Usage

// Check server-side consent (e.g., for inline analytics)
use ConsentMode\Consent\Consent;

if ( Consent::instance()->has_consent( 'analytics_storage' ) ) {
    // inject analytics
}

JavaScript Events

window.addEventListener( 'consentUpdated', ( e ) => {
    console.log( e.detail ); // { ad_storage: 'granted', ... }
} );

// Public API
window.ConsentBanner.openModal();
window.ConsentBanner.readConsentCookie();

Plugin Structure

consent-mode/
├── consent-mode.php              ← Main plugin file (v1.1.0+)
├── src/
│   ├── Admin/Admin.php           ← Settings API, Language Manager
│   ├── Consent/Bootstrap.php     ← GCMv2 default state + GTM loader
│   ├── Consent/Consent.php       ← Stateless cookie reader
│   ├── Front/Front.php           ← Banner rendering, assets, i18n
│   ├── Front/ScriptGuard.php     ← Script blocking/reactivation
│   └── Geo/Geo.php               ← Country detection
├── assets/
│   ├── css/banner.css
│   └── js/banner.js              ← ES6+, no jQuery, no AJAX
└── docs/POLITYKA_COOKIES.md      ← Cookie policy template (Polish)

Documentation

• 🇵🇱 Polish: README_PL.md – full documentation including GDPR/PKE compliance and cookie policy template
• 📋 Changelog: CHANGELOG.md
• 🍪 Cookie Policy (PL): docs/POLITYKA_COOKIES.md

License

GPL v2 or later