PrestaShop Cookies (zgodny z Google Consent Mode 2.0)

Dokumentacja PrestaShop Cookies

Spis treści

1. Wprowadzenie
2. Instalacja
3. Aktywacja licencji
4. Panel zarządzania
5. Zarządzanie plikami cookie
6. Zarządzanie grupami cookies
7. Konfiguracja wyglądu
8. Integracja z Google Consent Mode
9. Korzystanie z modułu w szablonach
10. Rozwiązywanie problemów
11. FAQ

1. Wprowadzenie

• Automatyczne wykrywanie plików cookie używanych w sklepie
• Grupowanie plików cookie według kategorii
• Blokowanie cookies, na które użytkownik nie wyraził zgody
• Konfigurowalny baner zgód z różnymi stylami
• Pełną integrację z Google Consent Mode 2.0
• Zgodność z wymaganiami RODO i ePrivacy
• Wsparcie wielojęzyczności
• Zaawansowane API do wykorzystania w szablonach

2. Instalacja

• PrestaShop 1.7 lub nowszy
• PHP 7.0 lub nowszy
• Uprawnienia do instalacji modułów

1. Pobierz plik ZIP modułu z oficjalnego sklepu cocos.codes
2. Zaloguj się do panelu administracyjnego PrestaShop
3. Przejdź do: Moduły > Menedżer modułów > Dodaj nowy moduł
4. Kliknij „Dodaj moduł” i wybierz pobrany plik ZIP
5. Po zakończeniu instalacji kliknij „Konfiguruj”

3. Aktywacja licencji

1. Po instalacji przejdź do konfiguracji modułu
2. Wybierz zakładkę „Licencja”
3. Wprowadź klucz licencyjny otrzymany po zakupie
4. Kliknij „Aktywuj licencję”
5. Po pomyślnej aktywacji zobaczysz komunikat potwierdzający i odblokowane zostaną wszystkie funkcje modułu

4. Panel zarządzania

• Cookies – zarządzanie wykrytymi plikami cookie
• Grupy – zarządzanie grupami plików cookie
• Konfiguracja – ustawienia ogólne modułu oraz wyglądu banera
• Google Consent Mode – konfiguracja integracji z Google Consent Mode 2.0
• Podręcznik – instrukcje i przykłady użycia
• Wtyczki – dodatkowe rozszerzenia dla modułu
• Licencja – zarządzanie licencją modułu

• Włączanie/wyłączanie modułu
• Automatyczne wykrywanie plików cookie
• Ustawienie domyślnej grupy dla nowo wykrytych cookies
• Ukrywanie banera przed robotami (botami)
• Odświeżanie strony po zmianie preferencji cookies
• Zarządzanie rewizjami zgód (wymuszanie ponownego pokazania banera)

5. Zarządzanie plikami cookie

• Nazwa pliku cookie
• Domena
• Przypisana grupa
• Status (aktywny/zablokowany)
• Data dodania
• Dostępne akcje

1. Kliknij przycisk „Dodaj nowy plik cookie” lub „Edytuj” przy istniejącym
2. Wypełnij formularz danych pliku cookie:
   • Nazwa cookie – unikalna nazwa pliku cookie
   • Domena – domena, dla której cookie jest zapisywane
   • Ścieżka – ścieżka pliku cookie (domyślnie „/”)
   • Grupa – przypisanie do grupy cookies (np. niezbędne, analityczne, marketingowe)
   • Opis – opis funkcji pliku cookie widoczny dla użytkowników
   • Status – aktywny lub zablokowany
3. Kliknij „Zapisz” aby zachować zmiany

• Wykrywa nowe pliki cookie podczas przeglądania witryny
• Automatycznie przypisuje je do odpowiednich grup na podstawie wbudowanej bazy danych nazw cookies
• Dodaje domyślny opis dla rozpoznanych plików cookie
• Przypisuje nierozpoznane cookies do grupy „Nieskategoryzowane”

6. Zarządzanie grupami cookies

• Niezbędne (strictly_necessary) – pliki cookie konieczne do działania strony
• Funkcjonalne (functional) – cookies umożliwiające personalizację funkcji
• Statystyczne/Analityczne (performance) – cookies zbierające informacje o ruchu
• Marketingowe (marketing) – cookies używane do reklam i profilowania
• Nieskategoryzowane (unclassified) – cookies jeszcze nie przypisane do kategorii

• Dodawanie, edycja i usuwanie grup (z wyjątkiem domyślnych)
• Ustawianie obowiązkowości grupy (grupy oznaczone jako wymagane nie mogą być odrzucone przez użytkownika)
• Ustawianie statusu aktywności grupy
• Zmiana kolejności wyświetlania grup w banerze
• Zarządzanie tłumaczeniami nazw i opisów grup

7. Konfiguracja wyglądu

• Tytuł komunikatu (z obsługą wielojęzyczności)
• Treść komunikatu (z obsługą wielojęzyczności)
• Styl banera (pasek, okno, chmura)
• Pozycja pozioma (lewa, środek, prawa)
• Pozycja pionowa (góra, środek, dół)

• Maksymalna szerokość
• Zaokrąglenie rogów
• Cień
• Kolor tła
• Kolor tekstu
• Kolory przycisków (tło i tekst) dla „Akceptuj wszystkie”, „Akceptuj wybrane” i „Odrzuć wszystkie”
• Niestandardowy CSS

• Pozycja mini-banera (lewa/prawa strona)
• Odległość od dołu strony
• Rozmiar mini-banera
• Kształt (okrągły, zaokrąglony, kwadratowy)
• Kolor tła
• Typ ikonki (Material Icon, predefiniowane obrazki, własny URL)
• Kolor ikonki
• Efekt hover (powiększenie, obrót, brak)

8. Integracja z Google Consent Mode

• Włączanie/wyłączanie Google Consent Mode
• Ustawienie czy kod Google Tag jest już zainstalowany w sklepie
• Wprowadzenie ID Google Tag (dla Google Analytics 4 lub Google Tag Manager)

• URL Passthrough – przekazywanie parametrów kampanii przez URL
• Redakcja danych reklam – usuwanie informacji o konwersji przy braku zgody
• Czas oczekiwania (ms) – opóźnienie przed uruchomieniem Google Tags

• Przypisanie typów zgód Google do każdej grupy cookies
• Dostępne typy zgód:
  • Przechowywanie reklam (ad_storage)
  • Dane użytkownika reklam (ad_user_data)
  • Personalizacja reklam (ad_personalization)
  • Przechowywanie analityki (analytics_storage)
  • Przechowywanie funkcjonalności (functionality_storage)
  • Przechowywanie personalizacji (personalization_storage)
  • Przechowywanie bezpieczeństwa (security_storage)

9. Korzystanie z modułu w szablonach

{if {cc_ps_cookies_has_consent group='functional'}}
    <div class="alert alert-success">Zgoda na funkcjonalne pliki cookie została wyrażona!</div>
{else}
    <div class="alert alert-warning">Brak zgody na funkcjonalne pliki cookie.</div>
{/if}

{hook h='displayCcPsCookiesButton'}

{hook h='displayCcPsCookiesButton' class="btn btn-primary btn-sm" text="Ustawienia prywatności" icon="lock"}

// Sprawdzanie zgody na grupę cookies
if (window.ccPsCoookieConsent && typeof window.ccPsCoookieConsent.hasConsent === 'function') {
    if (window.ccPsCoookieConsent.hasConsent('performance')) {
        console.log('Zgoda na analityczne pliki cookie została wyrażona!');
        // Tutaj możesz inicjalizować np. Google Analytics
    }
}
// Nasłuchiwanie na zdarzenie zmiany preferencji cookies
document.addEventListener('cc_ps_cookies_preferences_changed', function(event) {
if (event?.detail?.preferences) {
console.log('Preferencje cookie zostały zmienione:', event.detail.preferences);
}
});

10. Rozwiązywanie problemów

1. Sprawdź, czy moduł jest włączony w zakładce „Konfiguracja”
2. Upewnij się, że licencja jest aktywna
3. Upewnij się, że hook displayFooter jest zarejestrowany i działa poprawnie
4. Sprawdź, czy nie masz włączonej opcji „Ukryj przed botami” i czy Twoja przeglądarka nie jest identyfikowana jako bot
5. Sprawdź, czy użytkownik nie ma już zapisanych preferencji cookies – zwiększ numer rewizji, aby wymusić ponowne wyświetlenie

1. Upewnij się, że automatyczne wykrywanie cookies jest włączone
2. Sprawdź, czy pliki cookie są przypisane do odpowiednich grup
3. Upewnij się, że skrypt cookie-blocker.js jest prawidłowo ładowany
4. Sprawdź, czy strona nie używa niestandardowego mechanizmu ustawiania cookies, który omija standardową funkcję document.cookie

1. Upewnij się, że Google Consent Mode jest włączony
2. Sprawdź, czy ID Google Tag jest prawidłowe (dla G-XXXXXXXXXX) lub czy kod Google Tag jest już zainstalowany
3. Upewnij się, że mapowanie grup cookies do kategorii Google jest prawidłowo skonfigurowane
4. Sprawdź, czy skrypt google-consent-mode.js jest prawidłowo ładowany

11. FAQ