kunstmaan / cookie-bundle
The Kunstmaan Cookie Bundle provides a cookie bar; detailed pop-up window and a similar page explaining each type of cookie used on the website.
Installs: 8 549
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 13
Forks: 9
Type:symfony-bundle
Requires
- php: ^8.1
- doctrine/orm: ^2.13
- kunstmaan/admin-bundle: ^7.0
- kunstmaan/adminlist-bundle: ^7.0
- kunstmaan/config-bundle: ^7.0
- kunstmaan/generator-bundle: ^7.0
- 7.x-dev
- 7.1.x-dev
- 7.1.2
- 7.1.1
- 7.1.0
- 7.1.0-alpha2
- 7.1.0-alpha1
- 7.0.x-dev
- 7.0.5
- 7.0.4
- 7.0.3
- 7.0.2
- 7.0.1
- 7.0.0
- 7.0.0-alpha1
- 6.x-dev
- 6.4.x-dev
- 6.4.3
- 6.4.2
- 6.4.1
- 6.4.0
- 6.4.0-alpha2
- 6.4.0-alpha1
- 6.3.x-dev
- 6.3.1
- 6.3.0
- 6.2.x-dev
- 6.2.5
- 6.2.4
- 6.2.3
- 6.2.2
- 6.2.1
- 6.2.0
- 6.1.x-dev
- 6.1.9
- 6.1.8
- 6.1.7
- 6.1.6
- 6.1.5
- 6.1.4
- 6.1.3
- 6.1.2
- 6.1.1
- 6.1.0
- 6.0.x-dev
- 6.0.6
- 6.0.5
- 6.0.4
- 6.0.3
- 6.0.2
- 6.0.1
- 6.0.0
- dev-master / 1.7.x-dev
- 1.7.0
- 1.6.x-dev
- 1.6.1
- 1.6.0
- 1.5.x-dev
- 1.5.3
- 1.5.2
- 1.5.1
- 1.5.0
- 1.4.x-dev
- 1.4.3
- 1.4.2
- 1.4.1
- 1.4.0
- 1.3.x-dev
- 1.3.1
- 1.3.0
- 1.2.x-dev
- 1.2.7
- 1.2.6
- 1.2.5
- 1.2.4
- 1.2.3
- 1.2.2
- 1.2.1
- 1.2
- 1.1.x-dev
- 1.1.1
- 1.1
- 1.0.x-dev
- 1.0.1
- 1.0
This package is auto-updated.
Last update: 2024-11-01 22:19:36 UTC
README
The Kunstmaan Cookie Bundle provides a cookie bar; detailed pop-up window and a similar page explaining each type of cookie used on the website.
All provide the ability to accept or decline certain cookies.
Original Contributors
Enabling the bundle
Add to Appkernel.php
Add to routing.yml
KunstmaanCookieBundle:
resource: "@KunstmaanCookieBundle/Resources/config/routing.yml"
prefix: /{_locale}/
requirements:
_locale: "%requiredlocales%"
Two ways to view the cookie implementation
1: Login into the CMS
2: enable the cookie bundle under Settings -> Cookie configuration
Importing the cookie bundle
Show cookie on page
Add following block to the main layout of your website
{# Kuma Cookie Bar #}
{% block kumacookiebar %}
<kuma-cookie-bar></kuma-cookie-bar>
{% endblock %}
CSS: First Method
Apply all CSS by importing the legal.scss file into the vendors file of your project
@import "vendor/kunstmaan/cookie-bundle/src/Resources/ui/scss/legal";
CSS: Second method
Import the Kunstmaan Cookie Bundle variables and imports to be overridden. Copy the files at the following path to your project folder.
vendor/kunstmaan/cookie-bundle/Resources/ui/scss/config/_variables.scss vender/kunstmaan/cookie-bundle/Resources/ui/scss/config/_legal-imports.scss
Alter variables and comment imports to fit the project's styling.
Javascript
Via ES Module pattern
import '../../../../../../vendor/kunstmaan/cookie-bundle/bin/';
Via buildtool
You can include the compiled version in your buildtool - or directly in a template - via the following URL:
vendor/kunstmaan/cookie-bundle/src/Resources/ui/bin/index.js
Global methods
The CookieBundle exposes some utility methods that you can include in your project.
import {getKmccCookies} from '<VENDOR_LOCATION>/kunstmaan/cookie-bundle/bin/'; // Returns the settings of all the cookies.
import {hasAllowedDatalayers} from '<VENDOR_LOCATION>/kunstmaan/cookie-bundle/bin/'; // Shorthand to check if you're allowed to use dataLayers in this
project.
import {asyncDomInitiator} from '<VENDOR_LOCATION/kunstmaan/cookie-bundle/bin/'; // This is to initialize async inserted Cookie Bundle Components. Expects 1 param: an object like the following: {nodeTree: <HTMLElement>}
Both these methods are also available on the global scope for projects that do not have bundlers:
window.kmcc.getKmccCookies();
window.kmcc.hasAllowedDatalayers();
window.kmcc.asyncDomInitiator({
nodeTree: <HTMLElement>
});
Commands
Copy Cookiebar Resources to your project
Default command:
php bin/console kuma:generate:legal --prefix foo_ --demosite
or, if you have previously generated files and wish to override them: php bin/console kuma:generate:legal --prefix will_ --demosite --overrideFiles
Migrate
php bin/console doctrine:migrations:diff
php bin/console doctrine:migrations:migrate
Generate fixtures
php bin/console d:f:l --fixtures src/foo/AppBundle/DataFixtures/ORM/LegalGenerator/DefaultFixtures.php --append
Add the optin pagepart to your form pages.
We added an extra LegalOptInPagePart that behaves like a checkbox but adds the extra of a link to the privacy policy directly.
The pagepart will be generated in your bundle and you will have to include it in your pagepart configuration yaml file.
- { name: 'Opt In', class: Foo\WebsiteBundle\Entity\PageParts\LegalOptInPagePart }
Easily generate links for your project that open the cookie modal:
Add by using this snippet you can easily add the necessary links to your project in custom places like a footer:
{% if is_granted_for_cookie_bundle(app.request) %}
{% set legalLinks = ['legal_privacy_policy', 'legal_cookie_preferences', 'legal_contact'] %}
{% for internalName in legalLinks %}
{% set node = nodemenu.getNodeByInternalName(internalName) %}
{% if (node is not null) %}
-
<a data-target="{{ internalName }}" data-url="{{ path('kunstmaancookiebundle_legal_modal', {'internal_name': internalName}) }}"
class="sub-footer__info__link js-kmcc-extended-modal-button">
{{ node.title }}
</a>
{% endif %}
{% endfor %}
{% endif %}
Overriding translations
If you want to override the translations of the cookie bundle, you need to add the following configuration in your config.yml beneath the existing kunstmaan_translator config.
kunstmaan_translator:
default_bundle: custom
bundles:
- KunstmaanCookieBundle
- YourOwnBundle
Add visitor type to google analytics
We added the possibility to push a datalayer to google analytics with the type of visitor viewing your website. A new Config entity has been added where you can add the ip-addresses of clients or internal. Those ip's will be checked on request and a datalayer will be pushed.
If you want to use this functionality, please read the documentation for the Config Bundle to setup. When you did this, add the following snippet to your config.yml.
kunstmaan_config:
entities:
- Kunstmaan\CookieBundle\Entity\CookieConfig
Following input field should be added to your layout.html.twig. You can add in beneath the kuma-cookie-bar element.
<input type="hidden" value="{{ get_visitor_type(app.request) }}" id="kmcc-visitor-type"/>
Increase version number when adding cookies/types or changing stuff the requires new cookie consent.
In the cookie configuration, there is a version number available. This version number can be increased in the CMS.
Contributing
We love contributions! If you're submitting a pull request, please follow the guidelines in the Submitting pull requests