English Version

Zurück zur Übersicht

Klaro Cookie Consent: Fehlerbehebung

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

Bekannte Einschränkungen

Kein API-Platform-Endpunkt: Die Consent-Logik (KlaroConfigBuilder) ist aktuell ausschließlich für das Twig-Storefront verdrahtet. Ein headless Frontend (React, Vue, ...) müsste eine eigene Consent-Oberfläche bauen, denn die fertige Konfiguration ist über die Shop API nicht erreichbar.

Nur MySQL/MariaDB getestet: Die Migrationen sind mit der Doctrine Schema API geschrieben und tragen keinen Plattform-Guard, andere Datenbanken wurden aber nicht verifiziert.

Fehlerbehebung

Banner erscheint auf einem Channel nicht

Symptom: Kein Cookie-Banner, kein Footer-Link auf der Storefront eines Channels.

Prüfen:

• Existiert für diesen Channel überhaupt eine Zeile unter MMKreativ Plugins > Klaro settings?
• Ist enabled auf dieser Zeile aktiviert?
• Wurde bin/console mmd:klaro-consent:setup nach der Installation ausgeführt (Tabellen vorhanden)?

Lösung: Channel-Konfiguration anlegen oder aktivieren, danach Cache leeren. Fehlen die Tabellen, den Setup-Command ausführen; bis dahin rendert die Storefront kommentarlos nichts.

Setup-Command bricht ab

Symptom: bin/console mmd:klaro-consent:setup meldet, dass vorausgesetzte Migrationen noch offen sind.

Prüfen: bin/console doctrine:migrations:status auf offene Sylius-Core-Migrationen.

Lösung: Zuerst bin/console doctrine:migrations:migrate für die offenen Host-/Core-Migrationen ausführen, danach den Setup-Command erneut aufrufen.

Admin-Menüpunkt "Klaro settings" fehlt

Symptom: Unter "MMKreativ Plugins" erscheint kein Eintrag für Klaro.

Prüfen: Ist das Bundle in config/bundles.php registriert? Sind die Admin-Routen importiert (siehe Installation)?

Lösung: Beide Schritte nachholen, danach bin/console cache:clear.

Google Consent Mode reagiert nicht wie erwartet

Symptom: Ein Google-Tag feuert trotz aktivem Consent Mode scheinbar unverändert.

Prüfen: Ist googleConsentMode für diesen Channel aktiviert? Hat der betroffene Dienst einen purpose, der tatsächlich gemappt wird (analytics, marketing, functional)? security und other bleiben bewusst unmapped. Ist googleConsentModeWaitForUpdate aktiv, falls das Tag sehr früh feuert?

Lösung: Zweck des Dienstes korrigieren oder googleConsentModeWaitForUpdate aktivieren, damit Google-Tags die 500-ms-Verzögerung auf die erste Consent-Entscheidung abwarten.

FAQ

Allgemein

Was passiert bei einem Channel ohne Einstellungs-Zeile?
Er verhält sich, als wäre das Plugin nicht installiert: nichts wird geladen, nichts gerendert.

Wie öffne ich den Dialog von einer eigenen Stelle aus erneut?
Mit einem Link, dessen href auf #mmd-klaro-cookie-settings endet.

Konfiguration

Wie lösche ich Cookies beim Widerruf?
Im cookies-Feld des Dienstes, eine Regel pro Zeile, optional als muster:pfad:domain.

Kann ein Dienst nur für bestimmte Channels gelten?
Ja, über die Channel-Zuordnung am Dienst; leer gelassen gilt er für alle Channels.

Kompatibilität

Funktioniert das Plugin headless, über die Shop API?
Aktuell nicht, siehe "Bekannte Einschränkungen" oben.

Welche Datenbanken werden unterstützt?
Nur MySQL 8 und MariaDB sind getestet.