Niezbędne — bez zgody
PrestaShop-{hash}sesja sklepu PS 1.7ps-{hash}sesja PS 1.7+ / 8.xPHPSESSIDserwerowa sesja PHPcheckout, cartkoszyk i checkoutcustomer_idlogin klientaiqitcookielaw_*kompatybilność z IQIT modułami
Moduł PrestaShopZgodny sklep PrestaShop
Zgodny sklep PrestaShop
w 5 minut, bez modyfikacji szablonu.
Cookies PS (sesja, koszyk, login klienta) sklasyfikowane jako niezbędne — banner pyta tylko o analitykę i remarketing. Działa od PS 1.7.6 wzwyż, w tym 8.x i 9.x.
Co banner NIE pyta, a co pyta
Wymaga zgody — banner pyta
_ga, _ga_*GA4 enhanced ecommerce_gcl_*, IDEGoogle Ads + remarketing_fbp, frMeta Pixel_hjSessionUser_*Hotjar nagrania_clck, _clskMicrosoft Claritycebs, cebsp_moduły email-marketing 3rd-party
0130 sekund
Pobierz moduł
Załóż konto na cjakciasteczko.pl, dodaj domenę sklepu, w panelu Integracje pobierz cjakciasteczko-prestashop.zip. Plik ~4 KB — najlżejszy z naszych pluginów.
cjakciasteczko.pl/app/integrations
PrestaShop
v1.0.0Moduł PrestaShop dla CJakCiasteczko. Cookies sklepu auto-niezbędne.
PS: 1.7.6–9.x
↓ Pobierz 4 KB
cjakciasteczko-prestashop-1.0.0.zip pobrany
0260 sekund
Wgraj w PS admin
Moduły → Manager modułów → Załaduj moduł → wybierz pobrany .zip → Zainstaluj. Standardowy PS-flow, działa też na Multistore.
admin → Moduły → Manager modułów
Załaduj moduł
cjakciasteczko-prestashop-1.0.0.zip
Zainstaluj
✓ Moduł zainstalowany. Klik Konfiguruj.
0330 sekund
Skonfiguruj klucz
Klik Konfiguruj na karcie modułu. Wklej klucz instalacyjny z panelu CJakCiasteczko. Zapisz i zweryfikuj — moduł sprawdzi klucz przeciw naszemu API.
admin → Moduły → CJakCiasteczko → Konfiguruj
Klucz instalacyjny
cjc_live_a4f8…0c91
Zapisz i zweryfikuj
✓ Plugin podłączony. Banner aktywny dla domeny twojsklep.pl.
04natychmiast
Sklep zgodny
Otwórz produkt w incognito. Banner pojawia się raz. Po Akceptuj — GA4, Ads, Pixel ruszają. Po Tylko niezbędne — sklep działa, analityka cisza.
twojsklep.pl/produkt/lampka-led
🛒 koszyk: 1
🍪 Cookies w sklepie
GA4, Meta Pixel, Google Ads chcą wiedzieć co kupiłeś. Bez zgody sklep też działa — koszyk i checkout zawsze są dostępne.
AkceptujęTylko niezbędnePreferencje
U realnego sklepu PrestaShop
„PS 8.1, 4 sklepy w jednej instalacji. Moduł działa per Multistore — każdy sklep ma swój klucz, swoją konfigurację banner'a w panelu. Audyt UODO przeszedł na zielono."
PrestaShop Multistore — różne klucze per sklep
PS Multistore pozwala mieć kilka sklepów (różne domeny, języki, waluty) w jednej instalacji. Każdy sklep zwykle ma odrębne konto CJakCiasteczko, oddzielny banner config — moduł respektuje scope-context PS.
Konfiguracja per shop
W admin PS, przed otwarciem konfiguracji modułu, wybierz shop_id z dropdown'u w lewym górnym rogu (Multistore tree). Klucz zapiszesz tylko dla tego sklepu — inne mają niezależne. Pole CJC_API_KEY w PS Configuration table ma kolumnę id_shop niezerową dla per-shop'owych wpisów.
Wspólny klucz dla grupy sklepów
Jeśli wszystkie Twoje sklepy w PS Multistore to ten sam brand pod różnymi domenami i chcesz JEDEN dashboard CJakCiasteczko — wybierz „Wszystkie sklepy" przed konfiguracją, klucz zapisze się globalnie. Backend obsłuży kilka domen pod jednym kluczem (każda domena = osobny rekord, ale ten sam customer/billing).
Migracja PS 1.7 → 8.x → 9.x
Przy upgrade PS moduł zostaje, klucz zostaje. Weryfikacja hooków displayHeader działa identycznie od 1.7 do 9.x. Jedyna pułapka: przy major upgrade czasem trzeba ręcznie wyczyścić cache modułów (Zaawansowane → Performance → Wyczyść cache).
Kompatybilność z popularnymi modułami PL
Polska scena PrestaShop ma swoje must-have'y. Sprawdziliśmy najczęstsze konflikty z istniejącą logiką cookies.
IQIT modules (warhouse, megamenu, theme)
Cookies iqitcookielaw_* ustawiane przez stary IQIT cookie law module. Po instalacji naszego — wyłącz IQIT cookie law (Moduły → Manager → IQIT Cookie Law → Wyłącz). Pozostałe moduły IQIT (megamenu, warhouse layout) zostają aktywne, nie kolidują.
JMS theme + jms_*
Theme'y JMS często włączają własny banner cookies w options themu. Wyłącz w panelu themu (Wygląd → Ustawienia themu → Cookies → Off). Nasz banner zastąpi natywnie, bez konfliktu CSS z JMS-owym.
PrestaShop Marketing with Google
Oficjalny PS-owy moduł (PS 8+) integrujący GA4 / Ads / Merchant Center. Działa idealnie z naszym bannerem — Marketing with Google czeka na gtag('consent', 'update', ...), my to wysyłamy po Akceptuj. Konwersje GA4 enhanced ecommerce ruszają natychmiast po zgodzie.
Smarty cache + override szablonu
PS 8+ cache'uje hook outputy w Smarty. Po zmianie konfiguracji w naszym module hook displayHeader regeneruje się przy kolejnym page-load (wyłącz cache w trybie debug jeśli zmiany nie widać). Theme'y z mocnym overridem header.tpl powinny zachować {$HOOK_HEADER} placeholder — bez tego nasz banner się nie wstrzyknie.
FAQ — PrestaShop
Czy moduł działa z TCF v2 / IAB framework?
Nie wprost. Implementujemy Google Consent Mode v2, który jest standardem dla GA4 + Google Ads. TCF v2 to wymóg IAB dla sieci reklamowych Ad Exchange / SSP. 95% polskich sklepów PS nie potrzebuje TCF — wystarczy GCM v2. Jeśli sprzedajesz powierzchnię reklamową przez Google Ad Manager / Xandr / Magnite, daj znać — dorobimy CMP-style TCF wrapper.
Override szablonu zepsuł banner — co zrobić?
Sprawdź header.tpl w theme'ie — musi zawierać {$HOOK_HEADER nofilter}. Niektóre themy go usuwają na rzecz custom hardcoded asset list — to blokuje nasz hookDisplayHeader. Dodaj go z powrotem albo użyj innego hook'a (modules/cjakciasteczko/cjakciasteczko.php → registerHook('displayBeforeBodyClosingTag') jako fallback).
Mam stary moduł cookie consent — mogę go wyłączyć?
Tak, ale w kolejności: 1) zainstaluj nasz, 2) zweryfikuj że nasz banner się pokazuje, 3) wyłącz stary moduł. Zachowanie oddzielnej kolejności zapobiega scenariuszowi, gdzie żaden banner się nie pojawia (audyt UODO na starcie).
Smarty mi cachuje stary banner po zmianie konfiguracji w panelu CJakCiasteczko
Banner config (kolory, layout, copy) klient pobiera z naszego API z cache 60s w localStorage visitora. PS Smarty cache nie wpływa — banner config jest po stronie skryptu, nie po stronie templatki PS. Twoja zmiana w panelu CJakCiasteczko propaguje się w 1 minutę u Twoich visitorów. Czyść cache PS tylko gdy zmieniasz coś po stronie modułu (np. klucz).
Jak Multistore + osobny klucz dla każdej domeny w panelu CJakCiasteczko?
Załóż 3 domeny w panelu (po jednej za każdy sklep w PS), wygeneruj 3 klucze. Wprowadź każdy klucz per shop_id w PS admin (najpierw wybierz shop z Multistore tree, potem otwórz Konfiguruj). Każdy sklep dostaje osobne audit logi i osobny banner config.
5 minut do RODO-zgodnego sklepu PS.
30 dni za darmo, bez karty. Działa od PrestaShop 1.7.6 + PHP 7.4.