Consentl

Consentl für Shopware 6

Das Consentl-Plugin für Shopware 6.6 und 6.7: Banner als erstes im <head>, ersetzt die Cookie-Leiste von Shopware, hält Cookie-Gruppen mit jeder Auswahl synchron.

Loader als erstes im <head>
Ja
Herunterladen
consentl-shopware-1.1.1.zip · Version 1.1.1 · 164 KB · SHA-256

Das Consentl-Plugin verbindet Ihren Shopware-Shop mit Consentl. Es speichert den Website-Schlüssel pro Verkaufskanal, gibt den Loader als erstes Element des <head> aus, ersetzt die Cookie-Leiste von Shopware und gibt jede Auswahl an die Cookie-Gruppen von Shopware weiter, sodass Merkzettel, YouTube-Elemente, Google Analytics und andere Funktionen ihr folgen. Texte, Farben, Regionen und Einwilligungsnachweise werden im Consentl-Dashboard verwaltet.

Voraussetzungen

  • Shopware 6.6 oder 6.7, PHP 8.2 oder neuer.
  • Ein Consentl-Konto (Tarif Free verfügbar).

Installation

Aus der ZIP-Datei (Downloads):

  1. Gehen Sie in der Administration zu Erweiterungen → Meine Erweiterungen → Erweiterung hochladen und wählen Sie die ZIP-Datei, oder führen Sie auf dem Server aus:
bin/console plugin:zip-import consentl-shopware-<version>.zip
bin/console plugin:install --activate ConsentlConsent
bin/console cache:clear
  1. Installieren und aktivieren Sie Consentl und leeren Sie dann den Cache.

Das Storefront-Skript des Plugins wird bei der Aktivierung nach public/bundles/consentlconsent/ kopiert; führen Sie bin/console assets:install aus, wenn Sie ohne den Plugin-Lebenszyklus deployen.

Website verbinden

Öffnen Sie Erweiterungen → Meine Erweiterungen → Consentl → Konfigurieren. Die Einstellungen gelten pro Verkaufskanal und erben von „Alle Verkaufskanäle“.

  • Mit Consentl verbinden meldet Sie an, lässt Sie die Website wählen oder erstellen und speichert den Schlüssel für den gewählten Verkaufskanal.
  • Oder fügen Sie den Website-Schlüssel (Feld „Site-Key“; sk_ + 24 Zeichen) aus dem Dashboard ein und speichern Sie.

Konfiguration

Einstellung Standard Hinweise
Consentl-Banner anzeigen an Aus = der Loader wird nicht ausgegeben; der Schlüssel bleibt erhalten
Cookie-Hinweis von Shopware ersetzen an Blendet die Cookie-Leiste und den Cookie-Einstellungsdialog von Shopware aus
Einwilligung mit den Cookie-Gruppen von Shopware synchronisieren an Siehe unten
Kategorie für unbekannte Cookie-Gruppen Marketing Für Gruppen anderer Erweiterungen, die nicht zugeordnet werden können
Banner-Sprache Automatisch Die Sprache der Domain des Verkaufskanals (de-AT → de)

Cookie-Gruppen. Die Gruppen von Shopware werden Consentl-Kategorien zugeordnet: technisch erforderlich → unbedingt erforderlich, Komfortfunktionen → Präferenzen, Statistik → Statistiken, Marketing → Marketing. Andere Gruppen werden über Schlüsselwörter zugeordnet oder erhalten die Ersatzkategorie. Wenn ein Besucher entscheidet, schreibt das Plugin dieselben Cookies, die Shopware selbst schreiben würde (wishlist-enabled, youtube-video, google-analytics-enabled, …), und meldet die Änderung, sodass Erweiterungen, die auf Einwilligungsänderungen hören, ohne Neuladen reagieren. Links zu den Cookie-Einstellungen von Shopware öffnen die Consentl-Einstellungen.

Widgets. Erlebniswelten-Block Consentl (Kategorie Text) mit den Elementen Consentl-Cookie-Erklärung, Consentl-Formular für Datenschutzanfragen und Consentl-Widerrufsformular. In Themes können Sie auch die Twig-Includes verwenden:

{% sw_include '@ConsentlConsent/storefront/consentl/widget.html.twig' with { consentlType: 'declaration' } %}
{% sw_include '@ConsentlConsent/storefront/consentl/settings-link.html.twig' %}

consentlType kann declaration, request oder withdrawal sein.

Prüfen, ob es funktioniert

  1. Sehen Sie sich den Seitenquelltext Ihrer Storefront an: Der <head> beginnt mit <script src="https://api.consentl.com/v1/loader.js?k=…&l=de">.
  2. Die Cookie-Leiste von Shopware erscheint nicht mehr; stattdessen erscheint das Consentl-Banner.
  3. Alle ablehnen: Die Cookies google-analytics-enabled, wishlist-enabled und youtube-video werden nicht gesetzt, und Google Analytics wird nicht geladen. Statistiken akzeptieren: google-analytics-enabled=1 wird ohne Neuladen gesetzt.

Für Entwickler

In Twig prüft {% if consentl_allowed('marketing') %}…{% endif %} eine gespeicherte Entscheidung. Es sieht nur das Cookie consentl (nicht die Standardwerte der Region) und wird beim Rendern der Seite ausgewertet, daher werden Seiten aus dem HTTP-Cache von Shopware nicht neu ausgewertet. Verwenden Sie vorzugsweise die clientseitige Blockierung: <script type="text/plain" data-consentl="analytics">…</script>.

Einschränkungen

  • Wenn Sie die Cookie-Leiste von Shopware behalten („Cookie-Hinweis von Shopware ersetzen“ aus), laufen zwei Einwilligungsoberflächen; nutzen Sie das nur für eine Übergangszeit.
  • Shopware 6.7 enthält ein eigenes Formular für Widerrufsanfragen. Verwenden Sie entweder das Widerrufsformular von Shopware oder das von Consentl, nicht beide.
  • Der Verbindungsablauf verwendet den Host der Administration als Domain; fügen Sie Ihre Storefront-Domains im Consentl-Dashboard hinzu, wenn sie abweichen.

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