Cookies Revolution: konfiguracja i pomoc
Szybki start
- Wyłącz inny aktywny moduł mprcookiebanner, jeśli jest obecny. Prześlij ZIP Cookies Revolution w Moduły > "Module Manager" i zainstaluj go.
- Otwórz Cookies Revolution > Wygląd. Wybierz Tryb blokowania, zaczynając od Miękka blokada, i sprawdź Układ banera.
- Otwórz Kategorie cookie, Usługi i Cookies. Sprawdź cele, wymaganą kategorię i opcjonalne przypisania usług.
- Otwórz Blokowanie skryptów. Sprawdź aktywne wzorce i nie obejmuj opcjonalnymi regułami niezbędnych skryptów checkoutu, logowania i koszyka.
- Otwórz Ustawienia > "Configuration". Sprawdź "Cookie Expiry", "Re-consent after", "Enable GCM v2" i Włączenie rejestrowania zgód.
- Uruchom Skaner cookie, skategoryzuj oczekujące wpisy i użyj Utwórz stronę polityki plików cookie lub wpisz "Custom Policy URL (overrides CMS)".
- Przetłumacz teksty w sekcji Wygląd, zapisz je, a następnie przetestuj Akceptuj wszystkie, Odrzuć wszystkie i wybrane preferencje w świeżej przeglądarce. Zweryfikuj odpowiednie żądania skryptów i dziennik zgód.
Wymaga PrestaShop 1.6 lub nowszego i PHP 7.1 lub nowszego.
Instrukcja konfiguracji
Instalacja i konfiguracja
Wykonaj kroki opisane w sekcji Szybki start.
Wybór sposobu blokowania
Jeśli mprcookiebanner jest już zainstalowany i włączony, wyłącz go lub odinstaluj przed instalacją Cookies Revolution. Instalator odrzuca instalację, gdy ten drugi moduł jest aktywny.
Otwórz Cookies Revolution > Wygląd i ustaw Tryb blokowania przed konfiguracją poszczególnych reguł.
| Tryb blokowania | Domyślnie | Działanie w sklepie |
|---|---|---|
| Miękka blokada | Wybrane | Pozostawia stronę dostępną i odmawia opcjonalnych zgód przed wyborem. Używa ustawienia "Script blocking engine". |
| Twarda blokada | Nie | Wymaga wyboru, wymusza blokowanie skryptów i blokującą nakładkę oraz ignoruje ustawienie przycisku zamknięcia. |
| Brak blokady | Nie | Zwalnia skrypty przed zgodą. Google Consent Mode nadal czeka na zweryfikowaną, zmapowaną decyzję. |
W Ustawienia > "Configuration" > Ogólne opcja Wymagaj wyboru ustawień cookies przed korzystaniem ze strony jest domyślnie wyłączona. Włącz ją, aby blokować kliknięcia w tle, fokus klawiatury i przewijanie, dopóki odwiedzający nie zaakceptuje, nie odrzuci lub nie zapisze preferencji. Ukrywa przycisk zamknięcia banera. Sama nie zmienia silnika skryptów ani ustawień Consent Mode. Twarda blokada zawsze wymaga wyboru.
Nie obejmuj skryptów koszyka, logowania, płatności i bezpieczeństwa opcjonalnymi regułami blokowania. Dodawaj lub zaostrzaj reguły dopiero po sprawdzeniu odpowiedniej ścieżki w sklepie.
Konfiguracja ustawień ogólnych
Otwórz Cookies Revolution > Ustawienia > "Configuration". Angielskie etykiety pól i domyślne wartości nowej instalacji to:
Ogólny
| Ustawienie | Domyślnie | Kiedy zmienić |
|---|---|---|
| "Enable Module" | Włączone | Wyłącz, aby zatrzymać wyświetlanie zgód modułu. |
| Wymagaj wyboru ustawień cookies przed korzystaniem ze strony | Wyłączone | Wymagaj wyraźnego wyboru przed interakcją ze stroną, z wyjątkami dla stron prawnych. |
| "Cookie Expiry" | 365 dni | Zmień czas przechowywania ciasteczek zgody w przeglądarce. |
| "Re-consent after" | 0 dni | Ustaw dodatni interwał, aby decyzje wygasały według wieku. Zero wyłącza tę kontrolę wieku. |
| "Re-consent on cookie list change" | Włączone | Poproś o nową decyzję, gdy zapisana wersja kontraktu zgody przestaje się zgadzać. |
"Re-consent after" używa teraz znacznika czasu decyzji. Brakujący, nieprawidłowy lub przyszły znacznik czasu nie spełnia skonfigurowanej kontroli wieku. Wersja zgody to wewnętrzny ośmioznakowy hash obejmujący aktywne kategorie, zarejestrowane wpisy pamięci, reguły, usługi, przypisanie typów Consent Mode do usług i odpowiednie powiązania integracji. Generuje ją moduł, nie wpisuje się jej ręcznie.
Google Consent Mode
| Ustawienie | Domyślnie | Kiedy zmienić |
|---|---|---|
| "Enable GCM v2" | Włączone | Włącz domyślne wartości i aktualizacje zgody Google. |
| "wait_for_update" | 500 ms | Dostosuj czas oczekiwania używany do inicjalizacji zgody Google. |
| Przekazywanie danych przez adresy URL Google | Wyłączone | Włącz tylko wtedy, gdy potrzebujesz przekazywania URL Google. Dodaje _gl do wewnętrznych linków/formularzy odwiedzających bez zgody i wpływa na pamięć podręczną stron. |
Domyślne sygnały Google odmawiają opcjonalnej pamięci i zezwalają na security_storage. Aktualizacje odpowiadają zweryfikowanym mapowaniom kategorii i usług. Same sygnały zgody Google nie zastępują reguł blokowania skryptów.
Rejestrowanie zgód
Włączenie rejestrowania zgód jest domyślnie włączone. "Log Retention" ma domyślnie 365 dni. Użyj Usuń stare dzienniki zgód, aby usunąć wpisy starsze niż okres przechowywania. Nie zakładaj, że wpisanie okresu planuje automatyczne usuwanie.
Otwórz Rejestr zgód, aby przeglądać zapisane decyzje lub eksportować CSV. Rekordy zawierają hashe odwiedzającego, IP i user-agent, wybory kategorii/usług, wersję zgody, źródło i datę. CSV zawiera też kolumnę country_code, która pozostaje pusta.
Strona polityki cookie
"Auto-Update CMS Page" jest domyślnie włączone. Treść polityki wymaga ręcznej aktualizacji niezależnie od tego ustawienia. Po zmianie katalogu użyj ręcznie Utwórz stronę polityki plików cookie lub Aktualizuj stronę polityki plików cookie.
"Custom Policy URL (overrides CMS)" jest domyślnie puste i wielojęzyczne. Wpisz własny URL polityki, aby zastąpić link wygenerowanej strony. Identyfikator wygenerowanej strony CMS zaczyna się od 0 i jest zapisywany wewnętrznie przy jej utworzeniu.
"Legal pages readable before a choice" jest domyślnie puste. Wpisz oddzielone przecinkami identyfikatory stron CMS, które mają pozostać czytelne bez ściany zgody. Strona polityki również jest traktowana jako wyjątek dla strony prawnej.
Integracje z dostawcami
| Ustawienie | Domyślnie | Jak skonfigurować |
|---|---|---|
| Clerk.io | Automatycznie | Aktywuj automatycznie z modułem Clerk lub wybierz włączone/wyłączone. |
| Śledzenie odwiedzających Clerk.io wymaga | marketing | Wybierz opcjonalną kategorię wymaganą do trwałej identyfikacji odwiedzających. |
| Zbieranie e-maili przez Clerk.io wymaga | marketing | Wybierz opcjonalną kategorię wymaganą do zbierania adresów e-mail przez Clerk. |
| Usługa śledzenia odwiedzających Clerk.io | Tylko kategoria (bez usługi) | Opcjonalnie powiąż ten cel z aktywną usługą w wybranej kategorii. |
| Usługa przechwytywania adresów e-mail Clerk.io | Tylko kategoria (bez usługi) | Opcjonalnie powiąż zbieranie adresów e-mail z aktywną usługą w wybranej dla niego kategorii. |
Bez odpowiedniej zgody adapter wstrzymuje identyfikację odwiedzającego i zbieranie e-maili. Wyszukiwanie i rekomendacje pozostają dostępne; anonimowe odsłony nadal mogą trafiać do Clerk. Wybrana usługa musi być aktywna, należeć do tego sklepu i odpowiadać kategorii wybranej dla danego celu.
Zaawansowane
"Legacy default consent override" ma domyślnie denied. Wybory zachowują starsze etykiety opt-in/opt-out, ale obecne tryby Hard i Soft domyślnie odmawiają opcjonalnych kategorii. Brak blokady zwalnia skrypty, natomiast sygnały Google nadal wymagają zweryfikowanej decyzji. Używaj Tryb blokowania jako głównego ustawienia.
"Script blocking engine" jest domyślnie włączone. Twarda blokada wymusza włączenie; Miękka blokada używa zapisanej wartości; Brak blokady wymusza wyłączenie.
Dodawanie reguł blokowania skryptów
Otwórz Blokowanie skryptów i dodaj regułę z Kategoria, opcjonalnie Usługa, Typ reguły, Wzorzec (Regex), Opis, "Excluded controllers" i Aktywny. Dostępne typy dopasowują URL skryptów zewnętrznych, treść skryptów inline lub URL iframe.
Dla URL skryptu analitycznego:
Category: Analytics & Performance
Rule Type: URL Pattern (matches script src)
Pattern (Regex): googletagmanager\.com/gtag/js
Description: Google gtag.js
Active: Yes
Dla kodu marketingowego inline:
Category: Marketing & Advertising
Rule Type: Script Content (matches inline code)
Pattern (Regex): fbq\s*\(
Description: Inline Facebook Pixel
Active: Yes
Zainstalowane reguły obejmują typowe wzorce Google, Clarity, Hotjar, Meta, TikTok, Bing, LinkedIn i czatów. Sprawdź je względem rzeczywistych tagów. Użyj "Excluded controllers", gdy reguła ma nie dotyczyć określonych kontrolerów, a potem zweryfikuj te strony osobno.
Pasujące skrypty pozostają nieaktywne do zezwolenia na ich kategorię lub usługę. Przepisywanie używa atrybutów takich jak data-cookiecategory, data-original-src i nieaktywnego typu skryptu. Zabezpieczenia po stronie klienta obsługują też pasujące skrypty dodane później. Te mechanizmy nie cofają kodu, który już się wykonał.
Skanowanie sklepu
Otwórz Skaner cookie, uruchom skanowanie i skategoryzuj oczekujące ciasteczka. "Automatic Cookie Scanning" jest instalowane jako włączone z "Scan Interval" wynoszącym 24 godziny. Automatyczne skanowanie jest uruchamiane przy ładowaniu stron administracji, gdy nadejdzie termin. Zarządzaj skanowaniem na ekranie skanera; konfiguracja nie zawiera karty Scanner.
Skaner używa żądań HTTP i wykrywa nagłówki Set-Cookie oraz proste literalne przypisania document.cookie w zwróconym HTML. Nie uruchamia sesji przeglądarki. Ręcznie sprawdź ciasteczka tworzone po interakcji, po zgodzie lub w kodzie zewnętrznym. Te żądania skanowania wymagają rozszerzenia PHP cURL.
Weryfikacja zgód i integracja własnych linków
Przetestuj na świeżym profilu przeglądarki, a potem jako powracający odwiedzający. Sprawdź trzy ścieżki decyzji: Akceptuj wszystkie, Odrzuć wszystkie i zapis wybranych preferencji. Potwierdź, że opcjonalne żądania są blokowane przed zgodą zgodnie z wybranym trybem i regułami, a dozwolone po włączeniu odpowiedniej kategorii/usługi. Sprawdź koszyk, checkout i logowanie na każdym etapie.
Przeglądarka używa mprcr_consent, mprcr_version i dodatkowego stanu znacznika czasu/usług. Ciasteczko kategorii może wyglądać tak:
mprcr_consent=necessary:1|functional:0|analytics:1|marketing:0
mprcr_version=1a2b3c4d
Używaj publicznego API zamiast ręcznie edytować te ciasteczka:
if (window.MPRCR && window.MPRCR.isGranted('analytics')) {
loadAnalyticsCode();
}
document.addEventListener('mprcr:consent', function (event) {
if (event.detail && event.detail.analytics) {
loadAnalyticsCode();
}
});
Zaimplementuj loadAnalyticsCode() w integracji i zapewnij idempotentność, aby powtarzające się zdarzenia zgody nie ładowały kodu dwukrotnie. Odwiedzający mogą ponownie otwierać preferencje pływającym przyciskiem, linkiem Ustawienia plików cookie na koncie lub własnym linkiem wywołującym window.MPRCR.showPreferences().
Dla własnych znaczników wywołaj API z własnego handlera kliknięcia po zablokowaniu domyślnej nawigacji linku. Możesz też użyć tych hooków CSS w Niestandardowy CSS:
.mprcr-banner__inner { max-width: 980px; margin: 0 auto; }
.mprcr-category__desc { line-height: 1.6; }
.mprcr-floating { box-shadow: 0 4px 14px rgba(0,0,0,.2); }
Rozwiązywanie problemów
- Jeśli tag uruchamia się przed decyzją, sprawdź Tryb blokowania, "Script blocking engine", wzorzec reguły, Aktywny, przypisanie kategorii/usługi i wykluczone kontrolery. Sam wpis w katalogu ciasteczek nie wystarczy.
- Jeśli funkcja sklepu przestaje działać, sprawdź reguły dopasowujące niezbędne skrypty i przetestuj węższy wzorzec.
- Jeśli powracający odwiedzający ponownie widzi baner, sprawdź wersję kontraktu, "Re-consent after" i trwałość ciasteczek w przeglądarce.
- Jeśli cofnięty tag pozostawia ciasteczka, potwierdź rejestrację tych nazw i rodzajów pamięci. Próby czyszczenia nie usuną niedostępnej pamięci HTTP-only ani zewnętrznej i nie cofną wykonanego kodu.
- Jeśli wygenerowana polityka jest nieaktualna, uruchom ręcznie Aktualizuj stronę polityki plików cookie. Sprawdź "Custom Policy URL", jeśli otwiera się niewłaściwa polityka.
- Jeśli eksport dziennika zgód ma puste kraje, odpowiada to obecnemu mechanizmowi zapisu. Jeśli brakuje logów, sprawdź Włączenie rejestrowania zgód i żądanie zapisu zgody w przeglądarce.
- Jeśli strony z pamięci podręcznej pokazują stare kategorie lub wygląd, wyczyść pamięć podręczną sklepu i stron oraz uruchom kontrole "Integrity" modułu. Przetestuj ponownie w świeżym kontekście przeglądarki.
Wyłączanie lub odinstalowanie
Użyj "Enable Module" lub wyłączenia w "Module Manager", aby zatrzymać wyświetlanie, zachowując konfigurację. Przed odinstalowaniem wykonaj kopię rekordów zgód i wygenerowanej polityki. Odinstalowanie usuwa konfigurację modułu, strony administracyjne i zadeklarowany schemat oraz wywołuje usuwanie wygenerowanej strony polityki. Osobno sprawdź własne adresy polityki. Po usunięciu zaktualizuj własne linki motywu wywołujące API modułu.
Zrzuty ekranu referencyjne




Pytania
1
Czy mogę ustawić różne domyślne stany Google Consent Mode dla poszczególnych krajów?
Nie. Lightweight Cookie Banner używa jednego globalnego stanu domyślnego.
Gdy moduł odpowiada za emitowanie Consent Mode, ważna zapisana decyzja ma pierwszeństwo przed skonfigurowanym stanem domyślnym.
- Akceptacja przyznaje
ad_storage,analytics_storage,ad_user_dataiad_personalization. - Odmowa lub zamknięcie odrzuca te cztery stany.
Pamięć funkcjonalna, personalizacyjna i security_storage zaczynają ze zgodą.
Nie ma odrębnych stanów domyślnych dla krajów ani wyboru poszczególnych kategorii.
Znane problemy
31
Przyciski banera były zbyt ciasne na telefonach
Zapis starych preferencji akceptował nieaktualną zgodę
Wczesny zapis preferencji gubił wybory odwiedzającego
Wczesne dotknięcia banera były ignorowane
Przełączniki wymaganej zgody wyglądały na opcjonalne
Znane wzorce cookies zgłaszane jako nowe
Przycisk Akceptuj wszystkie nie pasował do motywu sklepu
Przerwana konfiguracja cookies systemowych pozostawała niepełna
Zapisane wzorce cookies lub teksty sprzedawcy ulegały zmianom
Nieaktualna treść zgody po zmianach cookies
Formularze administracji cookies się nie otwierały
Wzmocnienie zabezpieczeń
Zgodność z PHP 7.1
Brak cookie kliknięcia Google Ads w ustawieniach domyślnych
Uzgadnianie usług zastępowało nazwy dostawców sklepu
Brak wersji zgody w dziennikach
Teksty zgody dla różnych języków wyświetlane po angielsku
Nie zawsze można było zmienić lub wycofać zgodę
Preferencje nie mieściły się na ekranie telefonu
Wymagana zgoda blokowała politykę prywatności
Błędy zgodności z innymi zainstalowanymi modułami
Kontrole zgody zbyt często czyściły pamięć stron
Zmiany zgody nie usuwały niezawodnie odrzuconych cookies
Błędne domyślne zgody na stronach z pamięci podręcznej
Linki polityki cookies w niewłaściwym języku
Brakujące lub nieprawidłowe tłumaczenia
Starsze ustawienia cookies nie były przenoszone
Zbędne znaki obok ściany zgody
Filtry administracji cookies działały nieprawidłowo
Nakładka cookies blokowała obsługę strony
Google Analytics odpala się, zanim użytkownik wyrazi zgodę
Skrypt GA4 wykonuje się przed sprawdzeniem zgody na cookies, ponieważ jest ładowany przez Google Tag Manager, który inicjalizuje się niezależnie.
Informacja o rozwiązaniu
Dodano integrację GTM consent mode v2, która blokuje wszystkie tagi do momentu udzielenia zgody.
Zgłoszenia funkcji
21
Zaimplementowane
Osobne zgody na poszczególne usługi
Blokowanie skryptów zewnętrznych zależnie od zgody
Dodatkowe układy banera
Wymagany wybór i opcje zamykania
Opcje zgody Google
Automatyczne skanowanie cookies
Linki do preferencji cookies
Wygląd banera dopasowany do motywu
Kontrola i naprawa instalacji
Aktualizacje z panelu administracyjnego
Zaawansowany Google Consent Mode v2
Dyskretny link do ustawień cookies w stopce
Zgoda na poszczególne usługi
Czyszczenie pamięci przeglądarki po wycofaniu zgody
Zastępcze elementy zgody dla iframe
Wyjątki stron dla reguł skryptów
Działania dotyczące zgody w tekście banera
Wymagany wybór z możliwością przewijania
Układ banera na stronach prawnych
Opcjonalne przekazywanie adresów URL Google
Działania dla polityki i rejestru zgód
Dziennik zmian
v1.7.162026-05-27
- Addedcomplete FR/DE/ES/IT/PL translations
- ImprovedDefer consent banner UI to human interaction via <template> tag
- FixedMake cookie seed data idempotent
- FixedSupport localized cookie policy links
- FixedVendor compat package as files
- FixedMigrate legacy cookie configuration
Starsze wersje
v1.4.02026-03-14
- AddedAutomatic cookie scanning with admin alerts
- AddedEnhanced Conversions, Google Signals, region-specific consent defaults
- AddedAdd Accept All option for close button action
- AddedConfigurable close button action (reject vs dismiss)
- Addedself-healing integrity checks for automatic diagnostics and repair
- Addedautomatic theme detection for Classic and Hummingbird style compatibility
- Addedadmin menu management via MenuInstaller for streamlined module setup
- AddedLicense management tab with key management and renewal options
- Addedcomplete FR/DE/ES/IT/PL translations
- Improvedadmin list columns with visual badge indicators and multiselect filters
- Improvedsettings form organization with tabbed layout
- FixedRemove ?v= from CSS registerStylesheet to allow CCC combining
- FixedCookie overlay no longer blocks page interaction
- FixedRemove btn-close-white filter that inverted inline SVG to black
- Fixedvarious stability and compatibility improvements (8 fixes total)
- Fixedadmin list filters — sorting, searching, and filtering now work correctly on all columns
v1.0.02026-03-05
- Initialrelease of MPR Cookies Revolution
- InitialGDPR and CCPA compliant consent management platform
- InitialCategory-based consent: essential, analytics, marketing, and functional categories
- InitialGoogle Consent Mode v2 signals dispatched to GTM before any tracking script fires
- InitialCustomizable banner design: color scheme, position, and button label configuration
v1.3.02026-01-13
- AddedPrestaShop 9 and Hummingbird theme compatibility
- AddedIAB TCF 2.2 consent string generation for programmatic advertising compliance
- Improvedscript blocking engine to correctly handle dynamically injected third-party scripts
- Fixedconsent log export failing when the log table exceeds 100,000 rows
- Optimized consent banner rendering to eliminate Cumulative Layout Shift on initial page load
v1.2.02025-07-22
- Addedgranular consent category management splitting Analytics, Marketing, and Functional
- Addedconfigurable consent expiry period per category
- ImprovedGoogle Consent Mode v2 integration with all seven consent signal types supported
- Fixedre-consent banner not shown to returning visitors after policy version is bumped
- Addedconsent wall option to block page content until the user makes a consent choice
v1.1.02025-04-17
- Addedtrue script blocking: third-party scripts wrapped and executed only after consent
- Addedconsent log recording timestamp, hashed IP, and full consent choices for GDPR audit
- ImprovedUI with expandable category detail panels and vendor list per category
- Fixedconsent preferences not correctly restored after browser restart
Demo
Przetestuj pełny moduł przed zakupem
Licencję kupisz później, a ustawienia zostaną.
- Twoje 30-dniowe demo Przetestuj go we własnym sklepie przez 30 dni od pierwszej instalacji.
- Gotowy sklep demo Poznaj gotowy sklep demo w przeglądarce.
- Bez rejestracji Bez konta, adresu e-mail ani domeny sklepu.
Pobierając, akceptujesz warunki dema i politykę prywatności.
Otwierając to demo, akceptujesz regulamin wersji demo oraz politykę prywatności.