Consentl

Consentl dla Shopware 6

Wtyczka Consentl dla Shopware 6.6 i 6.7 umieszcza baner jako pierwszy w <head>, zastępuje pasek cookie Shopware i synchronizuje grupy plików cookie z każdym wyborem.

Skrypt ładujący jako pierwszy w <head>
Tak
Pobierz
consentl-shopware-1.1.1.zip · Wersja 1.1.1 · 164 KB · SHA-256

Wtyczka Consentl łączy sklep Shopware z Consentl. Przechowuje klucz witryny dla każdego kanału sprzedaży, wstawia skrypt ładujący jako pierwszy element <head>, zastępuje pasek cookie Shopware i przekazuje każdy wybór do grup plików cookie Shopware, dzięki czemu lista życzeń, elementy YouTube, Google Analytics i inne funkcje się do niego stosują. Teksty, kolory, regiony i zapisy zgód są zarządzane w panelu Consentl.

Wymagania

  • Shopware 6.6 lub 6.7, PHP 8.2 lub nowszy.
  • Konto Consentl (dostępny jest plan Free).

Instalacja

Z pliku zip (Pobieranie):

  1. W panelu administracyjnym należy przejść do Extensions → My extensions → Upload extension i wybrać plik zip albo uruchomić na serwerze:
bin/console plugin:zip-import consentl-shopware-<version>.zip
bin/console plugin:install --activate ConsentlConsent
bin/console cache:clear
  1. Należy zainstalować i aktywować Consentl, a następnie wyczyścić pamięć podręczną.

Skrypt sklepu wtyczki jest kopiowany do public/bundles/consentlconsent/ podczas aktywacji; jeżeli wdrażają Państwo bez cyklu życia wtyczki, należy uruchomić bin/console assets:install.

Połączenie witryny

Należy otworzyć Extensions → My extensions → Consentl → Configure. Ustawienia obowiązują dla każdego kanału sprzedaży i są dziedziczone z „All Sales Channels”.

  • Connect with Consentl loguje Państwa, pozwala wybrać lub utworzyć witrynę i zapisuje klucz dla wybranego kanału sprzedaży.
  • Można też wkleić klucz witryny (sk_ + 24 znaki) z panelu i zapisać.

Konfiguracja

Ustawienie Domyślnie Uwagi
Show the Consentl banner (wyświetlanie banera Consentl) wł. Wył. = skrypt ładujący nie jest wstawiany; klucz zostaje zachowany
Replace the Shopware cookie bar (zastąpienie paska cookie Shopware) wł. Ukrywa pasek cookie i okno ustawień plików cookie Shopware
Sync consent with Shopware cookie groups (synchronizacja z grupami plików cookie) wł. Zob. poniżej
Category for unknown cookie groups (kategoria dla nieznanych grup) Marketing Dla grup dodanych przez inne rozszerzenia, których nie da się dopasować
Banner language (język banera) Automatic Język domeny kanału sprzedaży (de-AT → de)

Grupy plików cookie. Grupy Shopware odpowiadają kategoriom Consentl: technically required → ściśle niezbędne, comfort features → preferencje, statistics → analityczne, marketing → marketingowe. Pozostałe grupy są dopasowywane według słów kluczowych lub otrzymują kategorię zastępczą. Gdy odwiedzający podejmie decyzję, wtyczka zapisuje te same pliki cookie, które zapisałby sam Shopware (wishlist-enabled, youtube-video, google-analytics-enabled, …), i ogłasza zmianę, dzięki czemu rozszerzenia nasłuchujące zmian zgody reagują bez przeładowania. Linki do ustawień plików cookie Shopware otwierają preferencje Consentl.

Widżety. Blok Shopping Experiences Consentl (kategoria Text) z elementami cookie declaration (deklaracja plików cookie), privacy request form (formularz wniosku dotyczącego danych osobowych) i withdrawal form (formularz odstąpienia od umowy). W motywach można też użyć dołączeń Twig:

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

consentlType może mieć wartość declaration, request lub withdrawal.

Sprawdzenie działania

  1. Należy wyświetlić źródło strony sklepu: <head> zaczyna się od <script src="https://api.consentl.com/v1/loader.js?k=…&l=de">.
  2. Pasek cookie Shopware już się nie pojawia; pojawia się baner Consentl.
  3. Odrzucenie wszystkich: pliki cookie google-analytics-enabled, wishlist-enabled i youtube-video nie są ustawiane, a Google Analytics się nie ładuje. Akceptacja analityki: google-analytics-enabled=1 jest ustawiane bez przeładowania.

Dla programistów

W Twig {% if consentl_allowed('marketing') %}…{% endif %} sprawdza zapisaną decyzję. Widzi tylko plik cookie consentl (a nie domyślne wartości regionu) i jest oceniane podczas renderowania strony, więc strony z pamięci podręcznej HTTP Shopware nie są ponownie oceniane. Lepiej stosować blokowanie po stronie klienta: <script type="text/plain" data-consentl="analytics">…</script>.

Ograniczenia

  • „Keep Shopware cookie bar” (zastępowanie wyłączone) uruchamia dwa interfejsy zgody; należy używać tej opcji tylko w okresie przejściowym.
  • Shopware 6.7 zawiera własny formularz odstąpienia od umowy (revocation). Należy używać albo formularza Shopware, albo formularza Consentl, nie obu jednocześnie.
  • Proces Connect używa hosta panelu administracyjnego jako domeny; jeżeli domeny sklepu są inne, należy dodać je w panelu Consentl.

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