GioCookies

Lightweight cookie consent banner for WordPress, built around Google Consent Mode v2, Google Tag Manager and the WP Consent API.

About

GioCookies shows an accessible cookie banner, prints Google Consent Mode v2 defaults before your tags load and updates them when visitors decide. It runs entirely on your site: no external service, no account, no cookie scanning in the cloud.

GioCookies does not provide legal advice and does not guarantee compliance. It does not scan cookies and is not an IAB TCF or Google-certified CMP. Review your cookie policy and configuration with your legal advisor.

Features

• Consent Mode v2 — gtag('consent', 'default', …) is printed at the top of the <head>, before Google Tag Manager, and updated on every decision.
• GTM-friendly — a cookie_consent_update event with { necessary, analytics, marketing } is pushed to the dataLayer.
• Equal choices — "Reject all" and "Accept all" have the same visual weight; "Customize" opens the per-category switches.
• Configurable categories — Analytics and Marketing can be turned off when a site does not use them.
• Script blocking — scripts not managed by GTM run only after consent (type="text/plain" + data-giocookies-category, or enqueued handles via a filter).
• WP Consent API — choices are shared with plugins that support it.
• Privacy-friendly consent log — anonymized IP, random consent ID, choices, policy version and date, with automatic retention cleanup and CSV export.
• Re-ask consent — change the consent version when your policy changes.
• Multilingual — empty fields use translatable defaults; custom texts work with WPML/Polylang (wpml-config.xml) or the giocookies_text filter.
• Accessible — dialog semantics, keyboard support, visible focus, native switches, reduced motion.
• Themeable — style it with --giocookies-* CSS custom properties.

Requirements

• WordPress 6.2 or later
• PHP 7.4 or later

Installation

Download the latest zip from the Releases page and upload it from Plugins → Add New → Upload Plugin, or clone the repository into wp-content/plugins/:

git clone https://github.com/GiovanniBevacqua/giocookies.git wp-content/plugins/giocookies

Then open GioCookies → Settings, enable the banner and set your privacy and cookie policy pages.

Google Tag Manager

Keep your GTM snippet after wp_head() (GioCookies prints the Consent Mode defaults earlier, at the very top of the head). In GTM, enable Consent Overview and require analytics_storage for analytics tags and ad_storage for advertising tags, or trigger tags on the cookie_consent_update event.

For developers

<!-- Runs only after the visitor accepts Marketing cookies -->
<script type="text/plain" data-giocookies-category="marketing" src="https://example.com/pixel.js"></script>

// Block an enqueued script until Analytics consent is given.
add_filter( 'giocookies_blocked_script_handles', function ( $handles ) {
    $handles['my-analytics'] = 'analytics';
    return $handles;
} );

JavaScript API: window.GioCookies.open(), window.GioCookies.getConsent(), window.GioCookies.hasConsent( 'analytics' ) and the giocookies:consent DOM event. The [giocookies_preferences] shortcode prints a button that reopens the banner.

Contributing

Contributions are welcome! Please read CONTRIBUTING.md before opening an issue or a pull request.

To report a security vulnerability, please follow SECURITY.md and do not open a public issue.

Changelog

See CHANGELOG.md.

License

GioCookies is free software, released under the GNU General Public License v2.0 or later.

Made by Giovanni Bevacqua · giosuite.com