Consentl

Consentl dla Magento 2 / Adobe Commerce

Moduł Consentl dla Magento i Adobe Commerce od 2.4.6 do 2.4.8: skrypt ładujący zaraz po <meta charset>, połączenie z Cookie Restriction Mode i widżety CMS. Luma i Hyvä.

Skrypt ładujący jako pierwszy w <head>
Tak
Pobierz
consentl-module-consent-1.1.0.zip · Wersja 1.1.0 · 201 KB · SHA-256

Moduł consentl/module-consent łączy sklep Magento z Consentl. Przechowuje klucz witryny dla każdej witryny (website) lub widoku sklepu (store view), wstawia skrypt ładujący bezpośrednio po <meta charset>, przekazuje każdy wybór do trybu Cookie Restriction Mode Magento i udostępnia widżety CMS. Projekt banera, teksty w 34 językach, reguły regionów i reguły blokowania są zarządzane w panelu Consentl.

Wymagania

  • Magento Open Source lub Adobe Commerce 2.4.6, 2.4.7 lub 2.4.8; PHP od 8.1 do 8.4, w zakresie obsługiwanym przez daną wersję Magento.
  • Motywy Luma lub Hyvä; obsługiwane są wbudowany Full Page Cache i Varnish.
  • Konto Consentl (dostępny jest plan Free).

Instalacja

Z pliku zip (Pobieranie): należy rozpakować go do app/code/Consentl/Consent/, tak aby composer.json znajdował się na najwyższym poziomie tego folderu, a następnie uruchomić:

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

Przez Composer: composer require consentl/module-consent po opublikowaniu pakietu, a następnie te same polecenia.

Połączenie witryny

Należy przejść do Stores → Configuration → Consentl → Cookie Consent i najpierw wybrać zakres (klucz i język mogą się różnić dla poszczególnych witryn lub widoków sklepu).

  • Connect to Consentl loguje Państwa lub zakłada bezpłatne konto, pozwala wybrać lub utworzyć witrynę dla domeny tego sklepu i przenosi z powrotem z zapisanym Site key i włączonym Consentl. Link powrotny jest ważny tylko w tej samej sesji panelu administracyjnego.
  • Można też wkleić klucz (sk_ + 24 znaki) i ustawić Enable Consentl na Yes.

Jeżeli konfiguracja nie robi tego automatycznie, po zapisaniu należy wyczyścić Full Page Cache.

Konfiguracja

  • Banner language (język banera): Automatic przypisuje ustawienia regionalne widoku sklepu do najbliższego języka Consentl (de_AT → de, pt_BR → pt-BR, nb_NO → nb). Można też wymusić konkretny język.
  • Połączenie z Cookie Restriction Mode (zalecane, jeżeli korzystają Państwo z modułów Google Analytics lub Google Tag Magento):
    1. Należy ustawić Stores → Configuration → General → Web → Default Cookie Settings → Cookie Restriction Mode na Yes.
    2. Należy ustawić Sync Consentl decisions to Cookie Restriction Mode na Yes.
    3. Należy ustawić Hide Magento's native cookie notice na Yes.
    4. Opcjonalnie: Reload the page after the first opt-in, aby moduły Google w Luma uruchamiały się przy tym samym wyświetleniu strony, a nie przy następnym.
  • Advanced: należy pozostawić położenie skryptu ładującego First element in <head>.

Widżety CMS (Content → Pages / Blocks → Insert Widget):

Widżet Dyrektywa
Deklaracja plików cookie {{widget type="Consentl\Consent\Block\Widget\CookieDeclaration"}}
Formularz wniosku dotyczącego danych osobowych {{widget type="Consentl\Consent\Block\Widget\PrivacyRequest"}}
Unijny formularz odstąpienia od umowy {{widget type="Consentl\Consent\Block\Widget\Withdrawal"}}
Link do ustawień plików cookie {{widget type="Consentl\Consent\Block\Widget\PreferencesLink" label="Cookie settings"}}

Każdy <a href="#consentl">…</a> w bloku CMS również ponownie otwiera preferencje.

Sprawdzenie działania

  1. Należy wyświetlić źródło strony: skrypt ładujący znajduje się bezpośrednio po <meta charset>. W Luma powyżej znajduje się wbudowana konfiguracja RequireJS Magento; nie ładuje ona niczego.
  2. Przy włączonym połączeniu: przed jakimkolwiek wyborem w regionie opt-in plik cookie user_allowed_save_cookie nie jest ustawiony; po akceptacji kategorii jest ustawiany dla Państwa witryny.
  3. Strony pozostają buforowalne: wynik nie zawiera danych specyficznych dla odwiedzającego.

Content Security Policy

Moduł dodaje https://api.consentl.com do białej listy CSP Magento i nie wstawia wbudowanego kodu JavaScript, dzięki czemu działa z CSP w trybie restrict na stronie zamówienia w wersji 2.4.7+ i z motywami Hyvä CSP.

Dla programistów

Consentl\Consent\ViewModel\Consent::allows('marketing') odczytuje plik cookie consentl, wyłącznie w kontekstach niebuforowanych (strona zamówienia, konto klienta, AJAX). Na stronach buforowanych tagi w HTML należy warunkować za pomocą <script type="text/plain" data-consentl="marketing">…</script>.

Ograniczenia

  • Skrypty, które inne rozszerzenie wstawia powyżej <meta charset>, lub wbudowane skrypty, które motyw umieszcza przed zawartością sekcji head, uruchamiają się przed Consentl.
  • Magento_GoogleTagManager w Adobe Commerce (kod zamknięty) nie został zweryfikowany z połączeniem. Należy użyć Consent Mode (plan Pro i wyższe, włączany w panelu): Consentl ustawia wartości domyślne i aktualizacje, a tagi GTM się do nich stosują.
  • Magento ma jedną flagę opt-in, więc połączenie ustawia ją, gdy udzielono zgody na dowolną opcjonalną kategorię.
  • Jeżeli w Hyvä nadal pojawia się własna informacja o plikach cookie Hyvä, należy usunąć ją w motywie za pomocą <referenceBlock name="cookie_notices" remove="true"/> w Magento_Cookie/layout/default.xml.
  • Odinstalowanie pozostawia wartości konfiguracji w consentl/* w core_config_data; w razie potrzeby można je usunąć za pomocą bin/magento config:delete.

Potrzebują Państwo pomocy? Prosimy pisać na adres support@consentl.com — odpowiadamy po angielsku w dni robocze.