Consentl für Magento 2 / Adobe Commerce

Das Consentl-Modul für Magento und Adobe Commerce 2.4.6 bis 2.4.8: Loader direkt nach <meta charset>, Brücke zum Cookie Restriction Mode, CMS-Widgets. Luma und Hyvä.

Loader als erstes im <head>

Ja

Herunterladen

consentl-module-consent-1.1.0.zip · Version 1.1.0 · 201 KB · SHA-256

Das Modul consentl/module-consent verbindet Ihren Magento-Shop mit Consentl. Es speichert den Website-Schlüssel pro Website oder Store-View, fügt den Loader direkt nach <meta charset> ein, überträgt jede Auswahl an den Cookie Restriction Mode von Magento und stellt CMS-Widgets bereit. Banner-Design, Texte in 34 Sprachen, Regionsregeln und Blockierungsregeln werden im Consentl-Dashboard verwaltet.

Voraussetzungen

• Magento Open Source oder Adobe Commerce 2.4.6, 2.4.7 oder 2.4.8; PHP 8.1 bis 8.4, soweit von Ihrer Magento-Version unterstützt.
• Themes Luma oder Hyvä; der integrierte Full Page Cache und Varnish werden unterstützt.
• Ein Consentl-Konto (Tarif Free verfügbar).

Installation

Aus der ZIP-Datei (Downloads): Entpacken Sie sie nach app/code/Consentl/Consent/, sodass composer.json auf der obersten Ebene dieses Ordners liegt, und führen Sie dann aus:

bin/magento module:enable Consentl_Consent
bin/magento setup:upgrade
bin/magento setup:di:compile              # production mode
bin/magento setup:static-content:deploy   # production mode
bin/magento cache:flush

Mit Composer: composer require consentl/module-consent, sobald das Paket veröffentlicht ist, dann dieselben Befehle.

Website verbinden

Gehen Sie zu Stores → Configuration → Consentl → Cookie Consent (in einer deutschen Administration: „Cookie-Einwilligung“) und wählen Sie zuerst den Geltungsbereich (Schlüssel und Sprache können sich pro Website oder Store-View unterscheiden).

• Mit Consentl verbinden meldet Sie an oder erstellt ein kostenloses Konto, lässt Sie die Website für die Domain dieses Shops wählen oder erstellen und bringt Sie mit gespeichertem Site-Schlüssel und aktiviertem Consentl zurück. Der Rücklink ist nur in derselben Admin-Sitzung gültig.
• Oder fügen Sie den Schlüssel (sk_ + 24 Zeichen) ein und setzen Sie Consentl aktivieren auf Ja.

Leeren Sie nach dem Speichern den Full Page Cache, wenn Ihre Installation das nicht automatisch tut.

Konfiguration

• Bannersprache: Automatisch ordnet das Gebietsschema der Store-View der nächstgelegenen Consentl-Sprache zu (de_AT → de, pt_BR → pt-BR, nb_NO → nb). Sie können auch eine Sprache fest vorgeben.
• Brücke zum Cookie Restriction Mode (empfohlen, wenn Sie die Module Google Analytics oder Google Tag von Magento verwenden):
  1. Setzen Sie Stores → Configuration → General → Web → Default Cookie Settings → Cookie Restriction Mode auf Yes.
  2. Setzen Sie Consentl-Entscheidungen mit dem Cookie-Beschränkungsmodus synchronisieren auf Ja.
  3. Setzen Sie Magentos eigenen Cookie-Hinweis ausblenden auf Ja.
  4. Optional: Seite nach der ersten Einwilligung neu laden, damit die Google-Module von Luma schon beim selben Seitenaufruf starten statt erst beim nächsten.
• Erweitert: Behalten Sie die Position des Loaders Erstes Element in <head> bei.

CMS-Widgets (Content → Pages / Blocks → Insert Widget):

Jedes <a href="#consentl">…</a> in einem CMS-Block öffnet die Einstellungen ebenfalls erneut.

Prüfen, ob es funktioniert

1. Sehen Sie sich den Seitenquelltext an: Der Loader folgt direkt auf <meta charset>. Bei Luma steht die Inline-Konfiguration von RequireJS darüber; sie lädt nichts.
2. Mit aktivierter Brücke: Vor jeder Auswahl in einer Opt-in-Region ist das Cookie user_allowed_save_cookie nicht gesetzt; nach dem Akzeptieren einer Kategorie ist es für Ihre Website gesetzt.
3. Die Seiten bleiben cachebar: Die Ausgabe enthält keine besucherspezifischen Daten.

Content Security Policy

Das Modul erlaubt https://api.consentl.com in der CSP-Whitelist von Magento und gibt kein Inline-JavaScript aus, daher funktioniert es mit der Checkout-CSP im Restrict-Modus ab 2.4.7 und mit CSP-Themes von Hyvä.

Für Entwickler

Consentl\Consent\ViewModel\Consent::allows('marketing') liest das Cookie consentl, nur für nicht gecachte Kontexte (Checkout, Kundenkonto, AJAX). Auf gecachten Seiten steuern Sie Tags im HTML mit <script type="text/plain" data-consentl="marketing">…</script>.

Einschränkungen

• Skripte, die eine andere Erweiterung oberhalb von <meta charset> ausgibt, oder Inline-Skripte, die ein Theme vor den Head-Inhalt setzt, laufen vor Consentl.
• Magento_GoogleTagManager von Adobe Commerce (Closed Source) wurde mit der Brücke nicht geprüft. Verwenden Sie Consent Mode (ab Tarif Pro, im Dashboard aktiviert): Consentl setzt Standardwerte und Aktualisierungen, und GTM-Tags beachten sie.
• Magento hat nur ein einziges Opt-in-Flag, daher setzt die Brücke es, sobald irgendeine optionale Kategorie erlaubt wird.
• Wenn bei Hyvä dessen eigener Cookie-Hinweis weiterhin erscheint, entfernen Sie ihn in Ihrem Theme mit <referenceBlock name="cookie_notices" remove="true"/> in Magento_Cookie/layout/default.xml.
• Bei der Deinstallation bleiben die Konfigurationswerte unter consentl/* in core_config_data erhalten; löschen Sie sie bei Bedarf mit bin/magento config:delete.

Verwandte Anleitungen

• Shopware 6
• PrestaShop
• Google Tag Manager

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