Installation
- Open the Plugin Manager via Extensions > My Extensions
- Upload, install and activate the plugin
Configure the Plugin
Extensions > My Extensions > EU Cookie Directive Pro > Configure
Basic Settings
- Active
Activates the cookie notice and the control of non-functional cookies for the selected sales channel. - Enable automatic cookie detection
Automatically detects previously unknown cookies from the shop domain. Once all services in use have been detected and configured, automatic detection can be disabled. - Cookie information shop page
Defines the privacy policy or information page linked in the cookie notice. If no page is selected, the privacy policy stored in the basic information is used. - Footer shop page 1 to 3
Allows up to three additional CMS pages to be linked, such as the legal notice, privacy policy or other legal information. - Alternative display name
Overrides the name of the selected CMS page within the cookie notice. - Delete unconfirmed cookies after X days
Defines after how many days automatically detected but unconfirmed cookies are removed. A value of 0 disables automatic deletion.
Functions
- Enable non-functional cookies by default
Defines whether non-functional cookies are preselected by default in the privacy settings. - Display “Accept functional cookies only” button
Adds a button that allows customers to accept only technically required cookies. - Display “Accept selected cookies” button
Defines whether the button is always displayed or only when the cookie settings are open. - Display “Accept all cookies” button
Allows customers to accept all cookies listed in the cookie notice at once. - Expand cookie settings when opening the page
Displays the cookie groups and selection options immediately when the cookie notice is opened for the first time. - Reload page automatically
Reloads the current page after consent has been given so that previously blocked content can be loaded immediately.
- Do not transfer cookie status to the data layer
Prevents the stored consent status from being transferred to the data layer. - Level of detail for data layer transfer
Defines which cookie information is provided in the data layer for Google Tag Manager. - Google Consent Mode update
Defines when changes to the consent status are transmitted to Google. - Request cookie consent again
Displays the cookie notice again regardless of previously stored consent. This can be used, for example, after new cookies have been added. - Cookie consent by group or individual cookie
Defines whether customers can enable and disable individual cookies or only complete cookie groups.
- Cache-friendly mode
Initially delivers the cookie notice, cookie scripts and settings identically for all visitors and then adjusts them via JavaScript based on the stored consent. This allows the Shopware HTTP page cache to be used more effectively.
Layout
- Layout
Defines whether the cookie notice is displayed as a classic banner at the bottom of the page or as a modal window. - Display heading in the cookie notice
Displays an additional heading. The content can be adjusted using the text snippet acrisCookieConsent.heading. - Alternative background color
Defines the background color of the cookie notice. - Alternative background color for group names
Defines the background color of the expandable cookie groups. - Alternative font color
Overrides the default text color of the cookie notice. - Alternative border color
Overrides the default color of borders and separators. - Title/description layout
Defines whether group titles are displayed next to or above the corresponding description. - Display buttons with equal width
Displays all buttons in the cookie notice with the same width. - Button width in pixels
Defines the common width of the buttons when equal-width display is enabled. - Button type
Defines the display style of the consent and settings buttons. - Button priority
Determines the order of the buttons. The higher the entered priority, the further forward the corresponding button is displayed.
Manage Cookie Groups
Settings > Extensions > EU Cookie Directive Pro > Cookie Groups
Cookie groups organize the available cookies within the cookie notice. Typical groups include “Functional”, “Tracking” or “Marketing”.
- Click “Add” to create a new cookie group
- Enter a title and description
- Maintain translations using the language selection
- Save the cookie group
Before deleting a cookie group, the included cookies should be assigned to another group. Cookies without a group are not displayed in the cookie notice.
Manage Cookies
Settings > Extensions > EU Cookie Directive Pro > Cookies
The overview displays automatically detected cookies, cookies registered by Shopware or other extensions and manually created cookies.
Automatically detected cookies should be reviewed, described, assigned to an appropriate group and then activated.
Create or Edit a Cookie
Settings > Extensions > EU Cookie Directive Pro > Cookies > Add
Identification
- Cookie ID
Unique technical identifier of the cookie. This field may not be editable for automatically registered system cookies. - Active
Enables the cookie for display and selection in the cookie notice. - Cookie group
Assigns the cookie to a previously created group. The assignment is required for the cookie to be displayed in the cookie notice.
Customer Information
- Title
Customer-friendly name of the cookie displayed in the storefront. - Provider
Name of the company or service using the cookie, such as Google, Meta or the shop itself. - Description
Explains the purpose of the cookie and, where applicable, the information processed through it.
The title and description can be maintained for additional languages using the language selection.
Sales Channel
- Sales channels
Defines the sales channels in which the cookie is displayed in the cookie notice. Automatically detected cookies are assigned to the sales channel in which they were found.
Script Code
- Script code
Stores a script that is executed only after consent has been given for the cookie. The code can be entered with or without a script tag. - External script
Allows an external JavaScript file to be included using the src attribute. - Twig code
Allows Twig code and Twig variables to be used within the script field. - Script code position
Defines whether the code is inserted at the end of the HTML header, at the beginning of the HTML body or at the end of the HTML body.
Default Value and Expiration Period
- Default value
Sets the cookie to the stored value after consent has been given. This allows the storefront to check whether a specific function has been enabled. - Expiration period in days
Defines after how many days the cookie is deleted. If no individual value is entered, an expiration period of 30 days is used.
Google Consent Mode V2
- ad_storage
Consent to store advertising-related cookies or device identifiers. - ad_user_data
Consent to transfer user data to Google for advertising purposes. - ad_personalization
Consent to use personalized advertising. - analytics_storage
Consent to store data for analytics and statistics functions. - functionality_storage
Consent to store data for functions such as language or display settings. - personalization_storage
Consent to store data for personalized content and recommendations. - security_storage
Consent to store security-related data, such as information used for authentication or fraud prevention.
The signals should be selected according to the purpose of the respective cookie. Google Tag Manager, Google Analytics 4 and Google Ads are configured separately outside the cookie management section.
Link the Cookie Settings in the Footer
Catalogues > Categories > Footer Navigation
- Create a new category with a name such as “Cookie Settings”
- Activate the category
- Select “Link” as the category type
- Select “External” as the link type
- Enter javascript:window.openCookieConsentManager() as the link target
- Save the category and assign it to the required sales channel
When the link is selected, the cookie settings are reopened and the stored selection can be changed.
Customize the Cookie Notice Texts
Settings > Shop > Text Snippets
The texts in the cookie notice can be customized and translated using the Shopware text snippets. Search for acrisCookieConsent.
- acrisCookieConsent.heading
Heading of the cookie notice. - acrisCookieConsent.messageIncludingSave
Information text of the cookie notice with a save option. - acrisCookieConsent.messageNoSave
Information text of the cookie notice without a save option. - acrisCookieConsent.settingsButton
Label of the button used to open the privacy settings. - acrisCookieConsent.acceptOnlyFunctionalButton
Label of the button used to accept functional cookies. - acrisCookieConsent.acceptButton
Label of the button used to accept selected cookies. - acrisCookieConsent.acceptAllButton
Label of the button used to accept all cookies.
Manually Link External Content to Consent
If external content cannot be included directly through the cookie’s script field, images, iFrames, scripts or stylesheets can be linked to a cookie ID using HTML attributes.
A cookie with the corresponding cookie ID must first be created in the cookie management section.
Embed an iFrame
Include an External Script
Display a Notice for Blocked Content
External content is loaded after consent has been given.Notes
- Test the cookie notice in all sales channels, languages and browsers used after completing the configuration
- Check whether non-functional scripts and external content are actually blocked before consent is given
- Cookies from external domains within an iFrame cannot always be automatically detected or blocked due to the browser’s Same-Origin Policy
- After adding new cookies, the “Request cookie consent again” option can be used to request a new decision from visitors
- The plugin supports the technical management of cookie consent but does not replace an individual legal review or data protection consultation
Information about implementing Google Tag Manager
https://www.acris.at/media/77/32/3c/1709126654/SW6_Doku_Cookie-Richtlinie-Pro_Tag-Manager_V61_EN.pdf
Container template for the import into the Google Tag Manager (please unpack ZIP archive)
https://www.acris.at/media/80/03/a3/1773766038/GTM_Container_Vorlage_bitte_entpacken_v9.zip