Consentl

Consentl für WordPress

Plugin installieren, „Verbinden“ klicken, und das Banner lädt als erstes im <head>. Mit WP Consent API, Seiten-Caches, WPML und Polylang, Block- und klassischen Themes.

Loader als erstes im <head>
Ja
Herunterladen
consentl-wordpress-1.1.0.zip · Version 1.1.0 · 248 KB · SHA-256

Das Consentl-Plugin speichert Ihren Website-Schlüssel, gibt den Consentl-Loader als erstes Element des <head> aus, gibt jede Auswahl an die WP Consent API und WooCommerce weiter und fügt Blöcke und Shortcodes für die Cookie-Erklärung, das Formular für Datenschutzanfragen und das EU-Widerrufsformular hinzu. Das Banner selbst, seine Texte und Regionen werden im Consentl-Dashboard verwaltet.

Voraussetzungen

  • WordPress 6.5 oder neuer, PHP 7.4 oder neuer.
  • Ein Consentl-Konto (Tarif Free verfügbar).
  • Optional: das Plugin WP Consent API (2.0+), WooCommerce 8.5+.

Installation

  1. Laden Sie die ZIP-Datei des Plugins unter Downloads herunter. Sobald es dort veröffentlicht ist, wird es auch auf WordPress.org verfügbar sein.
  2. Gehen Sie in WordPress zu Plugins → Neues Plugin hinzufügen → Plugin hochladen, wählen Sie die ZIP-Datei, klicken Sie auf Jetzt installieren und dann auf Aktivieren.
  3. Leeren Sie Ihren Seiten-Cache, falls Sie einen verwenden.

Updates

Ab Version 1.1.0 prüft das Plugin consentl.com auf neue Versionen, sodass diese wie jedes andere Update unter Dashboard → Aktualisierungen und in der Ansicht Plugins erscheinen, mit Details ansehen, Updates mit einem Klick und automatischen Updates (auch in der Netzwerkverwaltung einer Multisite). WordPress prüft etwa zweimal am Tag; Erneut prüfen unter Dashboard → Aktualisierungen prüft sofort. Die Prüfung sendet weder den Website-Schlüssel noch die Adresse der Website noch Besucherdaten. Wenn Sie 1.0.0 installiert haben, laden Sie die neue ZIP-Datei einmal hoch (Plugins → Neues Plugin hinzufügen → Plugin hochladen, dann die aktuelle Version durch die hochgeladene ersetzen, „Replace current with uploaded“); spätere Versionen kommen von selbst.

Wenn Ihr Server ausgehende Anfragen blockiert (WP_HTTP_BLOCK_EXTERNAL), erlauben Sie consentl.com neben api.wordpress.org in WP_ACCESSIBLE_HOSTS, oder laden Sie neue ZIP-Dateien weiterhin von Hand hoch. Um die Update-Prüfung abzuschalten, fügen Sie define( 'CONSENTL_SELF_UPDATE', false ); in die wp-config.php ein.

Website verbinden

  1. Gehen Sie zu Einstellungen → Consentl und klicken Sie auf Mit Consentl verbinden.
  2. Melden Sie sich an oder erstellen Sie ein kostenloses Konto und wählen oder erstellen Sie dann Ihre Website. Sie werden mit eingetragenem Website-Schlüssel zu WordPress zurückgeleitet, und der Status zeigt Verbunden.

Sie können den Schlüssel (er beginnt mit sk_) auch aus dem Dashboard einfügen. Um ihn pro Umgebung festzulegen, fügen Sie diese Zeile in die wp-config.php ein; das Feld ist dann schreibgeschützt:

define( 'CONSENTL_SITE_KEY', 'sk_…' );

Konfiguration

Unter Einstellungen → Consentl:

  • Banner-Sprache: Automatisch (Standard) folgt der Sprache der Seite aus WPML oder Polylang oder dem Gebietsschema von WordPress. Website-Sprache verwendet die Sprache aus Einstellungen → Allgemein. Feste Sprache verwendet eine Sprache für alle Seiten.
  • WP Consent API (standardmäßig an): Plugins, die der WP Consent API folgen (zum Beispiel Site Kit by Google, WooCommerce, WP Statistics, Burst Statistics), erhalten die Auswahl des Besuchers automatisch.
  • Consentl-Dashboard öffnen für Banner-Design, Texte, Regionen, Cookies, das Einwilligungsprotokoll und Datenschutzanfragen. Änderungen erscheinen innerhalb von etwa fünf Minuten auf Ihrer Website.

Fügen Sie dann Folgendes auf Ihrer Seite mit der Datenschutzerklärung oder der Cookie-Richtlinie ein:

Block Shortcode
Cookie-Erklärung [consentl_cookie_declaration heading="Cookies we use"]
Formular für Datenschutzanfragen [consentl_privacy_request]
EU-Widerrufsformular (ab Tarif Pro) [consentl_withdrawal_form]
Link zu den Cookie-Einstellungen [consentl_cookie_settings label="Cookie settings"]

Fügen Sie in Menüs einen individuellen Link auf #consentl hinzu, um die Einstellungen erneut zu öffnen.

Prüfen, ob es funktioniert

  1. Öffnen Sie Ihre Website in einem privaten Fenster und sehen Sie sich den Seitenquelltext an: Der Consentl-Loader ist das erste <script> im <head>, direkt nach <meta charset>.
  2. Das Banner erscheint. In der Browserkonsole zeigt Consentl.get() die aktuelle Auswahl.
  3. Mit installierter WP Consent API ist wp_has_consent('statistics') in einer Opt-in-Region false, bevor Sie Statistiken akzeptieren, und danach true.

Cache- und Optimierungs-Plugins

Das HTML der Seite ist für jeden Besucher gleich, und jede Auswahl wird im Browser angewendet, daher ist Full-Page-Caching unbedenklich. Der Loader wird in WP Rocket, LiteSpeed Cache, Autoptimize, SiteGround Speed Optimizer, Jetpack Boost und Cloudflare Rocket Loader automatisch vom Verzögern („defer“, „delay“) und Zusammenfassen ausgenommen. Für andere Optimierungs-Plugins (Perfmatters, FlyingPress, WP-Optimize, Hummingbird, NitroPack usw.) nehmen Sie /v1/loader.js von „delay JS“, „defer JS“ und „combine JS“ aus.

Für Entwickler

  • consentl_has_consent( 'analytics' ) ist true, wenn der Besucher die Kategorie erlaubt hat (necessary, preferences, analytics, marketing oder sale). Es liest das Cookie consentl; verwenden Sie es nicht in Fragmenten, die pro Seite zwischengespeichert werden.
  • consentl_get_consent() gibt die gespeicherte Entscheidung zurück oder null.
  • consentl_loader_tag() gibt den Loader selbst aus, für Themes, die Skripte vor wp_head() ausgeben (zum Beispiel ein Google-Tag-Manager-Snippet direkt nach <head>).
  • JavaScript: Consentl.get(), Consentl.allowed('marketing'), Consentl.on('change', fn), Consentl.open('prefs') und das Event consentl:change auf document.
  • Filter: consentl_should_load, consentl_loader_attributes, consentl_head_priority, consentl_locale, consentl_has_consent, consentl_woocommerce_attribution_client_side, consentl_api_origin, consentl_app_origin.

Einschränkungen

  • Betreiben Sie nicht zwei Einwilligungs-Plugins: Complianz, CookieYes, Cookiebot und ähnliche Plugins antworten ebenfalls auf die WP Consent API und würden kollidieren. Deaktivieren Sie das andere.
  • AMP-Seiten laden das Banner nicht (AMP benötigt amp-consent, was nicht unterstützt wird).
  • Skripte, die ein Theme vor wp_head() ausgibt, laufen vor Consentl; verwenden Sie consentl_loader_tag() wie oben beschrieben.
  • Mit einer Content Security Policy erlauben Sie https://api.consentl.com für script-src und connect-src (siehe Jede Website).
  • In einem Multisite-Netzwerk braucht jede Website ihren eigenen Website-Schlüssel.
  • Wenn Sie das Plugin löschen, werden seine Einstellungen entfernt. Ihr Einwilligungsprotokoll bleibt in Ihrem Consentl-Konto, denn es ist Ihr Einwilligungsnachweis.

Kommen Sie nicht weiter? Schreiben Sie an support@consentl.com – wir antworten an Werktagen auf Englisch.