quentincharrier/cookie-consent-bundle

Sylius bundle for implementing Cookie Consent to comply to AVG/GDPR.

0.9.2 2020-05-07 08:48 UTC

Requires

• php: ^7.2
• doctrine/annotations: ^1.6
• doctrine/doctrine-bundle: ^1.10 || ^2.0
• doctrine/orm: ^2.5
• symfony/asset: ^3.4 || ^4.2 || ^5.0
• symfony/dependency-injection: ^3.4 || ^4.2 || ^5.0
• symfony/doctrine-bridge: ^3.4 || ^4.2 || ^5.0
• symfony/expression-language: ^3.4 || ^4.2 || ^5.0
• symfony/form: ^3.4 || ^4.2 || ^5.0
• symfony/framework-bundle: ^3.4 || ^4.2 || ^5.0
• symfony/http-foundation: ^3.4 || ^4.2 || ^5.0
• symfony/templating: ^3.4 || ^4.2 || ^5.0
• symfony/translation: ^3.4 || ^4.2 || ^5.0
• symfony/twig-bridge: ^3.4 || ^4.2 || ^5.0
• symfony/twig-bundle: ^3.4 || ^4.2 || ^5.0
• twig/twig: ^2.6 || ^3.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^2.14
• phpunit/phpunit: ^7.5
• symfony/yaml: ^3.4 || ^4.2 || ^5.0

MIT

• sylius
• sylius-plugin
• sylius-cookie

README

Cookie Consent bundle for Sylius

Sylius bundle to append Cookie Consent to your website to comply to AVG/GDPR for cookies.

Installation

Step 1: Download using composer

In a Sylius application run this command to install and integrate Cookie Consent bundle in your application:

composer require quentinCharrier/cookie-consent-bundle

Step 2: Enable the bundle

When not using symfony flex, enable the bundle in the kernel manually:

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new ConnectHolland\CookieConsentBundle\CHCookieConsentBundle(),
        // ...
    );
}

Step 3: Enable the routing

When not using symfony flex, enable the bundles routing manually:

# app/config/routing.yml
ch_cookie_consent:
    resource: "@CHCookieConsentBundle/Resources/config/routing.yaml"

Step 4: Configure to your needs

Configure your Cookie Consent with the following possible settings

ch_cookie_consent:
    theme: 'light' # light, dark
    categories: # Below are the default supported categories
        - 'analytics'
        - 'tracking'
        - 'marketing'
        - 'social_media'
    use_logger: true # Logs user actions to database

Step 5: Add cookie policy path

Configure the path to your cookie policy page

# app/config/twig.yml
twig:    
    globals:
        path_to_cookie_policy: '/cookie-policy' # to change to your custom path

Step 5: Add cookie policy path

Configure the path to your cookie policy page

# app/config/twig.yml
twig:    
    globals:
        path_to_cookie_policy: '/cookie-policy' # to change to your custom path

Usage

Twig implementation

Load the cookie consent in Twig via render_esi ( to prevent caching ) at any place you like:

1. Template : Render the consent modal with the form to select the cookie category allowed or not

{{ render_esi(path('ch_cookie_consent.show')) }}

1. Template : Render the notification banner if the cookie isn't allready set.

{{ render_esi(path('ch_cookie_consent.show_if_cookie_consent_not_set')) }}

If you want to load the cookie consent with a specific locale you can pass the locale as a parameter:

{{ render_esi(path('ch_cookie_consent.show', { 'locale' : 'en' })) }}
{{ render_esi(path('ch_cookie_consent.show_if_cookie_consent_not_set', { 'locale' : app.request.locale })) }}

Cookies

When a user submits the form the preferences are saved as cookies. The cookies have a lifetime of 1 year. The following cookies are saved:

• Cookie_Consent: date of submit
• Cookie_Consent_Key: Generated key as identifier to the submitted Cookie Consent of the user
• Cookie_Category_[CATEGORY]: selected value of user (true or false)

Logging

AVG/GDPR requires all given cookie preferences of users to be explainable by the webmasters. For this we log all cookie preferences to the database. IP addresses are anonymized. This option can be disabled in the config.

Themes

TwigExtension

The following TwigExtension functions are available:

chcookieconsent_isCategoryAllowedByUser check if user has given it's permission for certain cookie categories

{% if chcookieconsent_isCategoryAllowedByUser('analytics') == true %}
    ...
{% endif %}

chcookieconsent_isCookieConsentSavedByUser check if user has saved any cookie preferences

{% if chcookieconsent_isCookieConsentSavedByUser() == true %}
    ...
{% endif %}

Customization

Categories

You can add or remove any category by changing the config and making sure there are translations available for these categories.

Translations

All texts can be altered via Symfony translations by overwriting the CHCookieConsentBundle translation files.

Styling

CHCookieConsentBundle comes with a default styling. A sass file is available in Resources/assets/css/cookie_consent.scss and a build css file is available in Resources/public/css/cookie_consent.css. Colors can easily be adjusted by setting the variables available in the sass file.

To install these assets run:

php bin/console assets:install

To install theme assets run:

php bin/console sylius:theme:assets:install 

And include the styling in your template:

{% include "@CHCookieConsent/cookie_consent_styling.html.twig" %}

Javascript

By loading Resources/public/js/cookie_consent.js the cookie consent will be submitted via ajax and the cookie consent will be shown on top of your website while pushing down the rest of the website.

Template Themes

You can override the templates by placing templates inside your poject:

# app/Resources/CHCookieConsentBundle/views/cookie_consent.html.twig
{% extends '@!CHCookieConsent/cookie_consent.html.twig' %}

{% block title %}
    Your custom title
{% endblock %}