Consentl pentru Magento 2 / Adobe Commerce

Modulul Consentl pentru Magento și Adobe Commerce 2.4.6 – 2.4.8: scriptul de încărcare după <meta charset>, Cookie Restriction Mode, widgeturi CMS, Luma și Hyvä.

Scriptul de încărcare primul în <head>

Da

Descărcare

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

Modulul consentl/module-consent vă conectează magazinul Magento la Consentl. Stochează cheia site-ului pentru fiecare website sau store view, inserează scriptul de încărcare imediat după <meta charset>, transmite fiecare alegere către Cookie Restriction Mode din Magento și oferă widgeturi CMS. Designul bannerului, textele în 34 de limbi, regulile pe regiuni și regulile de blocare se administrează în panoul de control Consentl.

Cerințe

• Magento Open Source sau Adobe Commerce 2.4.6, 2.4.7 ori 2.4.8; PHP 8.1 – 8.4, în funcție de ce acceptă versiunea dumneavoastră de Magento.
• Teme Luma sau Hyvä; sunt acceptate Full Page Cache integrat și Varnish.
• Un cont Consentl (este disponibil planul Free).

Instalare

Din arhiva zip (Descărcări): dezarhivați-o în app/code/Consentl/Consent/, astfel încât composer.json să se afle la nivelul superior al acelui dosar, apoi rulați:

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

Cu Composer: composer require consentl/module-consent după publicarea pachetului, apoi aceleași comenzi.

Conectați site-ul

Accesați Stores → Configuration → Consentl → Cookie Consent și selectați mai întâi domeniul de aplicare (scope) (cheia și limba pot diferi pentru fiecare website sau store view).

• Connect to Consentl vă conectează sau creează un cont gratuit, vă permite să alegeți sau să creați site-ul pentru domeniul acestui magazin și vă aduce înapoi cu Site key salvat și Consentl activat. Linkul de întoarcere este valabil doar în aceeași sesiune de administrare.
• Sau lipiți cheia (sk_ + 24 de caractere) și setați Enable Consentl la Yes.

Goliți Full Page Cache după salvare, dacă configurația dumneavoastră nu face acest lucru automat.

Configurare

• Banner language: Automatic asociază setarea regională a store view-ului cu cea mai apropiată limbă Consentl (de_AT → de, pt_BR → pt-BR, nb_NO → nb). Puteți și să impuneți o limbă.
• Legătura cu Cookie Restriction Mode (recomandată dacă folosiți modulele Google Analytics sau Google Tag din Magento):
  1. Setați Stores → Configuration → General → Web → Default Cookie Settings → Cookie Restriction Mode la Yes.
  2. Setați Sync Consentl decisions to Cookie Restriction Mode la Yes.
  3. Setați Hide Magento's native cookie notice la Yes.
  4. Opțional: Reload the page after the first opt-in, astfel încât modulele Google din Luma să pornească la aceeași afișare a paginii, nu la următoarea.
• Advanced: păstrați poziția scriptului de încărcare First element in <head>.

Widgeturi CMS (Content → Pages / Blocks → Insert Widget):

Orice <a href="#consentl">…</a> dintr-un bloc CMS redeschide și el preferințele.

Verificați că funcționează

1. Vizualizați sursa paginii: scriptul de încărcare vine imediat după <meta charset>. Pe Luma, configurația RequireJS inline a Magento se află deasupra lui; aceasta nu încarcă nimic.
2. Cu legătura activată: înainte de orice alegere într-o regiune opt-in, cookie-ul user_allowed_save_cookie nu este setat; după acceptarea unei categorii, este setat pentru website-ul dumneavoastră.
3. Paginile rămân posibil de păstrat în cache: rezultatul nu conține date specifice vizitatorului.

Content Security Policy

Modulul permite https://api.consentl.com în lista albă CSP a Magento și nu afișează JavaScript inline, așa că funcționează cu CSP-ul în modul restrict al paginii de finalizare a comenzii din 2.4.7+ și cu temele Hyvä CSP.

Pentru dezvoltatori

Consentl\Consent\ViewModel\Consent::allows('marketing') citește cookie-ul consentl, doar pentru contexte care nu sunt în cache (finalizarea comenzii, contul clientului, AJAX). Pe paginile din cache, condiționați etichetele în HTML cu <script type="text/plain" data-consentl="marketing">…</script>.

Limitări

• Scripturile pe care o altă extensie le afișează deasupra <meta charset> sau scripturile inline plasate de o temă înaintea conținutului head rulează înaintea Consentl.
• Magento_GoogleTagManager din Adobe Commerce (cod sursă închis) nu a fost verificat cu legătura. Folosiți Consent Mode (Pro și planurile superioare, activat din panoul de control): Consentl setează valorile implicite și actualizările, iar etichetele GTM le respectă.
• Magento are un singur indicator de opt-in, așa că legătura îl setează atunci când este acordată oricare categorie opțională.
• Pe Hyvä, dacă notificarea de cookie-uri proprie Hyvä apare în continuare, eliminați-o din temă cu <referenceBlock name="cookie_notices" remove="true"/> în Magento_Cookie/layout/default.xml.
• Dezinstalarea lasă valorile de configurare din consentl/* în core_config_data; ștergeți-le cu bin/magento config:delete, dacă este necesar.

Ghiduri conexe

• Shopware 6
• PrestaShop
• Google Tag Manager

V-ați blocat? Scrieți-ne la support@consentl.com — răspundem în limba engleză, în zilele lucrătoare.