Instrukcja o wtyczce "Zgoda na pliki cookie (RODO)"

Konfiguracja wtyczki „Zgoda na pliki cookie (RODO)”

Krok 1. Instalacja i włączenie

1. Zainstaluj wtyczkę przez Instalator.
2. Przejdź do: aplikacja „Witryna” → „Wtyczki” → „Zgoda na pliki cookie (RODO)”.
3. Przełącznik „Włącz/Wyłącz” ustaw w pozycji „Włączony” i kliknij „Zapisz”.

Baner pojawi się na stronie nie od razu po zapisaniu, lecz przy pierwszym wejściu odwiedzającego na stronę i przewinięciu jej. Sprawdzaj go w trybie incognito przeglądarki - jeśli udzieliłeś już zgody wcześniej, okno nie pokaże się ponownie (zobacz krok 8).

Krok 2. Zakładka „Ogólne”: podstawowe zachowanie

Pozycja banera.

Pole „Wyświetlić komunikat” określa położenie na ekranie: „W lewym dolnym rogu (tryb kompaktowy)” lub „W prawym dolnym rogu (tryb kompaktowy)”.

Czas życia cookie (dni).

Jeden z najważniejszych parametrów. To okres, na jaki zapamiętywana jest zgoda odwiedzającego (domyślnie 180 dni). Po upływie tego terminu baner pojawi się temu odwiedzającemu ponownie. Nie ustawiaj zbyt długiego okresu: zgoda na przetwarzanie danych osobowych powinna być okresowo potwierdzana.

Ikona zarządzania cookies.

• „Kolor ikony” i „Tło ikony” - wygląd okrągłego przycisku na stronie;
• „Odstęp z boku (px)” i „Odstęp od dołu (px)” - położenie przycisku względem krawędzi ekranu.

Kliknięcie ikony otwiera okno „Ustawienia plików cookie” - tam odwiedzający może w każdej chwili zmienić swój wybór.

Ustawienia dla wersji mobilnej.

Blok „Ustawienia dla wersji mobilnej” powtarza te same pola dla smartfonów: „Wyjście na mobilnej wersji strony”, „Pozycja ikony (mobile)” oraz osobne odstępy „Odstęp z boku (px) mobile” i „Odstęp od dołu (px) mobile”. Sprawdź pozycję przycisku na realnym ekranie telefonu - nie powinien zasłaniać koszyka ani innych elementów.

Krok 3. Zakładka „Baner”: teksty i wygląd

Języki banera: wypełnianie tekstów w wielu językach.

W górnej części zakładki znajduje się blok „Języki banera” - lista języków witryny z przełącznikami. Zaznaczone języki określają, dla jakich wersji językowych witryny baner będzie miał własne teksty. Jeśli nie zaznaczysz żadnego języka, baner będzie aktywny dla wszystkich języków witryny.

Poniżej dla każdego języka wyświetla się osobna, rozwijana grupa pól (nagłówek grupy to identyfikator języka, np. pl_PL). Wypełnij ją oddzielnie dla każdego włączonego języka:

• „Nagłówek” - np. „Używamy plików cookie”;
• „Wiadomość” - wyjaśnienie, jakie pliki cookie są używane i w jakim celu. To właśnie tutaj etyka i poprawność prawna mają największe znaczenie: wymień kategorie uczciwie;
• „Przycisk akceptacji” - zgoda na wszystkie kategorie od razu;
• „Przycisk odrzucenia” - odmowa zgody na kategorie opcjonalne;
• „Przycisk dostosowania” - otwiera okno „Ustawienia plików cookie”, w którym odwiedzający sam zaznacza kategorie, a następnie zatwierdza wybór.

Teksty banera wyświetlają się w języku wersji językowej, którą przegląda odwiedzający. Jeśli włączysz więcej niż jeden język banera, w oknie „Ustawienia plików cookie” pojawi się lista rozwijana języków (ikona globusa z flagami). Wybór języka natychmiast zmienia teksty banera i jest zapamiętywany w osobnym pliku cookie (nazwa głównego pliku cookie z przyrostkiem _locale), również na 180 dni - kolejne wizyty pokażą baner w wybranym języku.

Wygląd okna.

„Tło okna”, „Kolor tekstu w oknie”, „Kolor linków w oknie” oraz przełącznik „Dodaj krzyżyk do zamknięcia”. Zamknięcie krzyżykiem nie zapisuje zgody - baner pojawi się ponownie przy kolejnym wejściu.

Szablon wiadomości (dla zaawansowanych).

Pole „Szablon wiadomości” - to szablon HTML+Smarty banera ze zmiennymi (, , i innymi; pełna lista jest wyświetlona pod nazwą pola). Pozwala całkowicie przepisać strukturę banera.

Nie zmieniaj szablonu bez znajomości Smarty: błąd składni zepsuje wyświetlanie banera na całej stronie. Jeśli coś pójdzie nie tak - link „przywróć oryginał” pod edytorem przywróci szablon domyślny.

Krok 4. Zakładka „Kategorie”: co zobaczy odwiedzający

Cookies niezbędne (techniczne).

Blok „Niezbędne”: tytuł kategorii. Takie pliki cookie są potrzebne stronie do działania, a odwiedzający nie może ich wyłączyć - w oknie „Ustawienia plików cookie” ich przełącznik jest na stałe zaznaczony. Same skrypty powinny być zapisane w szablonie graficznym, z którego korzystasz (zwykle jest to plik index.html). Wtyczka nie ma związku z takimi skryptami i wyświetla jedynie część wizualną w banerze, że takie pliki cookie są obecne.

Kategorie opcjonalne 1-7.

W górnej części zakładki znajdują się przełączniki „Kategorie opcjonalne” - „Kategoria opcjonalna” 1-7: które kategorie pokazywać odwiedzającemu. Domyślne tytuły odpowiadają typowym grupom: „Preferencje”, „Funkcjonalność”, „Targetowanie”, „Marketing”, „Analityka”, „Wydajność”, „Nieklasyfikowane” - możesz je zmienić na własne.

Tytuły kategorii ustawiasz osobno dla każdego języka banera. W rozwijanej grupie każdego języka wypełnij:

• „Niezbędne” - tytuł kategorii niezbędnej widoczny w oknie „Ustawienia plików cookie”;
• „Kategoria opcjonalna” 1-7 - tytuły kategorii opcjonalnych, np. „Analityka”, „Marketing”.

Nieużywane kategorie po prostu wyłącz przełącznikiem - nie pojawią się w oknie ustawień ani nie będą wymagane.

Krok 5. Zakładka „Polityka”: ponowne zgody

Technicznie najważniejsza zakładka - to właśnie te pola decydują o tym, kiedy odwiedzający zobaczy baner ponownie.

Nazwa pliku cookie.

Nazwa technicznego pliku cookie, w którym przechowywana jest zgoda odwiedzającego. Nie zmieniaj jej bez konieczności: po zmianie nazwy wszyscy odwiedzający zostaną „zapomniani” i zobaczą baner od nowa.

Wersja polityki.

Kluczowy mechanizm ponownych zgód. Zmieniłeś tekst polityki cookies, zestaw liczników lub zakres przetwarzanych danych - podnieś wersję (np. z 1 na 1.1). Wszystkie zapisane zgody przestaną być uznawane za aktualne, a baner automatycznie pokaże się każdemu odwiedzającemu od nowa.

To standardowy sposób „ponownego zapytania” o zgodę całej audiencji. Nie musisz dotykać nazwy pliku cookie ani czasu jego życia - wystarczy zwiększyć wersję polityki.

Nazwy i URL polityk: wypełnianie w wielu językach.

Tytuły i adresy dokumentów ustawiasz osobno dla każdego języka banera. W rozwijanej grupie każdego języka wypełnij pola: „Nazwa polityki prywatności”, „URL polityki prywatności”, „Nazwa polityki plików cookie” i „URL polityki plików cookie”. Podpisy i linki zostaną wstawione do tekstu banera w języku, którym posługuje się odwiedzający. Wypełnij je: linki do polityk są obowiązkowym wymogiem przy zbieraniu zgód zgodnie z GDPR (RODO).

Krok 6. Zakładka „Skrypty”: liczniki i piksele

Skrypty kategorii opcjonalnej 1-7.

Pola „Skrypty kategorii opcjonalnej 1” ... „Skrypty kategorii opcjonalnej 7” odpowiadają kategoriom z zakładki „Kategorie” (pola wspólne dla wszystkich języków). Do każdego pola wstaw kod licznika należący do danej kategorii. Skrypt wykona się tylko wtedy, gdy odwiedzający włączył (zaakceptował) tę kategorię.

• Kod Google Tag Manager → pole kategorii „Analityka”;
• Piksele sieci reklamowych (Facebook, Google Ads itp.) → kategoria „Marketing”;
• Fragmenty kodu Google (GA4, Google Ads) → własne kategorie, zobacz niżej o Consent Mode.

Do momentu wyboru odwiedzającego nic z tych pól nie jest wykonywane - to właśnie ochrona zgodna z GDPR (RODO). Nie wstawiaj tutaj skryptów krytycznych dla działania strony (koszyk, płatności): bez zgody się nie uruchomią.

Google Consent Mode.

Dwie listy rozwijane sterują sygnałami Google Consent Mode:

• „Google Consent Mode (kategoria analityki)” - dla sygnałów analitycznych GA4;
• „Google Consent Mode (kategoria marketingu)” - dla sygnałów marketingowych i reklamowych Google Ads.

W obu listach wybierasz jedną z kategorii opcjonalnych 1-7 albo opcję „Wyłączone”. Jak to działa: wtyczka wysyła do dataLayer sygnał gtag('consent', 'default', denied) przy ładowaniu strony, a po wyborze odwiedzającego - sygnał gtag('consent', 'update'). Do zaakceptowania wybranej kategorii tagi Google nie zbierają danych i nie zapisują plików cookie; same fragmenty kodu Google nadal ładują się dopiero po zgodzie.

Ważne: wybierz tę samą kategorię, do której pola wstawiłeś fragment kodu Google. Sama konfiguracja Consent Mode nie dodaje licznika na stronę - fragment GA4/Google Ads i tak trzeba wstawić do pola „Skrypty kategorii opcjonalnej” powyżej.

Dodatkowe style.

Pole „Dodatkowe style” - kod CSS (automatycznie opakowywany w znaczniki <style>) do precyzyjnego dopasowania wyglądu banera do szablonu graficznego strony.

Podłączanie JS i CSS wtyczki.

Przełączniki „Podłączyć JS wtyczki” i „Podłączyć CSS wtyczki” pozostaw włączone. Wyłączaj je tylko wtedy, gdy podłączasz pliki wtyczki samodzielnie w swoim szablonie graficznym.

Krok 7. Zakładka „Dziennik”: dowody zgód

Dziennik rejestruje, kto i kiedy udzielił zgody oraz na jaką wersję polityki - to argument podczas kontroli zgodności z GDPR (RODO).

• „Włącz dziennik zgód” - włącz, jeśli polityka strony wymaga przechowywania dowodów zgód;
• „Okres przechowywania dziennika (dni)” - domyślnie 180. Ustaw wartość nie mniejszą niż czas życia cookie, inaczej wpisy znikną wcześniej niż upłynie zgoda;
• „Anonimizuj IP” - zalecamy pozostawienie tej opcji włączonej: adres przechowywany jest w postaci skróconej;
• „Przechowuj User-Agent” - domyślnie wyłączone, ponieważ User-Agent zalicza się do danych osobowych. Włączaj tylko przy świadomej potrzebie.

Przy włączonym dzienniku wspomnij o przechowywaniu wpisów o zgodzie w tekście polityki prywatności - wtyczka przypomina o tym bezpośrednio na zakładce.

Przegląd i eksport.

Blok „Filtr dziennika”: daty („Data od” / „Data do”), „Wersja polityki”, „Działanie”, „Domena” oraz liczba wierszy „Na stronę” (od 10 do 1000). Przycisk „Zastosuj filtr” ogranicza listę, „Resetuj” czyści filtry, a „Eksport CSV” pobiera odfiltrowane wpisy do pliku - wygodnie dołączyć je do odpowiedzi na zapytanie organu nadzoru lub skargi odwiedzającego.

Tabela wpisów jest szersza niż w pokrewnych wtyczkach i może liczyć do 17 kolumn: ID, „Data”, „Wersja polityki”, „Działanie”, po jednej kolumnie dla każdej włączonej kategorii opcjonalnej (do 7 kolumn, wartości 1/0), „Kontakt”, „Sesja”, IP, User-Agent, „Domena” oraz „Lokalizacja” - język, w którym udzielono zgody. Nad tabelą wyświetlana jest informacja „Rozmiar dziennika”, a pod nią - paginacja („Wstecz” / „Dalej”).

Krok 8. Sprawdzenie działania

1. Otwórz stronę w trybie incognito i zacznij przewijać - na dole powinien pojawić się baner z Twoimi tekstami.
2. Kliknij „Dostosuj”: kategorie powinny nazywać się tak, jak je ustawiłeś, a „Niezbędne” - być na stałe zaznaczone.
3. Jeśli włączyłeś kilka języków banera - sprawdź listę języków (ikona globusa) w oknie „Ustawienia plików cookie”: po wyborze języka wszystkie teksty banera powinny zmienić się natychmiast.
4. Kliknij „Odrzuć wszystkie”, a następnie w DevTools (F12 → zakładka Network) odśwież stronę: nie powinno być żądań do googletagmanager.com.
5. Otwórz ponownie „Ustawienia plików cookie” (ikona na stronie), włącz kategorie i zatwierdź: liczniki powinny pojawić się w Network, a w cookies strony - plik o ustawionej nazwie.
6. Odśwież stronę - baner nie pokazuje się już ponownie, wybór jest zapamiętany; ikona zarządzania pozostała na swoim miejscu.
7. Podnieś wersję polityki o jeden, zapisz i odśwież stronę - baner powinien pokazać się ponownie. Po sprawdzeniu przywróć poprzednią wersję.

Jeśli baner się nie pojawia - sprawdź: czy wtyczka jest włączona, czy włączona jest wersja mobilna (jeśli sprawdzasz na smartfonie) oraz czy w przeglądarce nie pozostała ważna zgoda z poprzednich testów. Testuj zawsze w czystym oknie incognito.