Dokumentacja

Witaj w centrum pomocy CookieBaner

Poniższa dokumentacja przeprowadzi Cię krok po kroku przez proces instalacji, konfiguracji oraz integracji wtyczki z systemem Google Consent Mode V2. Nasz skrypt został zaprojektowany tak, aby działać w 100% lokalnie na Twoim serwerze WordPress, gwarantując pełną prywatność danych.

1. Instalacja i aktywacja licencji

Zanim zaczniesz, upewnij się, że posiadasz aktywną subskrypcję i pobrałeś plik .zip z wtyczką.

1. Zaloguj się do panelu administratora WordPress (/wp-admin).
2. Przejdź do zakładki Wtyczki -> Dodaj nową -> Wyślij wtyczkę na serwer.
3. Wybierz pobrany plik cookiebaner.zip i kliknij Zainstaluj.
4. Po instalacji kliknij Włącz wtyczkę.
5. W menu bocznym WordPressa pojawi się nowa zakładka CookieBaner. Przejdź do Ustawienia -> Licencja.
6. Wklej swój klucz licencyjny (znajdziesz go na stronie Moje Konto w zakładce Klucze licencyjne) i kliknij Aktywuj.

2. Szybki start (Plug & Play)

CookieBaner został zaprojektowany tak, aby oszczędzać Twój czas i nie wymagać wiedzy technicznej. Po zainstalowaniu wtyczki i podaniu klucza licencyjnego baner działa natychmiast.

Nie musisz przechodzić przez skomplikowane konfiguracje – wtyczka od razu po aktywacji:

• Wyświetla zgodny z prawem baner na Twojej stronie.
• Ustawia domyślny stan ciasteczek analitycznych i marketingowych jako „odrzucone” (do momentu akceptacji przez użytkownika, co jest wymogiem RODO).
• Rozpoczyna ochronę Twojej witryny bez żadnych dodatkowych kliknięć.

3. Automatyczny Google Consent Mode V2

Nie musisz szukać żadnych przełączników ani zakładki „Integracje” – CookieBaner natywnie wspiera najnowszy standard Google Consent Mode V2 (wymagany m.in. dla Google Ads) prosto po wyjęciu z pudełka.

• Wtyczka automatycznie komunikuje się z systemami Google, przesyłając w tle odpowiednie sygnały (granted lub denied) do warstwy danych (Data Layer).
• Nie musisz wklejać na stronę żadnych dodatkowych skryptów blokujących.
• Ważna uwaga dla użytkowników GTM: Jedyne, co musisz zrobić po swojej stronie w panelu Google Tag Managera, to upewnić się, że Twoje tagi mają zaznaczoną opcję „Wbudowane sprawdzanie zgody” (Built-in Consent Checks). Nasza wtyczka zajmie się całą resztą.

4. Skaner i kategoryzacja ciasteczek

Nasza wtyczka nie wymaga łączenia się z zewnętrznymi chmurami. Wszystko dzieje się na Twoim serwerze.

• Przejdź do zakładki Skaner Cookies.
• Kliknij przycisk Uruchom skanowanie. Wtyczka przeanalizuje Twoją stronę główną i podstrony w poszukiwaniu instalowanych skryptów.
• Po zakończeniu skanowania zobaczysz listę znalezionych ciasteczek. System automatycznie przypisze popularne ciastka (np. _ga, _fbp) do odpowiednich kategorii.
• Nietypowe skrypty znajdą się w zakładce Niesklasyfikowane. Musisz ręcznie przypisać je do kategorii: Niezbędne, Analityczne, Marketingowe lub Preferencje.

5. Personalizacja wyglądu

Chcemy, aby CookieBaner wyglądał jak integralna część Twojej marki.

1. Przejdź do zakładki Wygląd i Treść.
2. Kolorystyka: Zmień kolor główny (przycisków akceptacji), tło banera oraz kolor tekstu.
3. Układ: Wybierz, czy baner ma wyświetlać się jako dyskretny pasek na dole ekranu, czy jako wyskakujące okienko (pop-up) na środku.
4. Teksty: Możesz edytować każdą linijkę tekstu – od nagłówka, przez treść polityki, aż po etykiety na przyciskach. Pamiętaj, aby podlinkować swoją Politykę Prywatności.

6. Zarządzanie subskrypcją i kluczami

Wszystkimi swoimi licencjami i płatnościami zarządzasz z poziomu panelu klienta na naszej stronie. Zaloguj się do Mojego Konta, aby:

• Pobrać najnowszą wersję wtyczki,
• Sprawdzić datę ważności subskrypcji,
• Przypisać licencję do innej domeny (jeśli zmieniasz adres strony),
• Pobrać faktury VAT za zakup.

Potrzebujesz dodatkowej pomocy? Jeśli napotkałeś problem techniczny, konflikt z innym motywem lub masz pytania dotyczące zaawansowanej konfiguracji Google Tag Managera, nasz zespół techniczny jest do Twojej dyspozycji.

Skontaktuj się z nami przez formularz lub napisz bezpośrednio na: kontakt@cookiebaner.pl

Changelog

Wersja	Zmiany
1.0.0	Plugin bez zmian
1.1.0	Poprawa prędkości ładownia wtyczki
1.2.0	– Profesjonalny skaner cookies (HTTP, skrypty, wtyczki, kategoryzacja) – Geotargeting — baner tylko w wybranych krajach, poza regionem pełna zgoda GCM – Pełna instrukcja integracji Google Tag Manager w panelu admina – Automatyczna weryfikacja licencji co 30 dni – Optymalizacja wydajności (osobne assety CSS/JS, cache) – Usprawnienia bezpieczeństwa (eksport CSV, rate limiting) -Poprawki tłumaczeń
1.3.0	Usuwanie parametrów śledzących GA z adresów URL Wtyczka automatycznie czyści adresy URL ze zbędnych parametrów śledzących Google Analytics i innych platform reklamowych (_gl, _ga, _gid, _gcl_au, gclid, fbclid, msclkid). Parametry są usuwane zarówno z aktualnego adresu strony (bez przeładowania), jak i z linków przed kliknięciem — dotyczy wyłącznie linków w obrębie tej samej domeny. Zewnętrzne linki pozostają niezmienione. Ulepszona, wielopoziomowa detekcja języka banera Dotychczasowe wykrywanie języka opierało się wyłącznie na ustawieniach WordPress (get_locale()), co powodowało brak tłumaczenia przy przełączaniu wersji językowych. Od wersji 1.3.0 wtyczka sprawdza język kolejno z pięciu źródeł: Ręczne ustawienie języka w panelu CookieBaner WPML (ICL_LANGUAGE_CODE) Polylang (pll_current_language) TranslatePress (trp_get_language_from_url) Prefiks językowy w adresie URL (np. /en/, /de/) Lokalizacja WordPress (get_locale()) Baner automatycznie tłumaczy się na właściwy język przy przełączaniu wersji językowych serwisu — niezależnie od zastosowanej wtyczki wielojęzycznej.
1.4.0	Naprawiono konflikty stylów przycisków z Elementorem Przyciski banera (.cb-btn) na stronach zbudowanych w Elementorze były nadpisywane przez domyślne style tego kreatra, co powodowało nieprawidłowe wyświetlanie przycisków przy najechaniu kursorem i kliknięciu. Dodano reguły !important dla stanów :hover i :active, które skutecznie blokują ingerencję zewnętrznych stylów — zarówno Elementora, jak i innych kreatorów stron.
1.5.0	Poprawa tłumaczeń