WPConsent Dokumentation

Dokumentation, Referenzmaterialien und Tutorials für WPConsent

WP Consent API-Integration

Möchten Sie, dass andere WordPress-Plugins die Zustimmungseinstellungen Ihrer Besucher automatisch erkennen? WPConsent integriert sich mit dem WP Consent API-Plugin, sodass Entscheidungen über die Zustimmung, die über Ihr Banner getroffen werden, an jedes kompatible Plugin auf Ihrer Website weitergegeben werden. Diese Anleitung erklärt, was die WP Consent API ist, warum die Integration wichtig ist und wie WPConsent seine Kategorien dem Standard-API-Format zuordnet.

Inhaltsverzeichnis

Die WP Consent API ist ein kostenloses WordPress-Plugin, das eine gemeinsame Sprache für die Einwilligungsverwaltung schafft. Anstatt dass jedes Plugin seine eigenen Zustimmungsprüfungen erstellt, bietet die WP Consent API einen einzigen Standard, den Plugins verwenden können, um zu fragen: „Erlaubt dieser Besucher Statistik-Cookies?“ oder „Erlaubt dieser Besucher Marketing-Cookies?“

Jedes Plugin, das die WP Consent API unterstützt, kann Zustimmungsstatus von jedem kompatiblen Einwilligungsverwaltungs-Plugin lesen. Das bedeutet, Sie sind nicht an ein bestimmtes Ökosystem gebunden – Ihre Zustimmungsentscheidungen fließen in jedes Plugin, das dieselbe Sprache spricht.

Warum diese Integration wichtig ist

Ohne die WP Consent API behandelt jedes Plugin die Zustimmung unabhängig. Dies kann zu Situationen führen, in denen:

  • Ein Besucher akzeptiert Cookies über Ihr WPConsent-Banner, aber ein Formular-Plugin weiß nichts davon und blockiert unnötigerweise die Funktionalität.
  • Ein Besucher lehnt Marketing-Cookies ab, aber ein Analyse-Plugin wird trotzdem geladen, da es den Zustimmungsstatus von WPConsent nicht prüft.
  • Sie müssen Zustimmungsprüfungen in mehreren Plugins manuell konfigurieren, anstatt alles von einem Ort aus zu verwalten.

Wenn die Integration aktiv ist, wird WPConsent zur einzigen Wahrheitsquelle für die Zustimmung auf Ihrer Website. Jedes WP Consent API-kompatible Plugin respektiert automatisch die Entscheidungen, die Besucher über Ihr Banner treffen.

Wie die Integration funktioniert

Wenn sowohl WPConsent als auch das WP Consent API-Plugin aktiv sind, erfolgt die Integration automatisch. Es gibt nichts zu konfigurieren.

Hier ist, was WPConsent im Hintergrund tut:

  1. Registriert sich als aktiver Einwilligungsmanager, damit die WP Consent API weiß, welches Plugin die Zustimmung verwaltet.
  2. Legt den Zustimmungstyp (Opt-in oder Opt-out) basierend auf Ihren WPConsent-Einstellungen fest, damit andere Plugins wissen, ob sie standardmäßig blockieren oder zulassen sollen.
  3. Synchronisiert Zustimmungsentscheidungen, wann immer ein Besucher seine Präferenzen über das Banner speichert. WPConsent übersetzt seine eigenen Kategorien in das Standardformat der WP Consent API.
  4. Vermeidet doppelte Blockierung, indem die eigene Skriptblockierung für Skripte übersprungen wird, die die WP Consent API bereits verwaltet.

Wenn das WP Consent API-Plugin nicht installiert ist, funktioniert WPConsent genau gleich – die Integration wird einfach nicht aktiviert.

Kategoriezuordnung

WPConsent verwendet eigene Kategorienamen (Essential, Statistics, Marketing), während die WP Consent API einen anderen Satz von Standardkategorien verwendet. WPConsent ordnet automatisch zwischen den beiden um, sobald ein Besucher seine Präferenzen speichert.

WPConsent-KategorieWP Consent API-KategorieZustimmungsstatus
WesentlichefunktionalImmer erlaubt
WesentlichePräferenzenImmer erlaubt
StatistikenStatistikenBasierend auf der Wahl des Besuchers
StatistikenStatistiken anonymBasierend auf der Wahl des Besuchers
MarketingMarketingBasierend auf der Wahl des Besuchers

Ein paar Dinge, die Sie beachten sollten:

  • Essential wird sowohl functional als auch preferences zugeordnet, da WPConsent keine separate Präferenzkategorie hat. Beide sind immer auf „erlaubt“ gesetzt, da essentielle Cookies für die Funktionsfähigkeit Ihrer Website erforderlich sind.
  • Statistics wird sowohl statistics als auch statistics-anonymous zugeordnet. Die WP Consent API unterscheidet zwischen regulären und anonymen Analysen, aber WPConsent behandelt sie gleich – beide folgen der Statistik-Auswahl des Besuchers.
  • Marketing wird direkt marketing zugeordnet, ohne zusätzliche Übersetzungen.

Diese Zuordnung bedeutet, dass jedes Plugin, das wp_has_consent( 'statistics' ) oder wp_has_consent( 'marketing' ) prüft, automatisch die Entscheidungen respektiert, die Besucher über Ihr WPConsent-Banner treffen.

WPConsent teilt der WP Consent API mit, ob Ihre Website Opt-in oder Opt-out-Zustimmung verwendet:

  • Opt-in (Standardmäßig deaktiviert): Skripte und Cookies werden blockiert, bis der Besucher sie ausdrücklich akzeptiert. Dies ist der Standard für die DSGVO-Konformität.
  • Opt-out (Standardmäßig aktiviert): Skripte und Cookies sind standardmäßig erlaubt, bis der Besucher sie aktiv ablehnt.

Diese Einstellung wird aus Ihrer WPConsent-Konfiguration unter WPConsent >> Einstellungen (der Schalter Standardmäßig erlauben) gelesen. Andere Plugins, die den Zustimmungs-Typ prüfen, können dann ihr Verhalten entsprechend anpassen.

Koordination der Skriptblockierung

Wenn sowohl WPConsent als auch die WP Consent API dasselbe Skript verwalten, kann es zu einer doppelten Blockierung kommen. Um dies zu verhindern, überspringt WPConsent automatisch seine eigene Blockierung für Skripte, die die WP Consent API bereits verwaltet.

Zum Beispiel wird das Attributions-Tracking-Skript von WooCommerce über die WP Consent API verwaltet. WPConsent erkennt dies und lässt die WP Consent API die Blockierung übernehmen, anstatt eigene Regeln anzuwenden.

Einrichtung der Integration

  1. Installieren und aktivieren Sie das Plugin WP Consent API aus dem WordPress-Plugin-Repository.
  2. Das war's. WPConsent erkennt die WP Consent API automatisch und aktiviert die Integration.

Es gibt keine zusätzlichen Einstellungen zu konfigurieren. Die Kategorienzuordnung, die Synchronisierung des Zustimmungs-Typs und die Koordination der Skriptblockierung erfolgen automatisch.

FAQ

Ja. Die WP Consent API ist ein separates kostenloses Plugin, das im WordPress-Plugin-Repository erhältlich ist. Installieren und aktivieren Sie es zusammen mit WPConsent, um die Integration zu ermöglichen.

Verifizieren Sie zuerst, ob das WP Consent API-Plugin installiert und aktiv ist. Bestätigen Sie dann, dass das andere Plugin die WP Consent API tatsächlich unterstützt (prüfen Sie dessen Dokumentation). Testen Sie abschließend in einem Inkognito-Fenster, um den zwischengespeicherten Einwilligungsstatus auszuschließen.

Nein. WPConsent funktioniert vollständig eigenständig. Die WP Consent API-Integration ist eine optionale Ergänzung, die die Interoperabilität mit anderen Plugins verbessert, die den Standard unterstützen.

Erfordert die Integration eine Konfiguration?

Nein. Sobald beide Plugins aktiv sind, übernimmt WPConsent automatisch die gesamte Verwaltung – Registrierung, Kategoriezuordnung, Synchronisierung des Einwilligungs-Typs und Koordination der Skriptblockierung.

Schlussfolgerung

Die WP Consent API-Integration ermöglicht es WPConsent, Einwilligungsentscheidungen über eine standardisierte Schnittstelle mit jedem kompatiblen Plugin auf Ihrer Website zu teilen. Installieren Sie das WP Consent API-Plugin, und WPConsent erledigt den Rest automatisch. Weitere Informationen zu verwandten Themen finden Sie unter Verwaltung von Cookie-Kategorien und automatische Skriptblockierung.

War dieser Artikel hilfreich?

Verwandte Artikel