English Version

Zurück zur Übersicht

Klaro Cookie Consent: Konfiguration

Live Demo: Teste dieses und weitere Plugins live — ohne Installation, ohne Risiko: demo.markus-michalski.net

Die Konfiguration besteht aus zwei Teilen: den Modul-Einstellungen und den Cookie-Services.

Modul-Einstellungen

Du findest sie im Admin unter Erweiterungen > Module > Klaro Cookie Consent Manager > Einstellungen. Die Einstellungen gelten je Shop.

Allgemeine Einstellungen

Consent-Verhalten

Speicher-Einstellungen

Google Consent Mode v2

Darstellung

Im Admin gibt es außerdem die Felder "Farbe Alle akzeptieren" (#1a73e8), "Farbe Auswahl speichern" (#2581c4) und "Farbe Alle ablehnen" (#5c5c5c). Sie haben im Storefront derzeit keine Wirkung, weil das mitgelieferte Stylesheet die dafür gesetzten CSS-Variablen nicht verwendet. Du kannst sie ignorieren.

Cookie-Services verwalten

Die Services pflegst du unter Kundeninformationen > Cookie Consent. Die Liste zeigt die Services des aktuellen Shops mit den Spalten Aktiv, Technischer Name, Titel, Zweck, Erforderlich und Reihenfolge. Mit "Neuen Service hinzufügen" legst du einen neuen an.

Die Spalte "Titel" der Liste zeigt den technischen Namen, nicht den gespeicherten Titel. Den Titel siehst du in der Bearbeitungsansicht.

Jeder Service steht für einen Dienst oder ein Skript, das eine Einwilligung braucht. Beim Anlegen eines Services entsteht kein Skript im Shop. Welche Skripte der Service steuert, legst du im Template fest, siehe Storefront.

Felder eines Services

Titel und Beschreibung pflegst du pro Sprache: Wähle im Admin die Sprache aus und speichere den Service einmal je Sprache. Das Storefront kennt Texte für Deutsch (Sprach-ID 0) und Englisch (Sprach-ID 1). Fehlt der Titel in einer Sprache, nimmt das Modul den deutschen Titel, danach den technischen Namen.

Speichern mit leerem technischen Namen tut nichts: Es erscheint keine Fehlermeldung, und es wird nichts gespeichert.

Cookie-Löschregeln

Widerruft ein Besucher die Einwilligung, löscht Klaro die hinterlegten Cookies. Du kannst sie in einer der zwei Schreibweisen eintragen.

Eine Zeile pro Cookie im Format Name,Pfad,Domain, Pfad und Domain sind optional:

_ga
_gid
_pk_id,/,.example.com

Als JSON-Liste:

[
    {"pattern": "_ga", "path": "/", "domain": ".example.com"},
    {"pattern": "_gid"}
]

So wird pattern ausgewertet:

• Ein Wert, der nicht mit ^ beginnt, gilt als exakter Cookie-Name.
• Ein Wert, der mit ^ beginnt, gilt als regulärer Ausdruck, zum Beispiel ^_ga_.*$.
• Platzhalter wie _ga_* funktionieren nicht, sie werden als Teil des Namens gelesen.

Ein Eintrag, der mit [ beginnt, aber kein gültiges JSON ist, wird zeilenweise als Cookie-Liste gelesen. Prüfe das JSON also, bevor du speicherst.

Praxis-Beispiele

Google Analytics 4

[
    {"pattern": "_ga", "path": "/", "domain": ".dein-shop.de"},
    {"pattern": "^_ga_.*$", "path": "/", "domain": ".dein-shop.de"},
    {"pattern": "_gid", "path": "/", "domain": ".dein-shop.de"}
]

Das Google-Skript selbst markierst du im Template mit data-name="google-analytics".

YouTube-Einbettung mit Platzhalter

Das iframe markierst du mit data-name="youtube" und data-src, siehe Storefront.