Download the PHP package jostkleigrewe/cookie-consent-bundle without Composer

Symfony Cookie Consent Bundle – GDPR/DSGVO Cookie Banner with Google Consent Mode v2

A modern Symfony 8 bundle for GDPR/DSGVO-compliant cookie consent management. Includes Google Consent Mode v2 support, Twig components, Stimulus.js integration, and AssetMapper compatibility. Perfect for cookie banners, consent modals, and privacy-compliant websites.

📖 Documentation

Why this bundle?

• ✅ Symfony-native consent handling with Twig, Stimulus, and AssetMapper
• ✅ Vendor-level toggles + Consent Mode v2 for modern ad stacks
• ✅ Session-safe by design: prevents unwanted session cookies

Screenshot

Features

• 🎯 GDPR & DSGVO Compliant – Cookie consent with policy versioning and audit logging
• 📊 Google Consent Mode v2 – Built-in GA4, Google Ads, and gtag integration
• 🎨 Multiple Themes – Tabler (light/dark), Bootstrap 5, or custom templates
• ⚡ Stimulus.js & Turbo – Hotwire-compatible, no full page reload needed
• 🗂️ AssetMapper Ready – No Webpack/Encore required, works out of the box
• 🧭 Flexible Storage – Cookie-only, Doctrine ORM, or combined (hybrid)
• 🧩 Vendor-Level Consent – Optional per-vendor toggles (Google Ads, Meta, etc.)
• 🛡️ Session Protection – Prevents session cookies without explicit consent
• 🎬 Embed Components – YouTube, Vimeo, Google Maps, Spotify, Instagram, TikTok with consent gates
• 🧪 Twig Helpers – cookie_consent_has(), cookie_consent_modal(), and more
• 📝 Audit Logging – Track consent changes with optional database persistence

Requirements

• PHP 8.4+
• Symfony 8.0+
• Twig Bundle, Security Bundle, Stimulus Bundle
• Doctrine ORM + DoctrineBundle (optional, only for storage: doctrine|both)

Compatibility

Quick Start

1. Install

2. Register routes

Create config/routes/cookie_consent.yaml:

This registers the /_cookie-consent endpoint required for consent updates.

3. Configure assets

Option A: Twig helper (CSP-compatible, recommended)

This renders a standard <link> tag, fully compatible with strict Content-Security-Policy headers.

Option B: JavaScript import

Note: With strict CSP (style-src 'self'), bundlers may convert CSS imports to data: URLs, which can be blocked. Use Option A if you encounter CSP issues.

4. Render the modal

5. Gate content by consent

Or use lazy loading:

Configuration

Create config/packages/cookie_consent.yaml:

Storage Modes

If storage is set to doctrine or both, generate migrations in your app (bundle ships entities, not migrations). This requires Doctrine ORM:

Increment policy_version when changing categories to require re-consent.

If logging.retention_days is set, run the cleanup command regularly:

Documentation

• Getting Started - Installation, assets, first steps
• Configuration - All options, templates, Twig helpers
• Advanced - Storage backends, session enforcement, logging, events
• Integration - Components, helpers, attributes, data attributes, events
• Changelog - Releases and notable changes
• Contributing - Development workflow and guidelines

Embed Components

Gate third-party content with built-in components:

Alternative:

Available: YouTube, Vimeo, Google Maps, Spotify, Twitter/X, Instagram, TikTok, and more.

Integration Overview

See Integration for Twig components, helpers, data attributes, controller attributes, and events.

Troubleshooting

Modal doesn't appear

• Ensure {{ cookie_consent_modal() }} is in your base template
• Check browser console for JavaScript errors
• Verify Stimulus controller is loaded: @jostkleigrewe/cookie-consent-bundle/cookie-consent

Assets not loading (404)

• Run bin/console cache:clear
• Check AssetMapper paths: bin/console debug:asset-map | grep cookie
• Ensure assets/app.js imports the CSS

Session cookie created before consent

• Check enforcement.require_consent_for_session is true
• Add routes to stateless_routes if they should work without session
• Verify #[ConsentStateless] attribute on stateless controllers

Doctrine storage not working

• Run migrations: bin/console doctrine:migrations:diff && bin/console doctrine:migrations:migrate
• Check storage: doctrine or storage: both is set
• Verify doctrine/orm and doctrine/doctrine-bundle are installed

Google Consent Mode not updating

• Ensure google_consent_mode.enabled: true
• Check gtag is loaded before the consent modal
• Verify category mapping matches your categories

Tabler variant styling issues (missing border-radius, labels below checkbox)

• Cause: Tabler loads after bundle CSS and overrides .modal-content and form-switch styles
• Solution: Update to latest bundle version (>= 0.4.2) which includes Tabler-specific fixes
• Manual fix: Add to your CSS with higher specificity:

Contributing

License

MIT - see LICENSE.

Resources

• Packagist
• GitHub Repository
• Documentation
• Report Issues
• Changelog

Keywords

Symfony cookie consent, GDPR cookie banner, DSGVO cookie modal, Google Consent Mode v2, Symfony 8 bundle, cookie management, consent management platform, CMP, Twig cookie component, Stimulus.js cookie, AssetMapper, Doctrine consent storage, YouTube embed consent, privacy compliance, e-privacy.