Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.
Navigiere zu Einstellungen > Erweiterungen > Klaro Cookie Consent Manager. Alle Einstellungen lassen sich pro Sales Channel überschreiben, du kannst also für verschiedene Shops unterschiedlich konfigurieren.
| Einstellung | Standard | Beschreibung |
|---|---|---|
| Cookie Consent aktivieren | true |
Aktiviert den Klaro-Banner im Storefront des Sales Channels |
| Datenschutzerklärung URL | /privacy |
Link zur Datenschutzerklärung, z.B. /datenschutz. Der Wert muss mit / oder https:// beginnen, sonst gilt /privacy |
| Cookie-Einstellungen-Link automatisch im Footer-Servicemenü anzeigen | true |
Blendet den automatisch eingefügten Footer-Link aus, wenn deaktiviert. Sinnvoll bei einem eigenen, frei platzierten Link (siehe Storefront) |
| Einstellung | Standard | Beschreibung |
|---|---|---|
| Consent erforderlich (Modal blockiert Seite) | true |
Nutzer muss mit dem Dialog interagieren, bevor die Seite nutzbar ist. Empfohlen für DSGVO-Konformität |
| "Alle akzeptieren" Button anzeigen | true |
Zeigt einen Button, um alle Services auf einmal zu akzeptieren |
| "Alle ablehnen" Button verstecken | false |
Versteckt den "Alle ablehnen"-Button. Nutzer können einzelne Services trotzdem ablehnen |
| Services nach Zweck gruppieren | true |
Gruppiert Services nach Kategorie (Statistik, Marketing usw.) im Dialog |
| "Mehr erfahren" Links verstecken | false |
Versteckt die "Mehr erfahren"-Links |
| Einstellung | Standard | Beschreibung |
|---|---|---|
| Speichermethode | cookie |
Cookie (empfohlen) oder Local Storage |
| Storage-Name | klaro |
Name des Cookies oder des localStorage-Schlüssels |
| Cookie läuft ab nach (Tage) | 365 |
Anzahl Tage, bis das Consent-Cookie abläuft |
| Einstellung | Standard | Beschreibung |
|---|---|---|
| Google Consent Mode v2 aktivieren | false |
Synchronisiert den Consent mit Google-Diensten (GA4, Google Ads) |
| Auf Consent-Update warten (nur bei aktiviertem Google Consent Mode v2) | true |
Verzögert Google-Tags, bis der Consent ermittelt ist (500 Millisekunden). Wirkt nur bei aktiviertem Google Consent Mode v2 |
| Einstellung | Standard | Beschreibung |
|---|---|---|
| Farbe "Alle akzeptieren" | #1a73e8 |
Farbe für den "Alle akzeptieren"-Button und aktive Schalter. Erlaubt sind Hex-Werte (#rgb oder #rrggbb), sonst gilt der Standardwert |
| Farbe "Auswahl speichern" | #2581c4 |
Farbe für den "Auswahl speichern"-Button |
| Farbe "Alle ablehnen" | #5c5c5c |
Farbe für den "Alle ablehnen"-Button |
| Banner-Position (nur wenn "Consent erforderlich" deaktiviert) | bottom |
Unten (volle Breite), Oben (volle Breite), Unten Links oder Unten Rechts |
| Farbschema | light |
Hell oder Dunkel |
Die Banner-Position gilt nur, wenn "Consent erforderlich" deaktiviert ist. Bei aktiviertem "Consent erforderlich" wird stattdessen ein zentriertes Modal angezeigt.
Die Einstellungen liegen in der Systemkonfiguration unter dem Präfix MmdKlaroCookieConsent.config. und werden pro Sales Channel gelesen:
| Schlüssel | Einstellung |
|---|---|
MmdKlaroCookieConsent.config.active |
Cookie Consent aktivieren |
MmdKlaroCookieConsent.config.privacyPolicyUrl |
Datenschutzerklärung URL |
MmdKlaroCookieConsent.config.showFooterLink |
Cookie-Einstellungen-Link im Footer-Servicemenü |
MmdKlaroCookieConsent.config.mustConsent |
Consent erforderlich |
MmdKlaroCookieConsent.config.acceptAll |
"Alle akzeptieren" Button anzeigen |
MmdKlaroCookieConsent.config.hideDeclineAll |
"Alle ablehnen" Button verstecken |
MmdKlaroCookieConsent.config.groupByPurpose |
Services nach Zweck gruppieren |
MmdKlaroCookieConsent.config.hideLearnMore |
"Mehr erfahren" Links verstecken |
MmdKlaroCookieConsent.config.storageMethod |
Speichermethode |
MmdKlaroCookieConsent.config.storageName |
Storage-Name (erlaubt: Buchstaben, Zahlen, _ und -, sonst gilt klaro) |
MmdKlaroCookieConsent.config.cookieExpiresAfterDays |
Cookie läuft ab nach (Tage) |
MmdKlaroCookieConsent.config.googleConsentMode |
Google Consent Mode v2 aktivieren |
MmdKlaroCookieConsent.config.googleConsentModeWaitForUpdate |
Auf Consent-Update warten |
MmdKlaroCookieConsent.config.primaryColor |
Farbe "Alle akzeptieren" |
MmdKlaroCookieConsent.config.secondaryColor |
Farbe "Auswahl speichern" |
MmdKlaroCookieConsent.config.declineColor |
Farbe "Alle ablehnen" |
MmdKlaroCookieConsent.config.position |
Banner-Position |
MmdKlaroCookieConsent.config.theme |
Farbschema |
Die Texte der Consent-Kategorien und des Dialogs werden über Shopware-Textbausteine (Snippets) verwaltet. Das ermöglicht beliebig viele Sprachen, nicht nur Deutsch und Englisch. Die Snippet-Keys findest du unter Einstellungen > Textbausteine mit dem Präfix mmd-klaro.
| Snippet-Key | Standard (DE) | Standard (EN) |
|---|---|---|
mmd-klaro.purposes.analytics.title |
Statistik | Analytics |
mmd-klaro.purposes.analytics.description |
Diese Dienste sammeln anonyme Daten über die Nutzung unserer Website | These services collect anonymous data about website usage |
mmd-klaro.purposes.marketing.title |
Marketing | Marketing |
mmd-klaro.purposes.marketing.description |
Diese Dienste ermöglichen die Messung und Optimierung von Werbekampagnen auf externen Plattformen | These services enable measurement and optimization of advertising campaigns on external platforms |
mmd-klaro.purposes.functional.title |
Funktional | Functional |
mmd-klaro.purposes.functional.description |
Diese Dienste bieten zusätzliche Funktionen | These services provide additional functionality |
mmd-klaro.purposes.security.title |
Sicherheit | Security |
mmd-klaro.purposes.security.description |
Diese Dienste schützen die Website | These services help protect the website |
mmd-klaro.purposes.other.title |
Sonstiges | Other |
mmd-klaro.purposes.other.description |
Diese Dienste lassen sich keiner anderen Kategorie zuordnen | These services do not fit any other category |
Tipp: Um z.B. Französisch hinzuzufügen, lege ein neues Snippet-Set für
fr-FRan und übersetze die Texte. Klaro zeigt im Storefront automatisch die Sprache des Shops.
| Snippet-Key | Beschreibung |
|---|---|
mmd-klaro.consentModal.title |
Titel des Consent-Modals |
mmd-klaro.consentModal.description |
Beschreibungstext im Modal |
mmd-klaro.consentNotice.description |
Text des Hinweis-Banners (wenn "Consent erforderlich" deaktiviert ist) |
mmd-klaro.consentNotice.learnMore |
Text des "Mehr erfahren"-Links im Hinweis-Banner |
mmd-klaro.ok |
Text des "Alle akzeptieren"-Buttons |
mmd-klaro.acceptAll |
Text für "Alle akzeptieren" |
mmd-klaro.decline |
Text des "Alle ablehnen"-Buttons |
mmd-klaro.declineAll |
Text für "Alle ablehnen" |
mmd-klaro.save |
Text des "Speichern"-Buttons |
mmd-klaro.acceptSelected |
Text des "Auswahl speichern"-Buttons |
mmd-klaro.cookieSettings |
Beschriftung des Footer-Links "Cookie-Einstellungen" |
Das Plugin hat ein eigenes Admin-Modul mit nativer Shopware-Bedienung. Die Service-Verwaltung findest du unter Erweiterungen > Cookie Consent Services.
Die Liste zeigt alle konfigurierten Services mit technischem Namen, Titel, Kategorie sowie den Status "Erforderlich" und "Aktiv" als Icons. Sortierung und Paginierung sind verfügbar, der Language Switcher oben rechts zeigt die Titel in der gewählten Sprache.
Klicke auf "Service erstellen" oder auf einen bestehenden Service. Im Header der Detailseite wechselst du mit dem Language Switcher die Sprache, um Titel und Beschreibung pro Sprache zu pflegen. Das funktioniert wie bei Shopware-Produkten oder Kategorien.
Wichtig: Der technische Name kann nach dem Erstellen nicht mehr geändert werden. Er dient als eindeutiger Bezeichner in der Klaro-Konfiguration.
| Feld | Beschreibung | Pflicht |
|---|---|---|
| Technischer Name | Eindeutiger Bezeichner, z.B. google-analytics (Kleinbuchstaben, Zahlen, Bindestriche) |
Ja |
| Kategorie | Funktional / Technisch notwendig, Statistik / Analytics, Marketing, Sicherheit oder Sonstiges | Ja |
| Anzeige-Titel | Name im Consent-Dialog, pro Sprache pflegbar. Beim Speichern wird ein Titel in der Standardsprache verlangt | Ja |
| Beschreibung | Erklärung für den Nutzer, pro Sprache pflegbar | Nein |
| Position | Sortierreihenfolge im Consent-Dialog (0 = oben) | Nein |
| Aktiv | Service im Consent-Dialog anzeigen | Nein |
| Erforderlich | Service kann vom Nutzer nicht abgelehnt werden, z.B. für Session-Cookies | Nein |
| Standardmäßig aktiviert | Im Consent-Dialog vorausgewählt | Nein |
| Callback nur einmal ausführen | Verhindert doppelte Tracking-Events | Nein |
| Sales Channels | Sales Channels, in denen der Service angezeigt wird | Nein |
Die Option "Standardmäßig aktiviert" ist nicht DSGVO-konform, weil sie die Einwilligung vorwegnimmt. Nutze sie nur mit Bedacht.
Ist kein Sales Channel ausgewählt, wird der Service in keinem Sales Channel angezeigt.
Für jeden Service kannst du Cookies definieren, die bei Widerruf der Einwilligung automatisch gelöscht werden:
| Feld | Beschreibung | Pflicht |
|---|---|---|
| Cookie-Name/Muster | Cookie-Name oder Muster, z.B. _ga oder ^_gid.*$ |
Nein |
| Pfad | Cookie-Pfad (Standard: /) |
Nein |
| Domain | Cookie-Domain, z.B. .example.com |
Nein |
Jede Regel braucht ein Muster. Entferne Zeilen, die du nicht ausfüllst.
Seit März 2024 verlangt Google den Consent Mode v2 für Websites, die Google Analytics oder Google Ads im Europäischen Wirtschaftsraum nutzen. Aktiviere ihn unter Einstellungen > Erweiterungen > Klaro Cookie Consent Manager mit der Einstellung Google Consent Mode v2 aktivieren.
Bei aktiviertem Google Consent Mode passiert Folgendes:
ad_storage, ad_user_data, ad_personalization, analytics_storage, functionality_storage und personalization_storage auf denied gesetzt, security_storage auf granted. Ist "Auf Consent-Update warten" aktiv, kommt wait_for_update mit 500 Millisekunden dazu.ads_data_redaction wird beim Laden auf true gesetzt und auf false gestellt, sobald für Marketing eingewilligt ist.| Kategorie des Services | Aktualisierte Google-Schlüssel |
|---|---|
| Statistik / Analytics | analytics_storage |
| Marketing | ad_storage, ad_user_data, ad_personalization |
| Funktional | functionality_storage, personalization_storage |
| Sicherheit, Sonstiges | keine (kein Consent-Mode-Gegenstück) |
Die Zuordnung hängt an der Kategorie, nicht am technischen Namen eines Services. Eine Kategorie, für die in einem Sales Channel kein Service konfiguriert ist, wird nicht angefasst und überschreibt damit keine Signale anderer Skripte oder des Google Tag Managers.
| Feld | Wert |
|---|---|
| Technischer Name | google-analytics |
| Kategorie | Statistik / Analytics |
| Titel (DE) | Google Analytics |
| Titel (EN) | Google Analytics |
| Beschreibung (DE) | Sammelt anonyme Statistiken über die Nutzung der Website |
| Beschreibung (EN) | Collects anonymous statistics about website usage |
| Cookies | _ga (Pfad: /, Domain: .example.com), _gid (Pfad: /, Domain: .example.com) |
Binde dein GA4-Script mit dem Attribut data-name ein, damit Klaro es kontrollieren kann:
<script data-type="application/javascript"
data-name="google-analytics"
data-src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXX"
type="text/plain"></script>
| Feld | Wert |
|---|---|
| Technischer Name | youtube |
| Kategorie | Funktional |
| Titel | YouTube |
| Beschreibung | Ermöglicht das Abspielen eingebetteter YouTube-Videos |
Das Klaro-Flag für kontextuellen Consent ist im Admin-Formular nicht einstellbar, siehe Fehlerbehebung.
| Feld | Wert |
|---|---|
| Technischer Name | facebook-pixel |
| Kategorie | Marketing |
| Titel | Facebook Pixel |
| Beschreibung | Ermöglicht die Messung von Werbekampagnen auf Facebook und Meta |
| Cookies | _fbp (Pfad: /), _fbc (Pfad: /) |
Dieser Service wird bei der Installation automatisch angelegt:
| Feld | Wert |
|---|---|
| Technischer Name | session |
| Kategorie | Funktional |
| Titel (DE) | Technisch notwendig |
| Titel (EN) | Technically necessary |
| Beschreibung (DE) | Diese Cookies sind für die Grundfunktionen des Shops erforderlich. Sie speichern z.B. den Warenkorb und ermöglichen den Checkout-Prozess. |
| Beschreibung (EN) | These cookies are essential for the basic functions of the shop. They store your shopping cart and enable the checkout process. |
| Erforderlich | Ja |
| Standardmäßig aktiviert | Ja |
| Cookies | session- (Pfad: /), sw- (Pfad: /) |