Instrukcja instalacji i konfiguracji Installation & Configuration Guide

Kompletny przewodnik po Cookie Banner Pro - od instalacji po zaawansowaną konfigurację Google Consent Mode v2 i GTM. Complete guide to Cookie Banner Pro - from installation to advanced Google Consent Mode v2 and GTM configuration.

WordPress 5.8+ PHP 7.4+ Darmowy Free
Spis treści Table of Contents
  1. Instalacja Installation
  2. Konfiguracja Configuration
  3. Cookie Scanner
  4. Integracja z Google Tag Manager Google Tag Manager Integration
  5. Eksport szablonu GTM GTM Template Export
  6. Cross-domain Sync (Premium)
  7. Analityka Analytics
  8. GDPR / RODO
  9. Dla deweloperów Developer Hooks
  10. Rozwiązywanie problemów Troubleshooting

Instalacja Installation

Trzy sposoby instalacji - wybierz najwygodniejszy. Three installation methods - pick the one that suits you.

Metoda 1: Z katalogu WordPress (najłatwiejsza) Method 1: From WordPress Directory (easiest)

  1. 1

    Zaloguj się do panelu WordPress Log in to your WordPress dashboard

  2. 2

    Przejdź do Wtyczki → Dodaj nową Go to Plugins → Add New

  3. 3

    Wyszukaj "Cookie Banner Pro" Search for "Cookie Banner Pro"

  4. 4

    Kliknij Zainstaluj teraz, potem Włącz Click Install Now, then Activate

Metoda 2: Przez panel WordPress (z pliku ZIP) Method 2: Via WordPress Admin (ZIP upload)

  1. 1

    Pobierz plik ZIP wtyczki Download the plugin ZIP file

  2. 2

    Przejdź do Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer Go to Plugins → Add New → Upload Plugin

  3. 3

    Wybierz plik ZIP i kliknij Zainstaluj teraz Choose the ZIP file and click Install Now

  4. 4

    Po instalacji kliknij Włącz wtyczkę After installation click Activate Plugin

Metoda 3: Przez FTP Method 3: Via FTP

  1. 1

    Rozpakuj plik ZIP na swoim komputerze Unzip the plugin file on your computer

  2. 2

    Połącz się z serwerem przez FTP/SFTP Connect to your server via FTP/SFTP

  3. 3

    Wgraj folder cookie-banner-pro do /wp-content/plugins/ Upload the cookie-banner-pro folder to /wp-content/plugins/

  4. 4

    Przejdź do Wtyczki i aktywuj Cookie Banner Pro Go to Plugins and activate Cookie Banner Pro

Powrót na górę Back to top

Konfiguracja Configuration

Po aktywacji w menu WordPress pojawi się pozycja Cookie Banner (ikona tarczy). Kliknij Cookie Banner → Settings. After activation, a Cookie Banner menu item (shield icon) appears in WordPress. Click Cookie Banner → Settings.

General Appearance Categories Texts Consent Mode Advanced Premium

General

  • Enable Banner – włącz/wyłącz banner na frontendzie enable/disable the banner on the frontend
  • Position – pozycja: dół, góra strony lub okno modalne position: bottom, top, or modal (center)
  • Layout – układ: pasek (bar) lub box layout: bar or box
  • Privacy Policy URL – link do Polityki prywatności link to your Privacy Policy page
  • Cookie Expiry – czas ważności cookie w dniach (domyślnie: 365) cookie lifetime in days (default: 365)
  • Consent Version – zwiększenie wymusi ponowne wyświetlenie banera increment to re-prompt all visitors

Appearance

  • Colors – kolory tła, tekstu, przycisków Accept, Reject, Settings background, text, Accept/Reject/Settings button colors
  • Border Radius – zaokrąglenie rogów (px) corner radius (px)
  • Font Size – rozmiar czcionki (px) font size (px)
  • Logo – logo firmy na banerze (WP Media Uploader) company logo on the banner (WP Media Uploader)
  • Custom CSS – własne reguły CSS custom CSS rules

Categories (Kategorie) Categories

  • Domyślne: Necessary (wymagana), Analytics, Marketing Defaults: Necessary (required), Analytics, Marketing
  • Add Category – dodaj własną kategorię add a custom category
  • Dla każdej kategorii: nazwą i opis w 12 językach, flaga "Required", przypisanie parametrów GCM For each category: name & description in 12 languages, "Required" flag, GCM parameter mapping

Parametry GCM: analytics_storage, ad_storage, ad_user_data, ad_personalization, functionality_storage, personalization_storage GCM Parameters: analytics_storage, ad_storage, ad_user_data, ad_personalization, functionality_storage, personalization_storage

Texts

  • Tytuł i treść banera w 12 językach Banner title & body text in 12 languages
  • Teksty przycisków: Accept All, Reject All, Settings, Save Preferences Button labels: Accept All, Reject All, Settings, Save Preferences
  • Tekst linku do polityki prywatności Privacy policy link text

Consent Mode

  • Enable Google Consent Mode v2 – włącz/wyłącz GCM enable/disable GCM
  • Wait for Update – timeout w ms (domyślnie: 500) timeout in ms (default: 500)
  • Ads Data Redaction – anonimizacja danych reklamowych gdy ad_storage=denied anonymize ad data when ad_storage=denied
  • URL Passthrough – przekazywanie parametrów kliknięcia przez URL pass click parameters through URLs

Advanced

  • Language – Auto (z WordPress locale), PL, EN, DE + 9 innych Auto (from WordPress locale), PL, EN, DE + 9 more
  • Analytics – włącz logowanie zgód enable consent logging
  • Data Retention – automatyczne czyszczenie rekordów starszych niż X dni auto-cleanup records older than X days
  • Export / Import Settings – eksport/import konfiguracji jako JSON export/import configuration as JSON

Premium

  • License Key – aktywacja klucza licencyjnego Premium activate your Premium license key
  • Cross-domain Sync – synchronizacja zgód między domenami consent sync across domains
  • Embed Code – gotowy kod do wstawienia na subdomeny ready-to-paste code for subdomains
Powrót na górę Back to top

Cookie Scanner

Automatyczne wykrywanie ciasteczek na Twojej stronie. Automatic cookie detection on your website.

Jak uruchomić skan How to run a scan

  1. 1

    Przejdź do Cookie Banner → Cookie Scanner Go to Cookie Banner → Cookie Scanner

  2. 2

    Kliknij Start Scan Click Start Scan

  3. 3

    Scanner wykona skan server-side (nagłówki HTTP) + client-side (document.cookie przez 5 minut) Scanner runs server-side (HTTP headers) + client-side (document.cookie for 5 minutes)

  4. 4

    Po 5 minutach odśwież stronę Scanner - wyniki zostaną połączone After 5 minutes, refresh the Scanner page - results will be merged

Baza znanych ciasteczek (30+) Known cookies database (30+)

Serwis Service Cookies
Google Analytics_ga, _gid, _gat
Google Ads_gcl_au, _gcl_aw
Facebook Pixel_fbp, _fbc, fr
YouTubeYSC, VISITOR_INFO1_LIVE
Hotjar_hjid, _hjSession_*
HubSpothubspotutk, __hssc, __hstc
WordPresswordpress_logged_in_*, wp-settings-*
WooCommercewoocommerce_cart_hash, woocommerce_items_in_cart
Uruchamiaj skan po dodaniu nowych skryptów lub narzędzi marketingowych. Upewnij się, ze każde ciasteczko ma przypisaną kategorię. Run a scan after adding new scripts or marketing tools. Make sure every cookie has an assigned category.
Powrót na górę Back to top

Integracja z Google Tag Manager Google Tag Manager Integration

Cookie Banner Pro automatycznie integruje się z GTM i Google Consent Mode v2. Cookie Banner Pro automatically integrates with GTM and Google Consent Mode v2.

Jak to działa How it works

  1. Skrypt GCM v2 wstawiany jest w <head> PRZED GTM/gtag.js (priority 1) GCM v2 script is injected in <head> BEFORE GTM/gtag.js (priority 1)
  2. Default consent: wszystko denied (oprócz security_storage: granted) Default consent: all denied (except security_storage: granted)
  3. Po wyborze użytkownika: gtag('consent', 'update', {...}) On user action: gtag('consent', 'update', {...})
  4. Event cbp_consent_update jest pushowany do dataLayer Event cbp_consent_update is pushed to dataLayer

Konfiguracja triggerów w GTM GTM Trigger Configuration

Utwórz trigger Custom Event z nazwą cbp_consent_update. Tagi z wbudowaną obsługą Consent Mode (GA4, Google Ads) reagują automatycznie. Create a Custom Event trigger with event name cbp_consent_update. Tags with built-in Consent Mode support (GA4, Google Ads) react automatically.

Debugowanie Debugging

  1. Otwórz konsolę przeglądarki (F12) Open browser console (F12)
  2. Sprawdź defaults: console.log(window.dataLayer) Check defaults: console.log(window.dataLayer)
  3. Kliknij przycisk na banerze i sprawdź event cbp_consent_update Click a banner button and check for cbp_consent_update event
  4. Użyj GTM Preview Mode + Google Tag Assistant Use GTM Preview Mode + Google Tag Assistant
Powrót na górę Back to top

Eksport szablonu GTM GTM Template Export

Gotowy plik JSON kontenera GTM generowany z Twojej konfiguracji. Ready-to-import GTM container JSON generated from your configuration.

Jak pobrac szablon How to download

  1. Przejdź do Cookie Banner → GTM Template Go to Cookie Banner → GTM Template
  2. Kliknij Download GTM Container JSON Click Download GTM Container JSON

Co zawiera szablon What the template includes

  • Folder "Cookie Banner Pro" grupujący elementy "Cookie Banner Pro" folder grouping all elements
  • Main Trigger: cbp_consent_update (Custom Event) Main Trigger: cbp_consent_update (Custom Event)
  • Per-category Triggers, np. "CBP - Analytics Granted" Per-category Triggers, e.g. "CBP - Analytics Granted"
  • Data Layer Variables dla każdego parametru GCM Data Layer Variables for each GCM parameter

Import do GTM Import into GTM

  1. Zaloguj się do Google Tag Manager Log in to Google Tag Manager
  2. Przejdź do Admin → Import Container Go to Admin → Import Container
  3. Wybierz pobrany plik JSON Select the downloaded JSON file
  4. Workspace: New (zalecane) | Import: Merge → Rename conflicting Workspace: New (recommended) | Import: Merge → Rename conflicting
  5. Kliknij Confirm, zweryfikuj i Publish Click Confirm, verify, and Publish
Jeśli Google Consent Mode jest wyłączony, szablon GTM nie będzie miał sensu. Włącz GCM w Settings → Consent Mode. If Google Consent Mode is disabled, the GTM template won't be useful. Enable GCM in Settings → Consent Mode.
Powrót na górę Back to top

Cross-domain Sync PREMIUM

Synchronizacja zgód cookie między domena główna a subdomenami (nawet non-WordPress). 10 EUR / miesięcznie. Sync cookie consent between your main domain and subdomains (even non-WordPress). 10 EUR / month.

Jak to działa How it works

  1. Banner na głównej domenie ustawia cookie z domain=.twojadomena.com Banner on the main domain sets cookie with domain=.yourdomain.com
  2. Cookie jest dostępne na wszystkich subdomenach Cookie is accessible on all subdomains
  3. Na subdomenach non-WP, skrypt sync.js odczytuje cookie i inicjalizuje GCM On non-WP subdomains, sync.js script reads the cookie and initializes GCM

Konfiguracja krok po kroku Step-by-step setup

1. Aktywuj licencję Premium 1. Activate Premium license

Przejdź do Cookie Banner → Settings → Premium, wpisz klucz licencyjny i kliknij Activate License. Go to Cookie Banner → Settings → Premium, enter your license key and click Activate License.

2. Skonfiguruj Cross-domain Sync 2. Configure Cross-domain Sync

  • Zaznacz Enable Cross-domain Sync Check Enable Cross-domain Sync
  • Cookie Domain: domena nadrzędną z kropką, np. .twojadomena.com Cookie Domain: parent domain with a dot, e.g. .yourdomain.com
  • Allowed Subdomains: lista subdomen (jedna na linie), obsługiwane są wzorce wildcard *.twojadomena.com Allowed Subdomains: list of subdomains (one per line), wildcard patterns supported *.yourdomain.com

3. Wstaw kod na subdomenach 3. Add embed code to subdomains

Skopiuj Embed Code z sekcji Premium i wstaw w <head> na każdej subdomenie, PRZED GTM/gtag.js: Copy the Embed Code from the Premium section and paste it in <head> on each subdomain, BEFORE GTM/gtag.js:

<script src="https://yourdomain.com/wp-json/cbp/v1/sync.js?token=XXXXX" data-cfasync="false"></script>
Skrypt sync.js ma cache 5 minut. Zmiany w konfiguracji będą widoczne na subdomenach po maks. 5 minutach. The sync.js script is cached for 5 minutes. Configuration changes will be visible on subdomains after at most 5 minutes.
Powrót na górę Back to top

Analityka Analytics

Dashboard ze statystykami zgód i odrzuceń. Consent statistics dashboard.

Przejdź do Cookie Banner → Analytics. Dostępne widoki: Go to Cookie Banner → Analytics. Available views:

  • Summary – karty z liczbą zgód, odrzuceń, współczynnikiem akceptacji cards showing consent count, rejections, acceptance rate
  • Trend – wykres liniowy (dzienny) accept vs reject vs save daily line chart: accept vs reject vs save
  • Categories – wykres kołowy - akceptacja poszczególnych kategorii pie chart - per-category acceptance rates

Dostępne okresy: 7, 30, 90, 365 dni. Ustaw automatyczne czyszczenie w Settings → Advanced → Data Retention. Available periods: 7, 30, 90, 365 days. Set auto-cleanup in Settings → Advanced → Data Retention.

Powrót na górę Back to top

GDPR / RODO

Pełna zgodność z RODO / GDPR. Full GDPR / RODO compliance.

Wymog RODO GDPR Requirement Jak spełniony How it's met
Dobrowolna zgoda Freely given consent Brak pre-zaznaczonych opcjonalnych kategorii No pre-checked optional categories
Brak dark patterns No dark patterns Accept i Reject mają równą wagę wizualną Accept and Reject have equal visual weight
Łatwe wycofanie zgody Easy consent withdrawal Przycisk re-open (ikona cookie) Re-open button (cookie icon)
Dowód zgody Proof of consent Zapis w DB: timestamp, kategorie, wersja, IP, UA DB record: timestamp, categories, version, IP, UA
Anonimizacja IP IP anonymization Zerowanie ostatniego oktetu IPv4 Last IPv4 octet zeroed out
Minimalizacja danych Data minimization Automatyczne czyszczenie starych rekordów Automatic old records cleanup
Re-consent po zmianie Re-consent on change Consent Version - zwiększenie wymusza ponowne pytanie Consent Version - increment to re-prompt
Powrót na górę Back to top

Dla deweloperów Developer Hooks & API

Eventy, dataLayer, REST API i format cookie. Events, dataLayer, REST API and cookie format.

Custom Event: cbp:consent

// Listen for consent changes document.addEventListener('cbp:consent', function(e) { console.log('Action:', e.detail.action); // 'accept_all', 'reject_all', 'save' console.log('Categories:', e.detail.categories); // { necessary: true, analytics: true, ... } });

dataLayer Event: cbp_consent_update

// Pushed to window.dataLayer on every consent action { event: 'cbp_consent_update', cbp_consent: { analytics_storage: 'granted', ad_storage: 'denied', ad_user_data: 'denied', ad_personalization: 'denied', functionality_storage: 'granted', personalization_storage: 'denied', security_storage: 'granted' } }

REST API

Endpoint Method Auth
/cbp/v1/consentPOSTPublic (5/min/IP)
/cbp/v1/analyticsGETAdmin
/cbp/v1/scanner/scanPOSTAdmin
/cbp/v1/scanner/cookiesGETAdmin
/cbp/v1/sync.jsGETToken
/cbp/v1/licenseGETAdmin

Format cookie Cookie Format

Cookie cbp_consent (JSON, URL-encoded): Cookie cbp_consent (JSON, URL-encoded):

{ "v": 1, "cats": { "necessary": true, "analytics": true, "marketing": false }, "ts": 1708934400000 }
Powrót na górę Back to top

Rozwiązywanie problemów Troubleshooting

Banner się nie wyświetła Banner not showing

  • Sprawdź czy wtyczka jest aktywna (Wtyczki → lista) Check if the plugin is active (Plugins → list)
  • Sprawdź czy Enable Banner jest zaznaczone (Settings → General) Check if Enable Banner is checked (Settings → General)
  • Wyczyść cache przeglądarki i serwera Clear browser and server cache
  • Sprawdź czy motyw wywołuje wp_footer() przed </body> Check if your theme calls wp_footer() before </body>
  • Sprawdź konsolę przeglądarki (F12) na błędy JavaScript Check browser console (F12) for JavaScript errors

Banner wyświetła się ponownie mimo zgody Banner reappears despite consent

  • Sprawdź czy numer Consent Version nie został zmieniony Check if Consent Version was changed
  • Sprawdź czy inna wtyczka/skrypt nie czyści ciasteczek Check if another plugin/script is clearing cookies
  • Sprawdź ustawienia Cookie Expiry Check Cookie Expiry setting

Google Consent Mode nie działa Google Consent Mode not working

  • Upewnij się ze Enable Google Consent Mode v2 jest zaznaczone Ensure Enable Google Consent Mode v2 is checked
  • Sprawdź czy GTM/gtag.js ładuje się PO skrypcie consent Check that GTM/gtag.js loads AFTER the consent script
  • Otwórz konsole: console.log(window.dataLayer) Open console: console.log(window.dataLayer)
  • Użyj Google Tag Assistant do weryfikacji Use Google Tag Assistant to verify

Cookie Scanner nie wykrywa ciasteczek Cookie Scanner not detecting cookies

  • Kliknij Start Scan i poczekaj 5 minut Click Start Scan and wait 5 minutes
  • Odwiedz stronę jako zalogowany admin (skrypt wymaga uprawnień) Visit the frontend as a logged-in admin (script requires admin privileges)
  • Sprawdź czy nie masz wtyczki blokującej inline scripts (CSP) Check for plugins blocking inline scripts (CSP)

Cross-domain Sync nie działa Cross-domain Sync not working

  • Sprawdź czy licencja Premium jest aktywna Check if Premium license is active
  • Sprawdź Cookie Domain - musi zaczynać się od kropki (.twojadomena.com) Check Cookie Domain - must start with a dot (.yourdomain.com)
  • Sprawdź czy subdomena jest na liście Allowed Subdomains Check if the subdomain is in the Allowed Subdomains list
  • Sprawdź konsolę przeglądarki na błędy CORS lub 403 Check browser console for CORS or 403 errors
  • Upewnij się ze embed code jest w <head> PRZED GTM Ensure embed code is in <head> BEFORE GTM
Potrzebujesz pomocy? Napisz na support@cookiebanner.pro Need help? Email us at support@cookiebanner.pro
Powrót na górę Back to top