WPConsent Dokumentation

Dokumentation, Referenzmaterialien und Tutorials für WPConsent

Häufig gestellte Fragen

Haben Sie eine Frage zu WPConsent? Diese Seite behandelt die häufigsten Fragen und Probleme, auf die Benutzer bei der Verwendung des Plugins stoßen. Durchsuchen Sie die folgenden Abschnitte, um schnelle, praktische Antworten zu finden.

Inhaltsverzeichnis

Warum wird mein Banner nicht auf meiner Website angezeigt?

Es gibt mehrere Gründe, warum das Zustimmungsbanner nicht angezeigt wird. Gehen Sie diese Prüfungen der Reihe nach durch:

  1. Banner ist deaktiviert. Navigieren Sie zu WPConsent >> Banner-Design und bestätigen Sie, dass die Option Banner im Frontend anzeigen aktiviert ist. Klicken Sie dann auf Speichern, um alle Änderungen zu übernehmen.
  2. Zustimmung wurde bereits gespeichert. Wenn Sie bereits mit dem Banner interagiert haben, werden Ihre Einstellungen in einem Cookie namens wpconsent_preferences gespeichert. Das Banner wird erst wieder angezeigt, wenn dieser Cookie abläuft oder gelöscht wird. Um ihn zu löschen, öffnen Sie die Entwicklertools Ihres Browsers, gehen Sie zu Anwendung >> Cookies, löschen Sie den Cookie wpconsent_preferences und laden Sie die Seite neu. Sie können auch in einem privaten oder Inkognito-Fenster testen.
  3. Eine gecachte Seite wird ausgeliefert. Wenn Sie ein Caching-Plugin (WP Rocket, W3 Total Cache, LiteSpeed Cache usw.) oder ein CDN verwenden, enthält die gecachte Version Ihrer Seite möglicherweise nicht das Banner. Leeren Sie alle Caches und laden Sie die Seite neu. Weitere Details finden Sie im Abschnitt zur Caching-Kompatibilität unten.
  4. Seiten-Builder-Editor-Modus. WPConsent blendet das Banner automatisch aus und deaktiviert die Skriptblockierung in den Editoren von Bricks Builder und Divi Builder. Dies ist beabsichtigt. Um das Banner anzuzeigen, rufen Sie eine Vorschau der Seite auf oder betrachten Sie sie im Frontend.
  5. Customizer-Vorschau. Das Banner wird in der WordPress Customizer-Vorschau nicht geladen, um die Anpassungserfahrung nicht zu beeinträchtigen.
  6. REST API oder AJAX-Anfrage. Das Banner wird nur bei Standard-Frontend-Seitenanfragen geladen. Es wird nicht für REST API-Endpunkte, AJAX-Anfragen oder RSS-Feeds geladen.
  7. Theme- oder Plugin-Konflikt. In seltenen Fällen kann ein Theme oder Plugin die Ausgabe von WPConsent beeinträchtigen. Versuchen Sie, vorübergehend zu einem Standard-WordPress-Theme (wie Twenty Twenty-Four) zu wechseln, um zu sehen, ob das Banner angezeigt wird.

Warum wird mein Banner nicht gestylt oder flackert vor dem Laden?

WPConsent verwendet Shadow DOM, um seine Stile von Ihrem Theme zu isolieren. Die CSS wird asynchron über JavaScript geladen, nachdem das Shadow DOM erstellt wurde. Der Banner-Container ist auf display: none gesetzt, bis die CSS vollständig geladen ist, was ein ungestyltes Aufblitzen verhindert. Bei sehr langsamen Verbindungen kann es zu einer kurzen Verzögerung kommen, bevor das Banner erscheint, aber es werden keine ungestylten Inhalte angezeigt.

Wenn Sie ungestylten Inhalt sehen, überprüfen Sie, ob Ihr Server keine Anfragen an das WPConsent build/ Verzeichnis blockiert. Stellen Sie außerdem sicher, dass kein Sicherheit-Plugin Inline-Skripte oder Fetch-Anfragen blockiert.

Warum wird mein Banner nach der Zustimmung bei jedem Seitenaufruf angezeigt?

Dies geschieht, wenn der wpconsent_preferences Cookie nicht gespeichert werden kann oder zwischen Seitenaufrufen gelöscht wird. Häufige Ursachen sind:

  • Cookie-Zustimmungsdauer ist auf 0 gesetzt. Navigieren Sie zu WPConsent >> Einstellungen und bestätigen Sie, dass die Zustimmungsdauer auf einen Wert größer als 0 gesetzt ist (Standard ist 30 Tage).
  • Cookie-Domain-Inkompatibilität. Wenn Sie die Funktion Geteilte Zustimmung verwenden (unter WPConsent >> Einstellungen >> Erweitert), stellen Sie sicher, dass die Cookie-Domain für Ihre Subdomain-Einrichtung korrekt konfiguriert ist.
  • Ein Plugin oder eine Serverregel löscht Cookies. Überprüfen Sie, ob ein Sicherheits- oder Performance-Plugin so konfiguriert ist, dass Cookies entfernt werden.

Blockierungs-Probleme

Warum werden meine Skripte nicht blockiert?

Wenn Tracking-Skripte immer noch vor der Zustimmung ausgeführt werden, überprüfen Sie Folgendes:

  1. Skriptblockierung ist deaktiviert. Navigieren Sie zu WPConsent >> Einstellungen und bestätigen Sie, dass der Schalter Skriptblockierung aktiviert ist. Die Skriptblockierung erfordert, dass auch das Zustimmungsbanner aktiviert ist. Wenn das Banner deaktiviert ist, wird die Skriptblockierung automatisch deaktiviert.
  2. Google Consent Mode ist aktiviert. Wenn Google Consent Mode aktiviert ist, werden Skripte von Google Analytics, Google Tag Manager und Google Ads nicht blockiert. Stattdessen werden sie in einem eingeschränkten, cookielosen Modus ausgeführt, bis die Zustimmung erteilt wird. Dies ist das korrekte Verhalten. Wenn Sie eine vollständige Blockierung bevorzugen, deaktivieren Sie Google Consent Mode unter WPConsent >> Einstellungen auf der Registerkarte Einstellungen.
  3. Clarity Consent Mode ist aktiviert. Ähnlich wie bei Google Consent Mode werden bei aktiviertem Clarity Consent Mode Microsoft Clarity-Skripte nicht blockiert, sondern über Zustimmungssignale gesteuert. Deaktivieren Sie Clarity Consent Mode, wenn Sie eine vollständige Blockierung bevorzugen.
  4. Das Skript befindet sich nicht in der Liste bekannter Skripte. WPConsent blockiert Skripte aus einer remote gepflegten Liste. Wenn ein bestimmter Dienst nicht erkannt wird, werden seine Skripte ungehindert durchgelassen. Sie können überprüfen, ob ein Skript blockiert wird, indem Sie den Seitenquelltext anzeigen und nach den Attributen type="text/plain" und data-wpconsent-src bei Skript-Tags suchen.
  5. Das Skript wird dynamisch von einem anderen Skript geladen. Wenn ein Skript zur Laufzeit von JavaScript geladen wird (z. B. von Google Tag Manager), kann der serverseitige Ausgabepuffer von WPConsent es nicht erkennen, da es nur in der anfänglichen HTML-Antwort vorhanden ist. Google Consent Mode behandelt diesen Fall für Google-Dienste. Für andere Dienste, die über Tag-Manager geladen werden, sollten Sie die kostenpflichtige Version für benutzerdefinierte Blockierungsregeln in Betracht ziehen.
  6. Caching liefert eine vorverarbeitete Seite. Seiten-Caching-Plugins können das HTML cachen, bevor der Ausgabepuffer von WPConsent ausgeführt wird. Details finden Sie im Abschnitt Caching-Kompatibilität unten.
  7. Debug-Modus ist aktiv. Wenn die URL den Query-Parameter wpconsent_debug enthält, ist die Skriptblockierung absichtlich deaktiviert. Der Scanner verwendet diesen Parameter intern. Entfernen Sie ihn aus der URL, um die normale Blockierung wiederherzustellen.

Wie blockiere ich ein Skript, das nicht automatisch erkannt wird?

Pro-Funktion: Benutzerdefinierte Regeln zum Blockieren von Skripten und iframes sind in der kostenpflichtigen Version verfügbar. Sie können eine eindeutige Zeichenfolge hinzufügen, die das Skript identifiziert (z. B. ein URL-Fragment) und es einer Dienst- und Cookie-Kategorie zuweisen.

In der kostenlosen Version können Sie keine benutzerdefinierten Blockierungsregeln über die Admin-Oberfläche hinzufügen. Die Blockierliste von WPConsent wird jedoch remote aktualisiert. Sie können das WPConsent-Team kontaktieren, um die Aufnahme eines bestimmten Dienstes in die Liste der automatischen Erkennung zu beantragen.

Warum werden meine iframes oder eingebetteten Inhalte nicht blockiert?

Die iframe-Blockierung wird getrennt von der Skriptblockierung behandelt und muss unabhängig aktiviert werden:

  1. Navigieren Sie zuerst zu WPConsent >> Einstellungen.
  2. Aktivieren Sie dann den Umschalter Inhaltsblockierung.
  3. Wählen Sie dann aus der Mehrfachauswahlliste aus, welche Dienste Sie blockieren möchten.
  4. Klicken Sie abschließend auf Änderungen speichern.

Nur iframes von Diensten in der Liste bekannter Skripte, für die iframe-Muster definiert sind, werden blockiert.

Scanner-Probleme

Warum hat mein Scan nicht alle Dienste auf meiner Website erkannt?

Der Scanner identifiziert bekannte Dienste, indem er die HTML-Struktur Ihrer Website auf Skriptmuster und URL-Signaturen analysiert. Hier sind die häufigsten Gründe, warum er nicht alles erfasst:

  • Skripte, die von einem Tag-Manager geladen werden. Der Scanner der kostenlosen Version analysiert den rohen HTML-Code Ihrer Seiten. Wenn ein Tracking-Skript dynamisch über Google Tag Manager oder einen anderen Tag-Manager geladen wird, erscheint es nicht im HTML-Quellcode und der Scanner kann es nicht erkennen.

Pro-Funktion: Der Scanner der kostenpflichtigen Version kann auch Dienste erkennen, die von Plugins hinzugefügt wurden, und Skripte, die über Google Tag Manager geladen werden.

  • Der Dienst wird nur auf bestimmten Seiten ausgeführt. Standardmäßig prüft der Scanner Ihre Homepage. Wenn ein Tracking-Skript nur auf bestimmten Seiten geladen wird (z. B. einer Checkout-Seite oder einer Landingpage), findet der Scanner es nicht, es sei denn, Sie schließen diese Seiten ein. Sie können zusätzliche Seiten zum Scannen unter WPConsent >> Scanner auswählen, indem Sie Seiten in den Scannereinstellungen auswählen.
  • Der Dienst ist nicht in der WPConsent-Datenbank. Der Scanner greift auf eine serverseitige Datenbank bekannter Dienste zurück. Wenn ein Dienst sehr nischenspezifisch oder neu ist, ist er noch nicht in der Datenbank enthalten. Sie können fehlende Dienste und deren Cookies manuell hinzufügen, indem Sie Cookie-Daten von cookielibrary.org verwenden. Navigieren Sie zu WPConsent >> Einstellungen, klicken Sie auf die Registerkarte Cookies, fügen Sie einen neuen Dienst hinzu und geben Sie die Cookie-Details aus der Bibliothek ein.
  • Der Scan ist auf einen Fehler gestoßen. Der Scanner sendet eine HTTP-Anfrage an Ihre eigene Website, um deren HTML abzurufen, und sendet diese dann an die Scan-API. Wenn Ihre Website eine Authentifizierung erfordert, Basic Auth verwendet oder eine Firewall interne Anfragen blockiert, schlägt der Scan fehl oder liefert unvollständige Ergebnisse. Überprüfen Sie die Fehlermeldung der Scanner-Antwort auf Details.

Kann ich meine Website nach Änderungen erneut scannen?

Ja. Navigieren Sie zu WPConsent >> Scanner und führen Sie jederzeit einen neuen Scan durch. Wir empfehlen, nach dem Hinzufügen oder Entfernen von Plugins, dem Wechseln von Themes oder dem Hinzufügen neuer Tracking-Skripte zu Ihrer Website erneut zu scannen.

Kompatibilität

Funktioniert WPConsent mit meinem Caching-Plugin?

Ja, WPConsent ist mit den meisten Caching-Plugins kompatibel, aber Sie müssen verstehen, wie sie interagieren.

Die Skriptblockierung von WPConsent funktioniert über PHP-Output-Buffering, das den HTML-Code modifiziert, bevor er an den Browser gesendet wird. Page-Caching-Plugins (WP Rocket, W3 Total Cache, WP Super Cache, LiteSpeed Cache usw.) speichern die endgültige HTML-Ausgabe und liefern sie bei nachfolgenden Anfragen direkt aus, wodurch PHP vollständig umgangen wird.

Das bedeutet:

  • Die erste nicht zwischengespeicherte Seitenladung wird vom Output-Puffer von WPConsent verarbeitet. Skripte werden im resultierenden HTML korrekt blockiert, und diese blockierte Version wird dann zwischengespeichert.
  • Nachfolgende zwischengespeicherte Seitenladungen liefern das bereits modifizierte HTML, sodass die Skripte wie erwartet blockiert bleiben.

Wenn etwas schief geht:

  • Wenn Sie WPConsent aktiviert haben, nachdem Ihre Seiten bereits zwischengespeichert wurden, enthalten die zwischengespeicherten Seiten keine blockierten Skripte. Leeren Sie alle Caches, nachdem Sie die Einstellungen zur Skriptblockierung aktiviert oder geändert haben.
  • Wenn Ihr Caching-Plugin verschiedene zwischengespeicherte Versionen basierend auf Cookies liefert, stellen Sie sicher, dass es nicht den wpconsent_preferences Cookie entfernt. Das Banner und die Entblockierungslogik von WPConsent laufen in JavaScript im Frontend und funktionieren daher unabhängig vom Caching, solange das anfängliche HTML die Skripte korrekt modifiziert hat.

WP Rocket spezifisch: WPConsent enthält eine integrierte Kompatibilitätsdatei, die den Bannercontainer von der Lazy-Rendering-Funktion von WP Rocket ausschließt. Es sind keine zusätzlichen Konfigurationen erforderlich.

Funktioniert WPConsent mit meinem Page Builder?

Ja. WPConsent enthält eine integrierte Kompatibilität mit den folgenden Page Buildern:

  • Bricks Builder: WPConsent deaktiviert automatisch das Banner und die Skriptblockierung, während Sie in Bricks Builder bearbeiten, um Störungen zu vermeiden. Das Banner funktioniert normal im Frontend.
  • Divi Builder: Ähnlich wie bei Bricks deaktiviert WPConsent das Banner und die Skriptblockierung im Divi Visual Builder Editor. Alles funktioniert normal auf der veröffentlichten Seite.

Für andere Page Builder (Elementor, Beaver Builder, WPBakery usw.) funktioniert WPConsent im Frontend ohne spezielle Konfiguration. Das Banner und die Skriptblockierung laufen nur bei normalen Frontend-Seitenaufrufen und stören die Editor-Oberflächen nicht.

Ja. WPConsent integriert sich mit dem WP Consent API Plugin. Wenn die WP Consent API aktiv ist, registriert sich WPConsent automatisch als aktives Zustimmungs-Plugin und kommuniziert die Zustimmungsauswahl des Besuchers für jede Kategorie (funktional, Präferenzen, Statistiken und Marketing). Dies ermöglicht es anderen Plugins, die die WP Consent API unterstützen, die über das Banner von WPConsent festgelegten Zustimmungspräferenzen zu respektieren. Details zur Integration finden Sie im WP Consent API Leitfaden.

Testen

Befolgen Sie diese Schritte, um zu überprüfen, ob WPConsent Skripte ordnungsgemäß blockiert und freigibt:

  1. Öffnen Sie zuerst ein privates oder Inkognito-Browserfenster. Dies stellt sicher, dass kein vorhandener Zustimmungs-Cookie vorhanden ist.
  2. Öffnen Sie als Nächstes die Entwicklertools Ihres Browsers (normalerweise F12 oder Rechtsklick und dann Inspizieren).
  3. Gehen Sie zum Tab Elemente und suchen Sie nach data-wpconsent-src. Sie sollten blockierte Skript-Tags mit type="text/plain" sehen, wobei die ursprüngliche Quelle in data-wpconsent-src gespeichert ist. Dies bestätigt, dass die Skriptblockierung funktioniert.
  4. Überprüfen Sie den Tab Netzwerk. Bevor Sie der Zustimmung zustimmen, sollten keine Anfragen an Tracking-Dienste (wie google-analytics.com oder connect.facebook.net) erscheinen. Wenn Google Consent Mode oder Clarity Consent Mode aktiviert ist, werden diese spezifischen Dienste stattdessen im eingeschränkten Modus geladen.
  5. Klicken Sie auf die Schaltfläche Alle akzeptieren im Banner.
  6. Überprüfen Sie den Tab Netzwerk erneut. Sie sollten nun Anfragen an die Tracking-Dienste sehen, da deren Skripte freigegeben und ausgeführt werden.
  7. Gehen Sie zum Tab Anwendung. Unter Cookies sollten Sie den Cookie wpconsent_preferences mit einem JSON-Wert sehen, der jede Kategorie und ihren Zustimmungsstatus (true oder false) auflistet.
  8. Um den Widerruf der Zustimmung zu testen, klicken Sie auf die schwebende Präferenzschaltfläche (falls aktiviert) oder fügen Sie die Klasse wpconsent-open-preferences zu einem beliebigen Link auf Ihrer Seite hinzu. Dies öffnet das Präferenzfeld. Deaktivieren Sie eine Kategorie und speichern Sie. Die Seite wird neu geladen und die Skripte der widerrufenen Kategorie werden wieder blockiert.

Gibt es einen Debug-Modus, den ich verwenden kann?

Ja. Fügen Sie ?wpconsent_debug zu jeder URL auf Ihrer Website hinzu, um die Skriptblockierung für diesen Seitenaufruf vorübergehend zu deaktivieren. Dies ist nützlich zur Fehlerbehebung und ist derselbe Parameter, den der Scanner beim Abrufen des HTML Ihrer Website verwendet. Der Debug-Modus wirkt sich nur auf die Skriptblockierung aus. Das Banner wird weiterhin normal angezeigt.

Beachten Sie, dass der Debug-Modus keine dauerhafte Einstellung ist. Er gilt nur für den spezifischen Seitenaufruf, bei dem der URL-Parameter vorhanden ist.

Garantiert WPConsent die vollständige Einhaltung von Datenschutzgesetzen?

WPConsent lehnt ausdrücklich alle Zusicherungen und Gewährleistungen ab, dass WPConsent den geltenden Datenschutzgesetzen und -vorschriften entspricht. Es liegt in Ihrer alleinigen Verantwortung, die geltenden Datenschutzgesetze und -vorschriften einzuhalten. WPConsent bietet keine Rechtsberatung und Sie sollten sich für eine Beratung zu diesem Thema an einen Rechtsbeistand wenden. Bitte beachten Sie unsere Nutzungsbedingungen.

Schlussfolgerung

Diese FAQ behandelt die häufigsten Fragen zu WPConsent, von Problemen bei der Banneranzeige und Skriptblockierung bis hin zum Scannerverhalten und der Caching-Kompatibilität. Wenn Ihre Frage hier nicht beantwortet wird, lesen Sie die zugehörigen Anleitungen unten, um detailliertere Informationen zu bestimmten Themen zu erhalten.

Für einen vollständigen Überblick über das Plugin und seine Funktionen lesen Sie unsere Anleitung zu Was ist WPConsent und wie funktioniert es.

War dieser Artikel hilfreich?

Verwandte Artikel