Consentl

Consentl dla WordPress

Zainstaluj wtyczkę Consentl, kliknij Połącz, a baner ładuje się jako pierwszy w <head>. Działa z WP Consent API, pamięcią podręczną stron, WPML, Polylang i motywami.

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

Wtyczka Consentl przechowuje klucz witryny, wstawia skrypt ładujący Consentl jako pierwszy element <head>, przekazuje każdy wybór do WP Consent API i WooCommerce oraz dodaje bloki i shortcode'y dla deklaracji plików cookie, formularza wniosku dotyczącego danych osobowych i unijnego formularza odstąpienia od umowy. Sam baner, jego teksty i regiony są zarządzane w panelu Consentl.

Wymagania

  • WordPress 6.5 lub nowszy, PHP 7.4 lub nowszy.
  • Konto Consentl (dostępny jest plan Free).
  • Opcjonalnie: wtyczka WP Consent API (2.0+), WooCommerce 8.5+.

Instalacja

  1. Należy pobrać plik zip wtyczki ze strony Pobieranie. Po opublikowaniu w WordPress.org będzie dostępna również tam.
  2. W WordPress należy przejść do Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer, wybrać plik zip, kliknąć Zainstaluj i Włącz.
  3. Jeżeli korzystają Państwo z pamięci podręcznej stron, należy ją wyczyścić.

Aktualizacje

Od wersji 1.1.0 wtyczka sprawdza nowe wersje w consentl.com, dzięki czemu pojawiają się one w Kokpit → Aktualizacje i na ekranie Wtyczki jak każda inna aktualizacja, z opcją Zobacz szczegóły, aktualizacją jednym kliknięciem i automatycznymi aktualizacjami (również w panelu administracyjnym sieci multisite). WordPress sprawdza aktualizacje mniej więcej dwa razy dziennie; Sprawdź ponownie w Kokpit → Aktualizacje sprawdza od razu. Sprawdzenie nie wysyła klucza witryny, adresu witryny ani danych odwiedzających. Jeżeli zainstalowali Państwo wersję 1.0.0, należy raz wysłać nowy plik zip (Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer, a następnie Zastąp obecną wersję wysłaną); kolejne wersje będą pojawiać się same.

Jeżeli serwer blokuje połączenia wychodzące (WP_HTTP_BLOCK_EXTERNAL), należy zezwolić na consentl.com obok api.wordpress.org w WP_ACCESSIBLE_HOSTS albo nadal ręcznie wysyłać nowe pliki zip. Aby wyłączyć sprawdzanie aktualizacji, należy dodać define( 'CONSENTL_SELF_UPDATE', false ); do wp-config.php.

Połączenie witryny

  1. Należy przejść do Ustawienia → Consentl i kliknąć Connect to Consentl.
  2. Należy się zalogować lub założyć bezpłatne konto, a następnie wybrać lub utworzyć witrynę. Nastąpi powrót do WordPress z uzupełnionym kluczem witryny, a status będzie pokazywał Connected.

Można też wkleić klucz (zaczyna się od sk_) z panelu. Aby przypisać go na stałe do danego środowiska, należy dodać ten wiersz do wp-config.php; pole stanie się wtedy tylko do odczytu:

define( 'CONSENTL_SITE_KEY', 'sk_…' );

Konfiguracja

W Ustawienia → Consentl:

  • Banner language (język banera): Automatic (domyślnie) stosuje język strony z WPML lub Polylang albo ustawienia regionalne WordPress. Site language używa języka z Ustawienia → Ogólne. Fixed używa jednego języka dla wszystkich stron.
  • WP Consent API (domyślnie włączone): wtyczki zgodne z WP Consent API (na przykład Site Kit by Google, WooCommerce, WP Statistics, Burst Statistics) automatycznie otrzymują wybór odwiedzającego.
  • Open the Consentl dashboard otwiera panel z projektem banera, tekstami, regionami, plikami cookie, rejestrem zgód i wnioskami dotyczącymi danych osobowych. Zmiany pojawiają się w witrynie w ciągu około pięciu minut.

Następnie na stronie polityki prywatności lub polityki plików cookie należy dodać:

Blok Shortcode
Deklaracja plików cookie [consentl_cookie_declaration heading="Cookies we use"]
Formularz wniosku dotyczącego danych osobowych [consentl_privacy_request]
Unijny formularz odstąpienia od umowy (plan Pro i wyższe) [consentl_withdrawal_form]
Link do ustawień plików cookie [consentl_cookie_settings label="Cookie settings"]

W menu należy dodać własny odnośnik do #consentl, aby można było ponownie otworzyć preferencje.

Sprawdzenie działania

  1. Należy otworzyć witrynę w oknie prywatnym i wyświetlić źródło strony: skrypt ładujący Consentl jest pierwszym <script> w <head>, zaraz po <meta charset>.
  2. Pojawia się baner. W konsoli przeglądarki Consentl.get() pokazuje bieżące wybory.
  3. Przy zainstalowanym WP Consent API wp_has_consent('statistics') ma wartość false przed akceptacją analityki w regionie opt-in i true po niej.

Wtyczki pamięci podręcznej i optymalizacji

Kod HTML strony jest taki sam dla każdego odwiedzającego, a każdy wybór jest stosowany w przeglądarce, więc buforowanie całych stron jest bezpieczne. Skrypt ładujący jest automatycznie wyłączany z odraczania, opóźniania i łączenia w WP Rocket, LiteSpeed Cache, Autoptimize, SiteGround Speed Optimizer, Jetpack Boost i Cloudflare Rocket Loader. W innych wtyczkach optymalizacyjnych (Perfmatters, FlyingPress, WP-Optimize, Hummingbird, NitroPack itp.) należy wyłączyć /v1/loader.js z opcji „delay JS”, „defer JS” i „combine JS”.

Dla programistów

  • consentl_has_consent( 'analytics' ) zwraca true, gdy odwiedzający zezwolił na daną kategorię (necessary, preferences, analytics, marketing lub sale). Odczytuje plik cookie consentl; nie należy go używać we fragmentach buforowanych dla całej strony.
  • consentl_get_consent() zwraca zapisaną decyzję lub null.
  • consentl_loader_tag() pozwala samodzielnie wstawić skrypt ładujący w motywach, które wyświetlają skrypty przed wp_head() (na przykład fragment kodu Google Tag Manager wklejony bezpośrednio po <head>).
  • JavaScript: Consentl.get(), Consentl.allowed('marketing'), Consentl.on('change', fn), Consentl.open('prefs') i zdarzenie consentl:change na document.
  • Filtry: consentl_should_load, consentl_loader_attributes, consentl_head_priority, consentl_locale, consentl_has_consent, consentl_woocommerce_attribution_client_side, consentl_api_origin, consentl_app_origin.

Ograniczenia

  • Nie należy używać dwóch wtyczek zgód jednocześnie: Complianz, CookieYes, Cookiebot i podobne wtyczki również odpowiadają na WP Consent API i powodowałyby konflikt. Drugą wtyczkę należy wyłączyć.
  • Strony AMP nie ładują banera (AMP wymaga amp-consent, które nie jest obsługiwane).
  • Skrypty wstawiane przez motyw przed wp_head() uruchamiają się przed Consentl; należy użyć consentl_loader_tag() w sposób opisany powyżej.
  • Przy Content Security Policy należy zezwolić na https://api.consentl.com dla script-src i connect-src (zob. Każda strona internetowa).
  • W sieci multisite każda witryna potrzebuje własnego klucza witryny.
  • Po usunięciu wtyczki jej ustawienia są usuwane. Rejestr zgód pozostaje na Państwa koncie Consentl, ponieważ stanowi Państwa dowód zgody.

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