Dokumentation von PrestaShop Cookies
Umfassend Dokumentation für das Modul zur Verwaltung der Cookie-Zustimmung für PrestaShop konform mit RODO, ePrivacy und Google Consent Mode 2.0 (cc_ps_cookies).Inhaltsübersicht
- Einführung
- Einrichtung
- Aktivierung der Lizenz
- Management-Panel
- Cookie-Verwaltung
- Verwaltung von Cookie-Gruppen
- Konfiguration des Erscheinungsbildes
- Integration in den Google-Zustimmungsmodus
- Verwendung des Moduls in Vorlagen
- Lösung von Problemen
- FAQ
1. Einleitung
CC PrestaShop EU Cookies ist ein fortschrittliches Modul zur Verwaltung von Cookies, das mit RODO, ePrivacy und Google Consent Mode 2.0 konform ist. Das Modul bietet volle Kontrolle über die im Shop verwendeten Cookies und ermöglicht es, diese zu gruppieren, zu blockieren und den Nutzern auf ästhetisch ansprechende Weise zu präsentieren.Das Modul bietet:
- Automatische Erkennung der im Shop verwendeten Cookies
- Gruppierung von Cookies nach Kategorien
- Blockieren von Cookies, zu denen Sie nicht Ihre Zustimmung gegeben haben
- Konfigurierbares Zustimmungsbanner mit verschiedenen Stilen
- Vollständige Integration des Google-Zustimmungsmodus 2.0
- Einhaltung der RODO- und ePrivacy-Anforderungen
- Unterstützung der Mehrsprachigkeit
- Erweiterte API zur Verwendung in Vorlagen
2. Einbau
Systemanforderungen- PrestaShop 1.7 oder höher
- PHP 7.0 oder höher
- Erlaubnis zur Installation von Modulen
- Laden Sie die ZIP-Datei des Moduls aus dem offiziellen Shop herunter cocos.codes
- Loggen Sie sich in das PrestaShop-Administrationspanel ein
- Gehen Sie zu: Module > Modulmanager > Neues Modul hinzufügen
- Klicken Sie auf "Modul hinzufügen" und wählen Sie die heruntergeladene ZIP-Datei aus.
- Wenn die Installation abgeschlossen ist, klicken Sie auf "Konfigurieren".
Infos
Nach der Installation legt das Modul automatisch die Standard-Cookie-Gruppen an und erstellt die erforderlichen Tabellen in der Datenbank. Es ist notwendig, das Modul zu konfigurieren und die Lizenz zu aktivieren, bevor alle Funktionen vollständig genutzt werden können.
3. die Aktivierung der Lizenz
Bevor die volle Funktionalität des Moduls genutzt werden kann, ist es notwendig, die Lizenz zu aktivieren:- Nach der Installation fahren Sie mit der Modulkonfiguration fort
- Wählen Sie die Registerkarte "Lizenz".
- Geben Sie den nach dem Kauf erhaltenen Lizenzschlüssel ein
- Klicken Sie auf "Lizenz aktivieren".
- Nach erfolgreicher Aktivierung erhalten Sie eine Bestätigungsmeldung und alle Funktionen des Moduls sind freigeschaltet.
Warnung
Ohne eine aktive Lizenz arbeitet das Modul im eingeschränkten Modus, ohne alle erweiterten Funktionen. Eine Meldung über eine inaktive Lizenz wird oben im Verwaltungsbereich angezeigt.
4 Management-Panel
Die Verwaltungsoberfläche des Moduls besteht aus mehreren Registerkarten, die eine vollständige Konfiguration ermöglichen:Hauptregisterkarten:
- Cookies - Verwaltung der erkannten Cookies
- Gruppen - Verwaltung von Gruppen von Cookies
- Konfiguration - allgemeine Einstellungen für das Modul und das Bannermotiv
- Google-Zustimmungsmodus - Konfiguration der Integration des Google Consent Mode 2.0
- Handbuch - Anleitungen und Beispiele für die Verwendung
- Plug-ins - zusätzliche Erweiterungen für das Modul
- Lizenz - Modul Lizenzmanagement
Allgemeine Funktionalitäten:
- Ein- und Ausschalten des Moduls
- Automatische Cookie-Erkennung
- Einstellung der Standardgruppe für neu entdeckte Cookies
- Verstecken des Banners vor Robotern (Bots)
- Seite nach Änderung der Cookie-Einstellungen aktualisieren
- Verwaltung von Zustimmungsänderungen (Erzwingen der erneuten Einblendung des Banners)
Tipp
Um zu erzwingen, dass das Einwilligungsbanner erneut für alle Benutzer angezeigt wird, erhöhen Sie die Revisionsnummer in den allgemeinen Einstellungen des Moduls. Dies ist z. B. nach der Einführung neuer Cookie-Kategorien oder einer Änderung der Datenschutzrichtlinie sinnvoll.
5. die Verwaltung von Cookies
Die Registerkarte "Cookies" ermöglicht es Ihnen, alle erkannten Cookies in Ihrem Shop zu verwalten:Liste der Cookies
- Name des Cookies
- Bereich
- Zugewiesene Gruppe
- Status (aktiv/gesperrt)
- Datum hinzugefügt
- Verfügbare Aktionen
- Klicken Sie auf die Schaltfläche "Neues Cookie hinzufügen" oder "Bearbeiten" neben einem vorhandenen Cookie.
- Füllen Sie das Cookie-Datenformular aus:
- Name des Cookies - eindeutiger Cookie-Name
- Bereich - die Domäne, für die das Cookie gespeichert wird
- Pfad - Pfad des Cookies (Standardwert "/")
- Gruppe - Zuordnung zu einer Gruppe von Cookies (z. B. essentiell, analytisch, Marketing)
- Beschreibung - Beschreibung der Funktion des für die Nutzer sichtbaren Cookies
- Status - aktiv oder gesperrt
- Klicken Sie auf "Speichern", um die Änderungen zu speichern.
Das Modul bietet die Möglichkeit, die im Shop verwendeten Cookies automatisch zu erkennen. Diese Funktion:
- Erkennt neue Cookies beim Surfen auf der Website
- Es ordnet sie automatisch den entsprechenden Gruppen zu, basierend auf einer eingebauten Datenbank mit Cookie-Namen
- Fügt Standardbeschreibung für erkannte Cookies hinzu
- Ordnet nicht erkannte Cookies der Gruppe "Uncategorized" zu
Hinweis
Die automatische Erkennung funktioniert, wenn der Benutzer auf der Website surft. Um alle verwendeten Cookies zu erkennen, empfehlen wir, die verschiedenen Bereiche des Shops zu überprüfen, wenn diese Funktion aktiviert ist. Bitte beachten Sie, dass einige Cookies nur unter bestimmten Bedingungen geladen werden können, z. B. wenn Sie ein Produkt in den Warenkorb legen.
6. Verwaltung von Cookie-Gruppen
Auf der Registerkarte "Gruppen" können Sie Kategorien von Cookies verwalten:Standard-Gruppen
- Streng_notwendig - Cookies, die für den Betrieb der Website erforderlich sind
- Funktionell - Cookies, die die Personalisierung von Funktionen ermöglichen
- Statistisch/Analytisch (Leistung) - Cookies, die Verkehrsinformationen sammeln
- Marketing - Cookies, die für Werbung und Profilerstellung verwendet werden
- Nicht klassifiziert - Cookies, die noch keiner Kategorie zugewiesen sind
- Hinzufügen, Bearbeiten und Löschen von Gruppen (außer Standard)
- Gruppenzwang (als zwingend gekennzeichnete Gruppen können vom Benutzer nicht abgelehnt werden)
- Einstellung des Gruppenaktivitätsstatus
- Ändern der Anzeigereihenfolge von Gruppen im Banner
- Verwaltung der Übersetzungen von Gruppennamen und -beschreibungen
Infos
Standardmäßig ist nur die Gruppe "Strictly_necessary" als erforderlich gekennzeichnet. Diese Eigenschaft kann für die Standardgruppe der wesentlichen Cookies nicht geändert werden. Diese Gruppe ist immer aktiv, unabhängig von der Präferenz des Benutzers.
7. das Erscheinungsbild zu konfigurieren
Auf der Registerkarte "Konfiguration" können Sie das Aussehen des Banners für die Cookie-Zustimmung anpassen:Einstellungen für Nachrichten
- Titel der Nachricht (mit mehrsprachiger Unterstützung)
- Nachrichteninhalt (mit Unterstützung der Mehrsprachigkeit)
- Bannerstil (Balken, Fenster, Wolke)
- Horizontale Position (links, Mitte, rechts)
- Vertikale Position (oben, Mitte, unten)
- Maximale Breite
- Abrundung der Ecken
- Schatten
- Hintergrundfarbe
- Textfarbe
- Schaltflächenfarben (Hintergrund und Text) für "Alle akzeptieren", "Ausgewählte akzeptieren" und "Alle ablehnen"
- Benutzerdefiniertes CSS
Ein Mini-Banner ist eine kleine Schaltfläche, die angezeigt wird, wenn das Hauptbanner geschlossen wird, und die es dem Benutzer ermöglicht, die Cookie-Einstellungen erneut zu öffnen.
- Position des Minibanners (links/rechts)
- Abstand vom unteren Rand der Seite
- Mini-Banner Größe
- Form (rund, abgerundet, quadratisch)
- Hintergrundfarbe
- Icon-Typ (Material-Icon, vordefinierte Bilder, eigene URL)
- Farbe des Symbols
- Hover-Effekt (Zoom, Drehung, keine)
Tipp
Mit der Schaltfläche "Banner-Vorschau anzeigen" können Sie sich das Aussehen des Banners mit den aktuellen Einstellungen ansehen, bevor Sie die Änderungen speichern. Sie können mit verschiedenen Stilen experimentieren, um das optimale Aussehen zu finden, das zu Ihrem Shop-Layout passt.
8 Integration mit dem Google-Zustimmungsmodus
Die Registerkarte "Google Consent Mode" ermöglicht die Konfiguration der Integration des Google Consent Mode 2.0:Allgemeine Einstellungen
- Aktivieren/Deaktivieren des Google-Zustimmungsmodus
- Einstellung, ob der Google Tag-Code bereits im Shop installiert ist
- Eingabe der Google Tag ID (für Google Analytics 4 oder Google Tag Manager)
- URL Passthrough - Übergabe von Kampagnenparametern per URL
- Schwärzung von Werbedaten - Entfernung von Umrechnungsinformationen bei fehlender Zustimmung
- Wartezeit (ms) - Verzögerung vor dem Start von Google Tags
- Zuweisung von Google-Zustimmungsarten zu jeder Gruppe von Cookies
- Verfügbare Arten der Zustimmung:
- Werbeablage (ad_storage)
- Benutzerdaten der Anzeige (ad_user_data)
- Anzeigenpersonalisierung
- Speicherung von Analysen (analytics_storage)
- Funktionale Speicherung (functionality_storage)
- Personalisierungsspeicher (personalisation_storage)
- Sicherheitsspeicher (security_storage)
Warnung
Damit der Google Consent Mode korrekt funktioniert, ist es notwendig, eine gültige Google Tag ID (G-XXXXXXXXXX) einzugeben oder die Option zu wählen, dass der Google Tag/GTM-Code bereits im Shop installiert ist. Andernfalls wird die Funktion nicht richtig funktionieren.
9. Verwendung des Moduls in den Vorlagen
Das Modul bietet API-Funktionen, die in Shop-Vorlagen verwendet werden können:Überprüfung der Zustimmung der Nutzer
In Smarty-Templates ist es möglich zu überprüfen, ob ein Benutzer einer bestimmten Gruppe von Cookies zugestimmt hat. cc_ps_cookies_hats_consent:
{if {cc_ps_cookies_has_consent group='functional'}}
<div class="alert alert-success">Sie haben Ihr Einverständnis für funktionale Cookies gegeben!</div>
{Ansonsten}
<div class="alert alert-warning">Keine Zustimmung für funktionale Cookies.</div>
{/if}Um eine Schaltfläche an einer beliebigen Stelle in der Vorlage zu platzieren, die das Cookie-Verwaltungsfenster öffnet, können Sie die Verknüpfung displayCcPsCookiesButton:
{hook h='displayCcPsCookiesButton'}.{hook h='displayCcPsCookiesButton' class="btn btn-primary btn-sm" text="Datenschutzeinstellungen" icon="Schloss"}Das Modul bietet auch eine JavaScript-API, um den Status von Einwilligungen zu prüfen und auf Änderungen zu warten:
// Prüfung auf Zustimmung der Cookie-Gruppe
if (window.ccPsCoookieConsent && typeof window.ccPsCoookieConsent.hasConsent === 'function') {
if (window.ccPsCoookieConsent.hasConsent('performance')) {
console.log('Die Zustimmung für Analyse-Cookies wurde erteilt!');
// Hier können Sie z.B. Google Analytics initialisieren
}
}
// Warten auf das Ereignis zur Änderung der Cookie-Präferenz
document.addEventListener('cc_ps_cookies_preferences_changed', function(event) {
if (event?.detail?.preferences) {
console.log('Die Cookie-Einstellungen wurden geändert:', event.detail.preferences);
}
});Tipp
Weitere Beispiele für die Verwendung der API und eine ausführliche Dokumentation finden Sie auf der Registerkarte "Handbuch" im Verwaltungsbereich des Moduls.
10. die Problemlösung
Cookie-Banner wird nicht angezeigt- Prüfen Sie, ob das Modul unter "Konfiguration" aktiviert ist.
- Sicherstellen, dass die Lizenz aktiv ist
- Stellen Sie sicher, dass der displayFooter-Haken registriert ist und korrekt funktioniert.
- Vergewissern Sie sich, dass Sie die Option "Vor Bots verstecken" nicht aktiviert haben und dass Ihr Browser nicht als Bot identifiziert wird.
- Prüfen Sie, ob die Cookie-Einstellungen des Benutzers nicht bereits gespeichert sind - erhöhen Sie die Revisionsnummer, um eine erneute Anzeige zu erzwingen
- Stellen Sie sicher, dass die automatische Cookie-Erkennung aktiviert ist
- Prüfen Sie, ob die Cookies den richtigen Gruppen zugeordnet sind
- Stellen Sie sicher, dass das Skript cookie-blocker.js korrekt geladen ist.
- Vergewissern Sie sich, dass die Website keinen benutzerdefinierten Cookie-Einstellungsmechanismus verwendet, der die Standardfunktion document.cookie umgeht.
- Stellen Sie sicher, dass der Google-Zustimmungsmodus aktiviert ist
- Überprüfen Sie, ob die Google Tag ID korrekt ist (für G-XXXXXXXXXX) oder ob der Google Tag Code bereits installiert ist
- Stellen Sie sicher, dass die Zuordnung von Cookie-Gruppen zu Google-Kategorien korrekt konfiguriert ist
- Prüfen Sie, ob das Skript google-consent-mode.js korrekt geladen ist
Fehler
Wenn Sie unlösbare Probleme mit dem Modul haben, stellen Sie bitte sicher, dass Sie die neueste Version verwenden und dass Ihr PrestaShop-Shop auf dem neuesten Stand ist. Bei Schwierigkeiten wenden Sie sich bitte an den COCOS-Support über cocos.codes/unterstützung.
11. FAQ
Blockiert das Modul automatisch Cookies, denen der Nutzer nicht zugestimmt hat?Ja, das Modul blockiert automatisch Cookies, die als blockiert gekennzeichnet wurden und nicht zu der Gruppe gehören, der der Nutzer zugestimmt hat.
Ist das Modul mit RODO und ePrivacy konform?
Ja, das Modul wurde in Übereinstimmung mit den Anforderungen von RODO und der Datenschutzrichtlinie für elektronische Kommunikation entwickelt, so dass die Nutzer ihre Zustimmung zu den im Shop verwendeten Cookies in Kenntnis der Sachlage geben können.
Unterstützt das Modul mehrere Sprachen?
Ja, das Modul unterstützt die Mehrsprachigkeit vollständig. Der Titel, die Nachricht und die Beschreibungen von Gruppen und Cookies können in alle Sprachen des Shops übersetzt werden.
Kann ich das Modul ohne den Google-Zustimmungsmodus verwenden?
Ja, die Integration mit dem Google-Zustimmungsmodus ist optional. Sie können das Modul nur zur Verwaltung von Cookie-Einwilligungen ohne Google-Integration verwenden.
Funktioniert das Modul auch mit anderen Analysetools als Google Analytics?
Ja, das Modul kann mit allen Analysetools über API-Funktionen verwendet werden, um die Zustimmung der Nutzer zu prüfen. Beispiele für die Integration finden Sie auf der Registerkarte "Handbuch".
Wie oft wird das Modul aktualisiert?
Das Modul wird regelmäßig aktualisiert, um die Übereinstimmung mit den neuesten Vorschriften und technischen Anforderungen zu gewährleisten. Inhaber einer gültigen Lizenz haben Zugang zu allen Updates.
Kann ich die Lizenz auf ein anderes Geschäft übertragen?
Die Lizenz ist einer Domain zugeordnet. Wenn Sie Ihre Shop-Domain wechseln, kontaktieren Sie bitte den COCOS-Support, um die Lizenz zu übertragen.
Beeinträchtigt das Modul die Leistung des Geschäfts?
Das Modul wurde im Hinblick auf die Leistung optimiert und sollte die Ladezeiten von Seiten nicht wesentlich beeinträchtigen. Die automatische Cookie-Erkennung kann ausgeschaltet werden, wenn Sie eine Verlangsamung feststellen.
