Wallogit.com
2017 © Pedro Peláez
Includes twig and css templating, js and php logic allowing the display of a cookie acceptance message
Bundles the resources and logic needed to display a cookie acceptance message on a website. The message disapears after the user closed it three times or explicitely clicked on "accept"., (*1)
Includes a default twig + css template., (*2)
With composer:, (*3)
$ composer require c2is/cookie-bundle ~1.0@dev
You will have to register the bundle into your AppKernel. The bundle depends on FOSJsRoutingBundle for the default javascript behaviour, so if you don't have it installed already, register that aswell:, (*4)
``` php // app/AppKernel.php class AppKernel extends Kernel { public function registerBundles() { $bundles = array( ... new FOS\JsRoutingBundle\FOSJsRoutingBundle(), // If not already registered new C2is\Bundle\CookieBundle\C2isCookieBundle(), ); } }, (*5)
Usage ----- You need to add the bundle routing configuration to your application routing like so: ``` yaml # app/config/routing.yml c2is_cookie: resource: "@C2isCookieBundle/Resources/config/routing.yml" fos_js_routing: resource: "@FOSJsRoutingBundle/Resources/config/routing/routing.xml"
There are three routes used in this bundle. One serves the HTML template for your cookie acceptance panel, the others are called with Ajax requests to register the user actions., (*6)
To display the message, I recommend using an esi - the cache duration is managed by the plugin. This will allow the message to appear to a new user whatever your page cache configuration if you use HTTPCacheing. If you don't, it will fallback to the render Twig function and work aswell, so no worries. The default tempalte works best if placed just before or close to the body closing tag in your template., (*7)
``` twig ... , (*8)
... {{ render_esi(url('c2is_cookie_message')) }}
The default template comes with a default css you can include aswell: ``` twig <html> <head> ... <link rel="stylesheet" href="{{ asset('bundles/c2iscookie/css/cookie.min.css') }}" /> </head> ... </html>
For the whole thing to work properly you will need to include the javascript (you will need jquery aswell):, (*9)
``` twig ... , (*10)
...
All this will be for naught before you install your assets though:
$ php app/console assets:install --symlink web, (*11)
Configuration ============= Bundle ------ The exhaustive default configuration is as follows: ``` yaml c2is_cookie: cookie_name: 'c2is_cookie_accepted' cookie_expire: '+3 month' # The expire value for the cookies generated by this bundle. Can be an number or a strtotime valid string occurrences: 3 # The number of times the cookie panel has to be closed / accepted before it won't appear again actions: close: 1 # This number is incremented to the user current occurrences value when he closes the panel accept: 3 # This number is incremented to the user current occurrences value when he clicks "I accept"
The default twig template creates a div with an id of "cookiesLegalMessage". The JQuery plugin used by the bundle expects a container with that id to bind itself to., (*12)
If you override the Twig template and create your own panel, you can initialize the JQuery plugin like so:, (*13)
``` js $('#my-container').c2isCookie( on_closed: function(data) { ... }, on_accepted: function(data) { ... } );, (*14)
Available configurations for that plugin is: - on_closed: defaults to false Can be a function that will be executed when the user closes the cookie acceptance panel. Will receive as argument a json array with the values success: true and message: 'a confirmation message' - on_accepted: defaults to false Can be a function that will be executed when the user accepts the cookie. Will receive as argument a json array with the values success: true and message: 'a confirmation message' There also are events fired when the user closes or accepts the cookie panel: - cookie_closed - cookie_accepted The default plugin behaviour on those actions is to hide the cookie panel. This is done before triggering the events, so you can display it back again in your event listener if you want to display a confirmation message or something. The events are fired from the container so you'll want to listen to that: ``` js $('#my-container').c2isCookie(); $('#my-container').on('cookie_closed', function(data) { ... });
You can override parts of this bundle to better fit your application needs, (*15)
You can create a twig template of your own:, (*16)
app/Resources/C2isCookieBundle/views/message.html.twig
The exhaustive list of messages used and their default english value:, (*17)
yaml
c2is.cookie.accept.message: 'By continuing to browse without changing your parameters, you accept the use of cookies or similar technologies to get services and offers tailored to your interests and to ensure secure transactions on our website.'
c2is.cookie.learn.more: 'Know more'
c2is.cookie.accept: 'OK'
c2is.cookie.close.message: 'By continuing to browse without changing your parameters, you accept the use of cookies or similar technologies on our website.'
c2is.cookie.accept.message: 'You accepted the use of cookies or similar technologies on our website.', (*18)
Includes twig and css templating, js and php logic allowing the display of a cookie acceptance message
MIT