English Version

Zurück zur Übersicht

Klaro Cookie Consent: Fehlerbehebung

Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.

Consent-Banner wird nicht angezeigt

Symptom: Der Consent-Dialog erscheint nicht im Storefront.

Prüfen:

1. Ist das Plugin für den Sales Channel aktiviert? (Einstellungen > Erweiterungen > Klaro Cookie Consent Manager > Cookie Consent aktivieren)
2. Cache geleert? (bin/console cache:clear)

Lösung: Aktiviere das Plugin für den Sales Channel und leere den Cache. Zeigt der Dialog einzelne Services nicht an, siehe den nächsten Abschnitt.

Service erscheint nicht im Dialog

Symptom: Ein angelegter Service wird im Consent-Dialog nicht angezeigt.

Prüfen:

1. Ist der Service auf Aktiv gesetzt?
2. Ist im Service unter Sales Channels der betroffene Sales Channel ausgewählt? Ohne Auswahl wird der Service in keinem Sales Channel angezeigt.

Lösung: Wähle im Service die gewünschten Sales Channels aus und speichere.

Service-Texte in falscher Sprache

Symptom: Titel und Beschreibung eines Services erscheinen immer auf Deutsch, auch im englischen Storefront.

Prüfen:

1. In Erweiterungen > Cookie Consent Services den Language Switcher auf Englisch umstellen.
2. Prüfen, ob Titel und Beschreibung für Englisch gepflegt sind.

Lösung: Falls die Felder leer sind, trage die Texte in der englischen Sprachversion ein und speichere.

Kategorie-Texte nicht in weiteren Sprachen

Symptom: Die Kategorie-Überschriften erscheinen im Storefront in der Fallback-Sprache statt z.B. auf Französisch oder Spanisch.

Lösung:

1. Navigiere zu Einstellungen > Textbausteine.
2. Suche nach mmd-klaro.purposes.
3. Trage die Übersetzungen für die gewünschte Sprache ein.

Eigener Cookie-Einstellungen-Link öffnet den Dialog nicht

Symptom: Ein selbst angelegter Link mit #mmd-klaro-cookie-settings öffnet den Klaro-Dialog nicht, sondern navigiert einfach zur hinterlegten URL.

Prüfen:

1. Endet die Ziel-URL exakt (kleingeschrieben, ohne Tippfehler) auf #mmd-klaro-cookie-settings?
2. Ist Klaro für den jeweiligen Sales Channel aktiv?
3. Cache geleert? (bin/console cache:clear)

Lösung: Korrigiere die Ziel-URL oder aktiviere das Plugin für den Sales Channel.

Google Consent Mode reagiert nicht auf die Einwilligung

Symptom: Nach der Zustimmung bleiben Google-Schlüssel wie analytics_storage auf denied.

Prüfen:

1. Ist Google Consent Mode v2 aktivieren für den Sales Channel eingeschaltet?
2. Hat der Service die passende Kategorie? Die Zuordnung hängt an der Kategorie (Statistik, Marketing, Funktional), nicht am technischen Namen.
3. Hat der Nutzer seine Auswahl gespeichert? Nur eine gespeicherte Entscheidung löst das Update aus.

Lösung: Setze die Kategorie des Google-Services korrekt. Services der Kategorien Sicherheit und Sonstiges haben kein Consent-Mode-Gegenstück.

Bekannte Einschränkungen

• Shopware-Version: Das Plugin verlangt Shopware 6.7. Eine Installation unter Shopware 6.6 wird nicht unterstützt.
• Kontextueller Consent: Die Klaro-Option contextualConsentOnly wird an Klaro durchgereicht, das Admin-Formular eines Services bietet dafür aber kein Feld. Sie lässt sich nur über die API setzen.
• Kategorien: Es gibt genau fünf Kategorien: Funktional, Statistik, Marketing, Sicherheit und Sonstiges. Eigene Kategorien lassen sich nicht anlegen.