Klaro Cookie Consent: Konfiguration
Konfiguration von Klaro Cookie Consent für Sylius 2 - Channel-Einstellungen, Service-Katalog, Admin-Grids und Praxis-Beispiele für Google Consent Mode v2.
Klaro Cookie Consent: Konfiguration
Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.
Alle Einstellungen findest du im Admin unter MMKreativ Plugins > Klaro settings.
Jede Einstellung gilt pro Channel, nicht global. Ein Channel ohne eigene Zeile zeigt keinen Banner.
Channel-Konfiguration
| Einstellung | Standard | Beschreibung |
|---|---|---|
enabled |
false |
Schaltet den Banner für diesen Channel ein oder aus |
privacyPolicyPath |
leer | Routenname, Pfad oder vollständige URL zur Datenschutzerklärung; {_locale} wird durch den aktuellen Locale-Code ersetzt |
noticeExemptPages |
leer | Seiten (eine pro Zeile, gleiche Formen wie bei der Datenschutzerklärung), auf denen kein blockierender Dialog erscheint, maximal 20 Zeilen |
showFooterLink |
true |
Zeigt den "Cookie-Einstellungen"-Link im Footer |
mustConsent |
true |
Besucher muss aktiv entscheiden, bevor Dienste laden |
acceptAll |
true |
Zeigt den "Alle akzeptieren"-Button |
hideDeclineAll |
false |
Blendet den "Alle ablehnen"-Button aus |
hideLearnMore |
false |
Blendet den "Mehr erfahren"-Link aus |
groupByPurpose |
true |
Gruppiert die Dienste im Dialog nach Zweck |
storageMethod |
cookie |
Speicherort der Entscheidung: cookie oder localStorage |
storageName |
klaro |
Name des Cookies/Storage-Keys, nur Buchstaben, Ziffern, _ und - |
cookieExpiresAfterDays |
365 |
Gültigkeit der gespeicherten Entscheidung in Tagen, 1 bis 3650 |
googleConsentMode |
false |
Aktiviert die Google-Consent-Mode-v2-Brücke |
googleConsentModeWaitForUpdate |
true |
Verzögert Google-Tags um 500 ms, bis die erste Consent-Entscheidung vorliegt |
primaryColor |
#1a73e8 |
Akzentfarbe (Hex) |
secondaryColor |
#2581c4 |
Zweite Akzentfarbe (Hex) |
declineColor |
#5c5c5c |
Farbe des "Ablehnen"-Buttons (Hex) |
bannerPosition |
bottom |
bottom, top, bottom-left oder bottom-right |
theme |
light |
light oder dark |
Service-Katalog
Über den Button Consent services auf derselben Seite erreichst du den Katalog der Drittanbieter-Dienste. Pro Dienst:
| Feld | Standard | Beschreibung |
|---|---|---|
code |
- | Eindeutiger Code, nur Kleinbuchstaben, Ziffern, _ und -; der Code technically-necessary ist reserviert und kann nicht vergeben werden |
purpose |
functional |
functional, analytics, marketing, security oder other |
required |
false |
Dienst kann nicht abgewählt werden |
defaultEnabled |
false |
Dienst ist vor der Entscheidung bereits vorausgewählt |
enabled |
true |
Dienst erscheint überhaupt im Dialog |
cookies |
leer | Zu löschende Cookies beim Widerruf, siehe unten |
onlyOnce |
true |
Zustimmung wird nur einmal abgefragt, nicht bei jedem Laden erneut |
contextualConsentOnly |
false |
Dienst erscheint nicht im Haupt-Dialog, nur kontextuell (z. B. vor einem eingebetteten Video) |
position |
0 |
Sortierreihenfolge im Dialog und im Admin-Grid |
channels |
alle | Auf welche Channels der Dienst sich bezieht; leer gelassen gilt er für alle |
| Titel/Beschreibung | - | Pro Sprache übersetzbar |
Der Eintrag Technisch notwendig (Warenkorb, Checkout, Login, Sicherheit, die gespeicherte Entscheidung selbst) steht fest im Code, erscheint ohne eigene Katalog-Zeile in jedem aktivierten Channel, kann nicht abgewählt werden und beeinflusst Google Consent Mode nicht.
Das Cookies-Feld
Im Admin-Formular ist cookies ein Textfeld, eine Regel pro Zeile:
_ga
_gid:/:.example.com
Ein einfaches Muster löscht jeden passenden Cookie auf dem aktuellen Pfad/der aktuellen Domain. Mit muster:pfad:domain (Pfad und Domain optional, durch : getrennt) schränkst du die Löschung ein.
Admin-Grids
| Grid | Zweck | Spalten |
|---|---|---|
| Consent services | CRUD-Liste der Drittanbieter-Dienste, sortiert nach position |
Position, Code, Zweck, Titel, Pflicht, Aktiv |
| Channel-Konfigurationen | CRUD-Liste der Channel-Einstellungen | Channel, Aktiv, Pflicht-Zustimmung, Google Consent Mode |
Praxis-Beispiele
Google Analytics 4 mit Google Consent Mode v2: Service ga4, Zweck analytics, Cookies _ga und _gid je eine Zeile, required aus, defaultEnabled aus. Auf der Channel-Konfiguration googleConsentMode und googleConsentModeWaitForUpdate aktivieren, damit gtag('consent', 'update', ...) erst nach der Entscheidung mit analytics_storage reagiert.
Marketing-Pixel (z. B. Meta Pixel): Service meta-pixel, Zweck marketing, Cookie-Regel _fbp, required aus, defaultEnabled aus, onlyOnce an, damit Besucher nicht bei jedem Seitenaufruf erneut gefragt werden.
Eingebettetes YouTube-Video nur kontextuell: Service youtube-embed, Zweck functional, contextualConsentOnly an, damit der Dienst nicht im Haupt-Dialog auftaucht, sondern nur direkt vor dem eingebetteten Player zur Zustimmung führt.