Consent Manager
Consent Manager ist ein optionales Modul, das einen nativen Cookie-Einwilligungsbanner mit Kategorien, Google Consent Mode v2-Signalisierung und ein Protokoll der von Besuchern getroffenen Entscheidungen hinzufügt. Andere Module können ihre Skripte und iframes so “sperren”, dass sie erst ausgeführt werden, sobald der Besucher die passende Kategorie erteilt.
Das Modul stellt Werkzeuge bereit, die Ihnen helfen, Einwilligungsentscheidungen zu erfassen und zu respektieren. Es garantiert von sich aus kein bestimmtes rechtliches Ergebnis und ersetzt keine Rechtsberatung.
Modul aktivieren
Section titled “Modul aktivieren”Das Modul ist standardmäßig deaktiviert. Aktivieren Sie es unter WooCommerce > Polski > Module (Abschnitt “Consent Manager”, Modulschlüssel consent_manager). Nach der Aktivierung wird der Banner im Storefront-Footer angezeigt und im Admin-Bereich steht eine Ansicht Einwilligungsdatensätze zur Verfügung. Diese Ansicht und der CSV-Export erfordern die Berechtigung manage_woocommerce.
Einwilligungskategorien
Section titled “Einwilligungskategorien”Der Banner verwendet einen festen Satz von Kategorien. Die Kategorie “Notwendig” ist immer erteilt und kann nicht abgeschaltet werden. Die anderen drei sind optional und der Besucher kann sie ein- oder ausschalten.
| Kategorie | Schlüssel | Standard | Beschreibung |
|---|---|---|---|
| Notwendig | necessary | immer an | Für den Betrieb des Shops erforderlich. Immer erteilt, kann nicht deaktiviert werden. |
| Analyse | analytics | an | Zugriffsmessung und Statistiken. |
| Marketing | marketing | an | Werbung und Remarketing. |
| Präferenzen | preferences | an | Personalisierung und Funktionen, die Entscheidungen speichern. |
Standardmäßig sind alle drei optionalen Kategorien im Banner aktiv. Sie können jede davon in den Moduleinstellungen deaktivieren, wenn Ihr Shop sie nicht verwendet.
Google Consent Mode v2
Section titled “Google Consent Mode v2”Wenn Google Consent Mode aktiviert ist (Standard), gibt das Modul den Standard-Einwilligungsstatus vor jeglichem gtag/GTM-Code aus (bei wp_head mit Priorität 0). Alle Signale starten als denied, mit Ausnahme von security_storage, und werden anschließend sofort aus dem gespeicherten Cookie aktualisiert, falls der Besucher bereits entschieden hat. Dies stellt sicher, dass gtag/GTM ab ihrem ersten Aufruf den korrekten Status sehen.
Die Banner-Kategorien werden wie folgt auf die Consent Mode-Signale abgebildet:
| Kategorie | Consent Mode v2-Signale |
|---|---|
| Analyse | analytics_storage |
| Marketing | ad_storage, ad_user_data, ad_personalization |
| Präferenzen | functionality_storage, personalization_storage |
Sobald der Besucher eine Entscheidung trifft, ruft der Banner gtag('consent', 'update', ...) mit dem aktuellen Status auf.
Einwilligungsgesteuerte Skripte und iframes
Section titled “Einwilligungsgesteuerte Skripte und iframes”Das Modul stellt einen Vertrag bereit, der es anderen Modulen ermöglicht, Skripte und iframes erst auszuführen, nachdem die passende Kategorie erteilt wurde. Gesperrter Code wird als <script type="text/plain" data-polski-consent="CATEGORY"> gerendert, sodass der Browser ihn beim Laden niemals ausführt. Der Frontend-Controller wandelt ihn in ein ausführbares Skript um, sobald die Kategorie erteilt ist (sofort, wenn das Cookie es bereits erlaubt, andernfalls beim polskiConsentChange-Ereignis).
Wenn sich die Entscheidung ändert, führt der Banner Folgendes aus:
- schreibt das Cookie
polski_consentmit der Liste der erteilten Kategorien, - ruft
gtag('consent', 'update', ...)auf, - löst das Fenster-Ereignis
polskiConsentChangeaus, auf das gesperrte Skripte reagieren, - sendet die Entscheidung per POST an den REST-Recorder.
Einwilligungsdatensätze
Section titled “Einwilligungsdatensätze”Jede aus dem Banner gespeicherte Entscheidung wird in das Einwilligungsprotokoll geschrieben. Es handelt sich um eine schreibgeschützte Admin-Ansicht, die verfügbar ist, während das Modul aktiviert ist, und zur Dokumentation der von Besuchern getroffenen Entscheidungen dient. Das Protokoll ersetzt keine Rechtsberatung.
| Spalte | Beschreibung |
|---|---|
| Datum | Datum und Uhrzeit der gespeicherten Entscheidung. |
| Kategorie | Die Kategorie, auf die sich die Entscheidung bezieht. |
| Entscheidung | ”Erteilt” oder “Verweigert”. |
| Benutzer | Die Benutzer-ID oder “Gast” für abgemeldete Besucher. |
| IP-Adresse | Die IP-Adresse des Besuchers (sofern verfügbar). |
| Textversion | Ein Hash des Bannertexts, den der Besucher tatsächlich sah. |
Jede gespeicherte Entscheidung ist mit der Textversion des Banners verknüpft (einem Hash aus Überschrift, Text und Kategorienliste), sodass Sie genau erkennen können, welchen Wortlaut der Besucher akzeptiert hat.
CSV-Export
Section titled “CSV-Export”Die Schaltfläche CSV exportieren lädt das vollständige Protokoll als CSV-Datei herunter. Der Export enthält die Spalten: id, created_at, category, granted, user_id, ip_address, user_agent, consent_version. Der Export erfordert die Berechtigung manage_woocommerce und ist durch einen Nonce geschützt.
Einstellungen
Section titled “Einstellungen”Die Einstellungen befinden sich auf der Modulkarte unter WooCommerce > Polski > Module.
| Einstellung | Standard | Beschreibung |
|---|---|---|
| Kategorie: Analyse | an | Ob die Analyse-Kategorie im Banner angezeigt wird. |
| Kategorie: Marketing | an | Ob die Marketing-Kategorie im Banner angezeigt wird. |
| Kategorie: Präferenzen | an | Ob die Präferenzen-Kategorie im Banner angezeigt wird. |
| Überschrift | (leer) | Optionale Banner-Überschrift. |
| Bannertext | Standardtext | Der Haupttext des Banners (erlaubt einfaches HTML). |
| Beschriftung “Alle akzeptieren" | "Accept all” | Text der Schaltfläche zum Akzeptieren aller Kategorien. |
| Beschriftung “Alle ablehnen" | "Reject all” | Text der Schaltfläche zum Ablehnen der optionalen Kategorien. |
| Beschriftung “Verwalten" | "Manage” | Text der Schaltfläche, die die Kategorieauswahl öffnet. |
| Beschriftung “Auswahl speichern" | "Save choices” | Text der Schaltfläche, die die ausgewählten Kategorien speichert. |
| Position | unten | Platzierung des Banners: oben, unten oder mittig. |
| Google Consent Mode | an | Ob Google Consent Mode v2-Signale ausgegeben werden. |
Fehlerbehebung
Section titled “Fehlerbehebung”Der Banner erscheint nicht - stellen Sie sicher, dass das Modul unter WooCommerce > Polski > Module aktiviert ist und dass das Theme wp_footer() aufruft. Der Banner wird im Footer gerendert.
Google-Tags reagieren nicht auf die Einwilligung - prüfen Sie, ob Google Consent Mode aktiviert ist und ob Ihr gtag/GTM-Code nach den Consent Mode-Signalen geladen wird (sie werden sehr früh in wp_head ausgegeben).
Ein gesperrtes Skript läuft nicht - das Skript startet erst, nachdem die passende Kategorie erteilt wurde. Überprüfen Sie, ob der Besucher die Kategorie erteilt hat und ob das Skript über den Sperrvertrag ausgegeben wurde.
Probleme melden: github.com/wppoland/polski/issues