Cookie Manager Tarteaucitron — Kompletny przewodnik
Instalacja, kreator, automatyczne blokowanie skryptów zewnętrznych, lista plików cookie, katalog usług, wygląd, Google Consent Mode v2, analiza, statystyki i dowód zgód modułu Cookie Manager (tarteaucitron.js) dla PrestaShop 1.7.8, 8 i 9.
Prezentacja
Cookie Manager to moduł do zarządzania zgodą na pliki cookie dla PrestaShop 1.7.8, 8 i 9, zgodny z motywami Classic i Hummingbird. Opiera się na tarteaucitron.js 1.37.0, bibliotece open source autorstwa Amauriego Champeaux (licencja MIT). Moduł dodaje do niej własny baner, automatyczne blokowanie skryptów zewnętrznych, listę plików cookie generowaną dla Twoich odwiedzających, Google Consent Mode v2 oraz rejestr stanowiący dowód zgód.
Dopóki odwiedzający niczego nie wybierze, moduł nie zapisuje żadnych plików cookie, niczego nie zapisuje w pamięci przeglądarki i nie łączy się z żadną stroną trzecią. Plik cookie zapamiętujący wybór jest zapisywany dopiero przy pierwszym kliknięciu.

Instalacja i kreator konfiguracji
- W panelu administracyjnym otwórz Moduły → Menedżer modułów → Załaduj moduł.
- Prześlij plik
datafirefly_tarteaucitron-3.0.0.zip, a następnie kliknij Konfiguruj. - Kreator otwiera się przy pierwszym wyświetleniu: polityka prywatności, używane narzędzia i ich identyfikatory, wygląd, włączenie banera.
Konfiguracja jest również dostępna z pozycji menu Moduły → Cookies (tarteaucitron). Kreator możesz uruchomić ponownie w dowolnym momencie przyciskiem Kreator u góry strony.

Aktualizacja z wersji 2.0 lub 1.x
Prześlij nowy plik zip w miejsce starego modułu. Skrypt aktualizacji przenosi Twoje ustawienia: usługi i identyfikatory, teksty, kolory, pozycję, okres przechowywania, Consent Mode, rejestr, statystyki i usługi niestandardowe.
- Wybór dokonany już przez Twoich odwiedzających w wersji 2.0 zostaje zachowany: baner nie jest im wyświetlany ponownie, chyba że dodasz usługę.
- Po aktualizacji automatyczne blokowanie pozostaje wyłączone. Włącz je w zakładce Blokowanie, a następnie przetestuj swoje strony.
- Przy aktualizacji z wersji 1.x pojedyncza wartość każdego tekstu jest kopiowana do wszystkich języków sklepu, a etykieta „Kontynuuj bez akceptacji” zmienia się na „Odrzuć wszystkie”.
W nowej instalacji automatyczne blokowanie jest włączone od początku.
Pulpit
Pulpit zbiera dwanaście kontroli konfiguracji: włączony baner, link do polityki prywatności, przyciski „Odrzuć wszystkie” i „Zaakceptuj wszystkie” o takim samym wyglądzie, okres przechowywania wyboru, sposób wycofania zgody, wartości domyślne Consent Mode, prawidłowe identyfikatory, pliki serwowane przez sklep, analiza skryptów zewnętrznych, automatyczne blokowanie, lista plików cookie dostępna dla odwiedzającego i rejestr stanowiący dowód zgód. Przy każdym niespełnionym punkcie znajduje się link Popraw prowadzący do właściwej zakładki.
Kontrole te odzwierciedlają dobre praktyki wynikające z zaleceń CNIL i EROD. Pomagają skonfigurować baner, ale nie zastępują analizy prawnej Twojej strony.

Usługi
Zakładka Usługi przedstawia zweryfikowany katalog: Google Analytics 4, Google Tag Manager, Google Ads, Meta Pixel, TikTok, LinkedIn Insight, Pinterest, Snap Pixel, Microsoft Advertising, Microsoft Clarity, Hotjar, Matomo, Plausible, HubSpot, YouTube, Vimeo, Google Maps, Intercom, Crisp, Tawk.to, Smartsupp i Stripe, a także dwa sygnały Google Consent Mode bez skryptu, przeznaczone dla tagu Google zainstalowanego przez inny moduł.
- Włącz tylko narzędzia faktycznie obecne w Twoim sklepie i wklej ich identyfikator: jego format jest sprawdzany podczas wpisywania, a następnie przy zapisywaniu. Nieprawidłowy identyfikator jest odrzucany, a usługa pozostaje wyłączona.
- Każdą usługę możesz przypisać do innej kategorii niż proponowana, na przykład Google Tag Manager do kategorii „Reklama”, jeśli Twój kontener zawiera głównie tagi reklamowe.
- Matomo i Plausible mogą zostać oznaczone jako zwolnione z obowiązku zgody wyłącznie wtedy, gdy konfiguracja narzędzia spełnia warunki CNIL dotyczące pomiaru ruchu.
- Stripe jest traktowany jako niezbędny do płatności: jest ładowany bez prośby o zgodę i wyświetlany wśród zawsze aktywnych plików cookie.
Usługi niestandardowe: dla narzędzia spoza katalogu dodaj usługę, podając jej nazwę, kategorię, politykę prywatności, pliki cookie oraz kod dostarczony przez narzędzie (łącznie z tagami <script>). Kod ten jest wykonywany dopiero po wyrażeniu przez odwiedzającego zgody na wybraną kategorię.

Biblioteka tarteaucitron.js: oprócz katalogu dostępnych jest 245 usług tarteaucitron.js 1.37.0. Wyszukaj usługę, dodaj ją, uzupełnij jej parametry i wybierz jej kategorię. Plik usługi jest pobierany przez odwiedzającego tylko wtedy, gdy usługa jest włączona i zaakceptowana.

Automatyczne blokowanie
Przed wysłaniem każdej strony moduł neutralizuje tagi <script> i elementy iframe rozpoznanych przez siebie usług zewnętrznych, niezależnie od tego, czy pochodzą z motywu, czy z innego modułu: 46 usług (usługi z katalogu i 24 inne popularne narzędzia śledzące) oraz Twoje własne reguły. Nic nie jest pobierane ani wykonywane, dopóki odwiedzający nie zaakceptuje odpowiedniej kategorii; następnie tagi są ponownie aktywowane w kolejności występowania w dokumencie.
- Dodatkowe reguły: jedna reguła w wierszu, w formacie
fragment adresu lub kodu | nazwa prezentowana odwiedzającemu | kategoria. Kategorie toanalytic,ads,socialifunctional. Przycisk „Blokuj” w analizie dodaje regułę za Ciebie. - Wyjątki: jeden fragment w wierszu; tag, którego adres lub kod go zawiera, nigdy nie jest blokowany. Możesz też dodać atrybut
data-dftac-ignoredo tagu w swoim motywie.
Blokowanie dotyczy tagów obecnych w kodzie strony. Skrypt ładowany przez inny skrypt (na przykład z pliku JavaScript jakiegoś modułu) w nim nie występuje: wyłącz go w tym module i zadeklaruj usługę tutaj. Skrypt, który używa document.write, może nie działać po ponownej aktywacji.
Google Tag Manager jest blokowany w całości do czasu wyrażenia zgody. Jeśli sterujesz nim za pomocą Consent Mode, dodaj googletagmanager.com/gtm.js do wyjątków.

Lista plików cookie
Zakładka Pliki cookie generuje listę plików cookie na podstawie włączonych usług, zablokowanych tagów i Twoich uzupełnień: kategoria, usługa, nazwa, okres przechowywania i cel. Lista jest aktualizowana przy każdym zapisie i wyświetlana w języku odwiedzającego.
- Dodatkowe pliki cookie: jeden plik cookie w wierszu, w formacie
nazwa | dostawca | okres przechowywania | cel | kategoria, dla plików cookie Twoich innych modułów lub w celu doprecyzowania okresu przechowywania. - Okres przechowywania jest podawany tylko wtedy, gdy został odnotowany w dokumentacji wydawcy (listopad 2026); „—” oznacza, że ustala go usługa.
Sprawdź tę listę przed jej opublikowaniem: opisuje ona usługi zadeklarowane w module, a nie te, które inny skrypt mógłby dodać bez Twojej wiedzy.

Po włączeniu opcji Opublikuj listę plików cookie (zakładka Zachowanie) tworzona jest strona publiczna, do której prowadzą linki z banera, okna preferencji i stopki.

Wygląd
Dostępnych jest sześć układów: szeroki baner na dole, karta w jednym z czterech rogów lub okno na środku. Domyślnie „Odrzuć wszystkie” i „Zaakceptuj wszystkie” mają ten sam kształt, rozmiar i kolor; dostępny jest też styl „obrys”. Styl wyróżniający „Zaakceptuj wszystkie” jest proponowany z ostrzeżeniem, ponieważ CNIL i EROD oceniają takie różnice indywidualnie, w każdym przypadku z osobna.
Kolory (przyciski, tekst przycisków, tło, tekst) mają gotowe palety i kontrolę kontrastu na żywo z progiem 4,5:1. Podgląd pokazuje prawdziwy baner, okno preferencji lub pływający przycisk, w szerokości komputera lub urządzenia mobilnego, w każdym języku, z jeszcze niezapisanymi ustawieniami.

Motyw i identyfikacja wizualna: motyw jasny, ciemny lub automatyczny (zgodnie z ustawieniem urządzenia odwiedzającego) z własnymi kolorami, ikona cookie lub logo sklepu, położenie pływającego przycisku, czcionka systemowa lub czcionka motywu oraz pole niestandardowego CSS, dodawanego po arkuszu stylów banera.

Teksty i języki
Teksty banera są dostarczane w językach francuskim, angielskim, hiszpańskim, niemieckim, włoskim, polskim, niderlandzkim i portugalskim. Komunikat proponowany domyślnie wymienia wyłącznie cele włączone w Twoim sklepie, po jednym wierszu na każdy cel, a następnie przypomina, że odmowa nie przeszkadza ani w przeglądaniu, ani w składaniu zamówień.
Zakładka Teksty pozwala zastąpić każdy tekst dla każdego języka osobno: tytuł, komunikat, etykiety przycisków oraz adresy polityki prywatności i polityki cookies. Pole pozostawione puste używa proponowanego tekstu. W komunikacie wiersz zaczynający się od myślnika staje się punktem listy. Strona CMS sklepu może również pełnić rolę polityki prywatności we wszystkich językach.
Zdanie „odmowa nie przeszkadza w składaniu zamówień” jest prawdziwe w przypadku katalogu modułu, w którym Stripe jest niezbędny. Jeśli obejmiesz wymogiem zgody którąś z metod płatności, dostosuj komunikat.

Zachowanie
- Okres przechowywania wyboru: domyślnie 183 dni (6 miesięcy, okres, który CNIL przedstawia jako dobrą praktykę), maksymalnie 365 dni. Dotyczy zarówno zgody, jak i odmowy.
- Ponownie poproś wszystkich o zgodę: po istotnej zmianie przycisk sprawia, że baner pojawia się ponownie u wszystkich odwiedzających. Dodana usługa jest w każdym przypadku proponowana odwiedzającym, którzy jeszcze jej nie widzieli.
- Wycofanie zgody: pływający przycisk, link „Zarządzaj plikami cookie” dodawany automatycznie w stopce, dowolny link do
#tarteaucitronlub wywołanie JavaScriptdftacOpenPreferences(). Po wycofaniu zgody pliki cookie usługi są usuwane, a strona jest ponownie ładowana. - Konto klienta: opcjonalnie wybór zalogowanego klienta jest odtwarzany na jego pozostałych urządzeniach. Jest uwzględniany w eksporcie i usuwaniu danych oficjalnego modułu RODO PrestaShop (psgdpr), jeśli jest on zainstalowany.
- Krzyżyk zamknięcia: opcjonalny, oznacza „Odrzuć wszystkie”.
- Baner ukryty, jeśli brak usług wymagających zgody: bez narzędzi śledzących wymagających kontroli baner nie jest potrzebny. Wyłącz tę opcję, jeśli zarządzasz skryptami poza modułem.
- Global Privacy Control: opcjonalnie przeglądarka wysyłająca ten sygnał jest traktowana jako odmowa.

Osadzone filmy i mapy: rozpoznane elementy iframe (YouTube, Vimeo, Google Maps, Dailymotion, Spotify…) są zastępowane symbolem zastępczym „Zezwól”, dostępnym z klawiatury. Platforma jest kontaktowana dopiero po wyrażeniu zgody przez odwiedzającego. Zezwolenie na pojedynczą treść z poziomu jej symbolu zastępczego nie oznacza zgody na pozostałą część kategorii.

Co widzi odwiedzający
Pierwszy ekran przedstawia tytuł, komunikat, link do polityki prywatności oraz przyciski „Odrzuć wszystkie”, „Zaakceptuj wszystkie” i „Dostosuj”. Okno preferencji wymienia cele, każdy z własnym przełącznikiem (domyślnie wyłączonym), usługi w każdej kategorii wraz z ich plikami cookie i okresem przechowywania oraz niezbędne pliki cookie, zawsze aktywne. Wyświetla także identyfikator zgody, który odwiedzający może Ci przekazać.

Na urządzeniach mobilnych przyciski zachowują ten sam rozmiar, każdy cel mieści się w jednym wierszu, a baner nie przesuwa strony.
Dostępność: prawdziwe pola wyboru ogłaszane jako przełączniki, okno preferencji utrzymujące fokus, zamykanie klawiszem Esc z przywróceniem fokusu, ograniczone animacje, jeśli odwiedzający tego zażądał. axe-core nie wykazał żadnych naruszeń (WCAG 2.1 A i AA) w banerze, preferencjach, zablokowanej treści i liście plików cookie, w motywie jasnym i ciemnym.

Google Consent Mode v2
Moduł deklaruje wartości domyślne na początku strony, przed jakimkolwiek tagiem Google: reklama, pomiar i personalizacja na denied, funkcjonalność i bezpieczeństwo na granted (z możliwością zmiany). Gdy tylko odwiedzający dokona wyboru, sygnały są aktualizowane zgodnie z zaakceptowanymi kategoriami:
- Pomiar ruchu →
analytics_storage; - Reklama →
ad_storage,ad_user_data,ad_personalization; - Filmy, mapy i media społecznościowe →
personalization_storage.
W przypadku odwiedzającego, który już odpowiedział, aktualizacja jest wysyłana na początku strony przy następnym wyświetleniu, bez czekania na pełne załadowanie. Opcje wait_for_update, ads_data_redaction i url_passthrough są konfigurowalne, a zdarzenie dftac_consent_update jest wysyłane do dataLayer na potrzeby Twoich reguł Google Tag Manager.

Analiza skryptów zewnętrznych
Przycisk Przeanalizuj mój sklep ładuje z serwera stronę główną, kategorię, produkt, stronę kontaktową i maksymalnie 8 wybranych przez Ciebie stron, jak nowy odwiedzający bez plików cookie. Wynik wymienia tagi zablokowane automatycznie, skrypty i treści zewnętrzne nadal ładowane przed wyborem (z przyciskiem Blokuj, który tworzy regułę), pliki cookie zapisywane przez serwer oraz zainstalowane moduły, o których wiadomo, że dodają własne tagi.
Analiza uruchamia się ponownie samoczynnie przy otwarciu panelu administracyjnego, gdy ma więcej niż 30 dni. Odczytuje kod HTML wysyłany przez sklep: skrypt dodany później przez JavaScript nie jest wykrywany.

Statystyki i test A/B
Zakładka Statystyki pokazuje wyświetlenia, dokonane wybory, udział „Zaakceptuj wszystkie”, „Odrzuć wszystkie” i wyborów niestandardowych, zgodę według kategorii, podział na komputery i urządzenia mobilne oraz zmiany dzienne, za okres 7, 30 lub 90 dni, 12 miesięcy lub całą historię, z eksportem do CSV. Liczniki są agregowane dziennie, bez danych osobowych i bez plików cookie. Wyświetlenie jest liczone, gdy baner zobaczy odwiedzający, który wchodzi w interakcję ze stroną; roboty są pomijane.
Test A/B porównuje dwa sformułowania lub układy. Wariant jest losowany przy każdym wyświetleniu, bez zapisywania czegokolwiek u odwiedzającego, a oba warianty zachowują „Odrzuć wszystkie” na tym samym poziomie co „Zaakceptuj wszystkie”. Zwycięzca jest ogłaszany dopiero powyżej 100 wyborów na wariant i przy istotnej różnicy na poziomie 95%.

Dowód zgód
Każdy wybór jest zapisywany wraz z datą, losowym identyfikatorem (przechowywanym również w pliku cookie odwiedzającego), działaniem, zaakceptowanymi kategoriami i usługami, wyświetloną wersją banera oraz źródłem wyboru (baner, preferencje, pływający przycisk, symbol zastępczy zablokowanej treści). Nie są przechowywane żadne imiona i nazwiska, adresy e-mail ani adresy IP w postaci jawnej; opcjonalnie dostępny jest skrót adresu IP z solą.
- Wyszukiwanie według identyfikatora zgody, eksport do CSV.
- Każda zmiana prezentowanych tekstów, usług lub ustawień tworzy wersję banera ze znacznikiem czasu, którą można pobrać w formacie JSON.
- Automatyczne czyszczenie po upływie wybranego okresu przechowywania, bez zaplanowanego zadania; możliwe również czyszczenie ręczne.
- Rejestr zostaje zachowany po odinstalowaniu modułu.

Hosting i waga
Przed dokonaniem jakiegokolwiek wyboru strona ładuje tylko dwa pliki modułu, serwowane przez Twój sklep: skrypt i arkusz stylów banera. tarteaucitron.js, jego plik językowy i pliki usług są pobierane dopiero po zgodzie, która ich wymaga; odwiedzający, który odmawia, nigdy ich nie pobiera. Opcja „CDN jsDelivr” ładuje wówczas oficjalne pliki z jsDelivr, podmiotu zewnętrznego, z którym połączenie następuje, gdy tylko usługa zostanie zaakceptowana.
Pomiar na stronie głównej PrestaShop 9.1.5 (motyw Hummingbird): 2 pliki i 12 KB przesłane przed dokonaniem jakiegokolwiek wyboru. Wersja 2.0.0 ładowała 5 plików i 38 KB (pomiar na PrestaShop 8.2.1, motyw Classic).
Multisklep
Ustawienia są zgodne z kontekstem sklepu wybranym w panelu administracyjnym: wybierz sklep, aby skonfigurować go indywidualnie. Rejestr i statystyki są zapisywane osobno dla każdego sklepu.
Ograniczenia, o których warto wiedzieć
- Moduł nie jest platformą do zarządzania zgodami zarejestrowaną w IAB Europe (TCF) ani CMP certyfikowaną przez Google. Jeśli wyświetlasz reklamy AdSense, Ad Manager lub AdMob w Europie, Google wymaga certyfikowanej CMP.
- Automatyczne blokowanie i analiza odczytują kod HTML stron: nie widzą skryptu wstrzykniętego później przez inny skrypt.
- Baner jest taki sam niezależnie od kraju odwiedzającego.
- Funkcje te pomagają stosować dobre praktyki CNIL i EROD; nie zastępują analizy prawnej Twojej strony (inwentaryzacja narzędzi śledzących, polityka prywatności, umowy z Twoimi partnerami).
Rozwiązywanie problemów
- Baner się nie wyświetla: sprawdź, czy baner jest włączony (przełącznik u góry strony) i czy co najmniej jedna usługa wymagająca zgody jest gotowa, albo wyłącz opcję „Nie wyświetlaj banera, jeśli brak usług wymagających zgody”. Następnie wyczyść pamięć podręczną PrestaShop.
- Usługa nie ładuje się po akceptacji: sprawdź jej oznaczenie w zakładce Usługi. „Do uzupełnienia” oznacza brakujący lub nieprawidłowy identyfikator.
- Skrypt ładuje się przed wyborem: uruchom analizę, a następnie użyj przycisku „Blokuj”. Jeśli skrypt się nie pojawia, jest zapewne wstrzykiwany przez inny skrypt: wyłącz go w module, który go dodaje.
- Narzędzie przestało działać po włączeniu blokowania: dodaj jego adres do wyjątków w zakładce Blokowanie albo zadeklaruj je jako usługę, aby było ładowane po wyrażeniu zgody.
- Baner pojawia się ponownie na każdej stronie: sprawdź domenę pliku cookie oraz to, czy nazwa pliku cookie nie została w międzyczasie zmieniona.
- Brak wpisów w rejestrze: sprawdź, czy rejestrowanie jest włączone w zakładce Dowód, a następnie dokonaj wyboru w trybie prywatnym przeglądarki.
Potrzebujesz pomocy? Skontaktuj się z pomocą techniczną DataFireFly ze swojego konta klienta – odpowiedź w ciągu 24 godzin roboczych.