Dokumentation - we_cookie_consent 4.1.2 - English
Same as version 4.0.1. differs, however, in the following places:
2.1. Prerequisites
The extension NO longer uses jQuery in the frontend.
4.2.5. Use of the Google Tag Manager export function within the Cookie Consent Extension
To simplify matters, you can use the export function to export the created tags, triggers and variables from the services for GTM and then import them into the GTM container.
In addition, a variable called "we_consent_state" and a trigger called "cmp_we_cookie_consent_changed" are provided, which are required for using the CMP in Consent Mode 1 (Basic) and Consent Mode 2 (Advanced). This is used to notify the CMP of all changes to consent.
7.1. Customizing the TYPOScript parameters
- Storage folder: The ID of the data record folder is stored here. See point 2.4.2.
- Privacy page: You must enter the UID of your privacy page in the Privacy page input field. See point 2.4.2.
- Style Prefix: In the Style Prefix input field, you can adjust the positioning of the cookie banner.
Input options:- Display at the bottom of the screen: klaro we_cookie_consent (default)
- Display at the top of the screen: klaro we_cookie_consent notice--top
- Display in the middle with the buttons below each other: klaro we_cookie_consent notice--center
- Display in the center with the buttons below and next to each other: klaro we_cookie_consent notice--center--floated
- Unstyled output without CSS: nostyle
- Additonal Class: Here you can add an additional CSS class for the styling
- Storage Method: Here you can set whether the user settings should be saved in a cookie or in the browser's local storage. (Default: Cookie)
- Cookie Name: You can change the name of your consent cookie in the Cookie Name input field. This was designed for the use of different language versions with different services that are provided via directories and not via different top level domains.
- Lifetime: In the Lifetime input field, you can specify the validity period of the cookie. After this time has expired, the user is asked to accept the cookies again. The default setting is 365 days.
- State: In the State input field, you can set whether your cookies are preset to activated or deactivated in the cookie banner. Input options: false (default), true (not GDPR compliant!)
- Must Consent: In the Must Consent input field, you can set whether users can use your website without interacting with the cookie banner. Input options: false (default), true (not GDPR compliant!)
- Group Service: Here you can activate or deactivate the grouping of services into categories. The grouping is based on TYPO3 system categories.
- Accept all: Here you can set whether all services are activated when the banner is clicked away without user action.
- Hide Decline all: Here you can set whether the "Decline" button should be displayed. (The button is displayed by default)
- Hide Learn more: Here you can set whether the "Edit settings" button should be displayed. (The button is displayed by default)
- Cookie domain: Here you can configure whether the settings made are only valid for the current domain or also for subdomains.
- Consent Mode Basic: The default settings for Google Consent Mode Basic can be activated here: With Google Consent Mode Basic, NO Consent Mode default settings are initially loaded for the consent types!
- Consent Mode Advanced: The default settings for Google Consent Mode Advanced can be activated here: With Google Consent Mode Advanced, ALL Consent Mode default settings for the consent types are initially loaded with "Denied"! This makes it possible to model the data with Google Analytics, for example, without consent.
- Cookie icon permanently available: You can use it to create a permanent output of the consent control on all pages (bottom left)
- Icon field default: You can use it to store your own icon for the permanent output of the consent control
- Icon field hover: You can use it to store your own icon in hover state for the permanent output of the consent control
IMPORTANT: Before using Google Consent Mode, please check how you are allowed to handle the data and which jurisdiction or company guidelines apply to you!
8.3. Consent Mode WITH Google Tag Manager
When using an integrated or individual service WITH Google Tag Manager (Google Tag Manager service), proceed as follows:
- Activate the Consend Mode "Basic" or "Advanced" in the TYPOScript parameters
- Navigate to the List module and select Cookie Consent in the page tree
- Click on the edit icon of the corresponding Google service
- In the Google Consent Mode tab, make the settings for the consent types in the event of consent
- Click on Save
- Download the GTM template (template.tpl) for we_cookie_consent from Github (https://github.com/websedit/gtm-template-typo3-we_cookie_consent-cmp) -> continue with step 7
Or search for it directly in GTM under Templates -> Search in gallery -> Import tag template -> Search field: "TYPO3 we_cookie_consent CMP" and add it to the workspace -> continue with step 13 - Switch to the Google Tag Manager interface (https://www.google.com/intl/de/tagmanager/)
- Click on Templates in the left-hand area
- Click on "New" in the "Tag templates" area on the right to create a new template
- In the subsequent window, click on the three dots at the top right and select "Import"
- Select the downloaded template.tpl file and click on "Open"
- Finally, click on "Save" in the top right-hand corner of the template editor. The template is now imported.
- Switch to Tags in the left-hand area
- Create a new tag, give it the name "TYPO3 we_cookie_consent CMP" and select the template "TYPO3 we_cookie_consent CMP" in the tag configuration
- Configure the setting options (Default consent settings, Wait for Update, Redact Ads Data, Enable URL passthrough, Cookie ID to check) according to your requirements.
Important: You do not need to carry out any configuration. The template is structured in such a way that it is compatible with the default settings of the TYPO3 extension we_cookie_consent. Entries for the "Default consent settings" and "Cookie ID to check" are therefore not mandatory. - Set the value for "Wait for Update" to "500" ms. This is usually sufficient.
- Assign the trigger "Consent Initialization - All Pages" to the new tag
- Also assign the trigger "cmp_we_cookie_consent_changed" to the new tag using the "or" link
- Then use the preview function of the Google Tag Manager to check extensively whether all services with the correct consent types are being rolled out and your tags are being fired in the right place.
- Once all tests have been completed, you can publish the new tag via "Send"