Alle Dokumentation

Cookies Revolution — Dokumentation

Cookies Revolution ist ein kategoriebasierter Cookie-Consent-Manager für PrestaShop. Er hilft Ihnen, Besucherentscheidungen zu erfassen, optionale Tracking-Skripte bis zur Zustimmung zu blockieren, Consent-Protokolle zu führen und Signale für Google Consent Mode v2 zu senden.

Funktionen

  • Kategoriebasierte Zustimmung. Besucher können alle Cookies akzeptieren, optionale Cookies ablehnen oder ihre Zustimmung Kategorie für Kategorie festlegen.
  • Standard-Cookie-Gruppen. Das Modul installiert notwendige, funktionale, Analyse- und Marketing-Kategorien mit besucherfreundlichen Namen und Beschreibungen.
  • Regeln zur Skriptblockierung. Passende externe Skripte und Inline-Skripte werden umgeschrieben, bis die zugeordnete optionale Kategorie akzeptiert wurde.
  • Dynamischer Skriptschutz. Das Front-JavaScript überwacht neu hinzugefügte Skripte und blockiert passende Tracking-Skripte vor der Zustimmung.
  • Google Consent Mode v2. Das Modul gibt standardmäßig verweigerte Consent-Mode-Signale aus und aktualisiert sie, sobald der Besucher seine Auswahl speichert.
  • Consent-Protokoll. Gespeicherte Entscheidungen können mit Besucher-Hash, IP-Hash, User-Agent-Hash, Consent-Version, Quelle und Datum protokolliert werden.
  • CSV-Export. Die Consent-Protokollansicht enthält einen CSV-Export für Audit-Datensätze.
  • Cookie-Scanner. Der Scanner erkennt Set-Cookie-Header und einfache document.cookie-Zuweisungen und lässt Sie anschließend neue Cookies kategorisieren.
  • Generierte Cookie-Richtlinie. Der Einstellungscontroller kann aus Ihren konfigurierten Kategorien und Cookies manuell eine CMS-Seite für die Cookie-Richtlinie erstellen oder aktualisieren.
  • Individuelles Bannerdesign. Sie können Bannerposition, Farben, Texte, Overlay, Animation, schwebende Schaltfläche und eigenes CSS bearbeiten.
  • Link im Kundenkonto. Im Kundenkonto wird ein Link „Cookie Settings“ hinzugefügt, damit Besucher ihre Auswahl später ändern können.
Cookies Revolution — Consent banner preferences Cookies Revolution — Admin dashboard

Konfigurationsoptionen

  • Enable Module. Schaltet das Front-Office-Banner, das Präferenzpanel, Assets, den Konto-Link und Consent-Funktionen ein oder aus; Standard: 1.
  • Default Consent. Legt den Ausgangszustand fest, bevor der Besucher eine Auswahl trifft: denied für Opt-in oder granted für Opt-out; Standard: denied.
  • Cookie Expiry. Legt fest, wie lange mprcr_consent und mprcr_version im Browser des Besuchers gespeichert werden; Standard: 365.
  • Re-consent after. Speichert ein im Back Office eingegebenes Tagesintervall; die aktuelle erneute Zustimmung im Frontend wird durch Änderungen der Consent-Version gesteuert, nicht durch diesen Wert in abgelaufenen Tagen; Standard: 0.
  • Re-consent on cookie list change. Zeigt das Banner erneut an, wenn sich aktive Kategorien oder aktive Cookies ändern und die gespeicherte Version veraltet ist; Standard: 1.
  • Enable Script Blocking. Aktiviert serverseitiges Umschreiben von Skripten und clientseitige Blockierungsregeln; Standard: 1.
  • Enable GCM v2. Gibt Google Consent Mode v2-Signale aus und aktualisiert sie; Standard: 1.
  • wait_for_update. Legt den Google Consent Mode-Wert wait_for_update in Millisekunden fest; Standard: 500.
  • Enable Consent Logging. Sendet gespeicherte Consent-Entscheidungen an den Front-Controller des Moduls und speichert sie im Consent-Protokoll; Standard: 1.
  • Log Retention. Legt die Anzahl der Tage fest, die von der Bereinigungsaktion für alte Consent-Protokolle verwendet wird; Standard: 365.
  • Auto-Update CMS Page. Speichert den Wert CMS_AUTO_UPDATE aus dem Einstellungsformular; der aktuelle Quellcode verwendet diesen Wert nicht, um die CMS-Seite automatisch zu aktualisieren; Standard: 1.
  • Custom Policy URL. Überschreibt den Link zur generierten CMS-Richtlinienseite im Banner und im Präferenzpanel; Standard: ``.
  • Automatic Cookie Scanning. Führt einen Hintergrundscanner über Admin-Seitenaufrufe aus, wenn das Scanintervall fällig ist; Standard: 1.
  • Scan Interval. Legt das automatische Scannerintervall in Stunden fest; Standard: 24.
  • Consent Version. Interner 8-stelliger Hash, der aus aktiven Kategorien und aktiven Cookies generiert wird; Standard: ``.
  • Generated CMS Page ID. Interne ID der generierten CMS-Seite für die Cookie-Richtlinie; Standard: 0.
  • Category name. Besucher sichtbares Kategorienlabel im Präferenzpanel; Standardkategorien: Strictly Necessary, Functional, Analytics & Performance, Marketing & Advertising.
  • Category description. Besucher sichtbare Erklärung unter jedem Kategorienamen; Standard: mit den vier Standardkategorien installiert.
  • Category system name. Interner Bezeichner, der in Consent-Cookies und JavaScript verwendet wird, zum Beispiel analytics; Standard: necessary, functional, analytics, marketing.
  • Category required. Macht eine Kategorie immer aktiv und für Besucher nicht umschaltbar; Standard: necessary ist 1, optionale Kategorien sind 0.
  • Category active. Zeigt oder verbirgt die Kategorie im Besucher-Präferenzpanel; Standard: 1.
  • Category icon. Speichert einen Icon-Namen wie shield, settings, chart oder megaphone; Standard: pro Standardkategorie installiert.
  • GCM category mappings. Ordnet jede Kategorie Google-Signalen wie analytics_storage, ad_storage, ad_user_data, ad_personalization, functionality_storage, personalization_storage und security_storage zu; Standard: notwendig wird security_storage zugeordnet, funktional functionality_storage, Analyse analytics_storage, Marketing den Werbe- und Personalisierungssignalen.
  • Cookie Name. Exakter Cookie-Name oder Wildcard-ähnlicher Name, der in der Cookie-Liste angezeigt wird, etwa _ga oder _ga_*; Standard: gängige PrestaShop-, Google-, Facebook-, DoubleClick- und Bing-Cookies werden installiert.
  • Cookie Category. Weist jedes registrierte Cookie einer Kategorie zu; Standard: aus der bekannten Cookie-Liste installiert.
  • Cookie Provider. Benennt den Dienst, der das Cookie setzt; Standard: installierte Anbieternamen wie PrestaShop, Google Analytics, Facebook und Microsoft Bing.
  • Cookie Purpose. Mehrsprachiger Zwecktext, der im Präferenzpanel und auf der generierten Richtlinienseite angezeigt wird; Standard: für bekannte Cookies installiert.
  • Duration Value. Numerische Cookie-Laufzeit, die Besuchern angezeigt wird; Standard: aus bekannten Cookie-Daten installiert, sofern verfügbar.
  • Duration Unit. Einheit für die Cookie-Laufzeit: session, minutes, hours, days, months oder years; Standard: aus bekannten Cookie-Daten installiert.
  • Is Regex Pattern. Behandelt das Cookie-Muster als Regex-Treffer; Standard: 1 für Wildcard-Standards wie _ga_*, sonst 0.
  • Cookie Pattern (Regex). Regex zum Abgleichen gruppierter Cookies wie ^_ga_.*$; Standard: für Wildcard-Standards generiert.
  • Cookie Active. Schließt ein Cookie in die öffentliche Liste und Consent-Version ein oder davon aus; Standard: 1.
  • Script rule category. Weist eine Blockierungsregel einer optionalen Kategorie zu; Standard: Analyse-, Marketing- und funktionale Regeln werden installiert.
  • Rule Type. Wählt url_pattern für das Abgleichen von Skript-src oder script_content für das Abgleichen von Inline-Skripten; Standard: pro Regel installiert.
  • Pattern (Regex). Regex zum Abgleichen der Skript-URL oder des Inline-Skriptinhalts; Standard: installierte Muster decken Google Analytics, GTM, Clarity, Hotjar, Meta, TikTok, Bing, LinkedIn und gängige Chat-Widgets ab.
  • Rule Description. Back-Office-Notiz zur Blockierungsregel; Standard: installierte Beschreibungen wie Google Tag Manager oder Facebook SDK.
  • Rule Active. Aktiviert oder deaktiviert eine einzelne Blockierungsregel; Standard: 1.
  • Banner Position. Steuert, wo das Banner erscheint; Standard: bottom.
  • Banner Layout. Gespeicherter Layoutwert für das Banner; Standard: bar.
  • Preferences Panel Layout. Öffnet Präferenzen als modal, slide-right oder slide-left; Standard: modal.
  • Animation. Verwendet slide, fade oder none; Standard: slide.
  • Floating Button Position. Platziert die Schaltfläche zum erneuten Öffnen bei bottom-left oder bottom-right; Standard: bottom-left.
  • Floating Button Enabled. Rendert nach der Zustimmung die schwebende Schaltfläche „Cookie Settings“; Standard: 1.
  • Banner Background. Legt die Hintergrundfarbe des Banners fest; Standard: #232323.
  • Banner Text. Legt die Textfarbe des Banners fest; Standard: #f5f5f5.
  • Accept Button Background. Legt den Hintergrund der Akzeptieren-Schaltfläche fest; Standard: #2196f3.
  • Accept Button Text. Legt die Textfarbe der Akzeptieren-Schaltfläche fest; Standard: #ffffff.
  • Reject Button Background. Legt den Hintergrund der Ablehnen-Schaltfläche fest; Standard: transparent.
  • Reject Button Text. Installationsstandard auf dem dunklen Bannerhintergrund des Moduls: #b0b0b0.
  • Customize Button Background. Legt den Hintergrund der Anpassen-Schaltfläche fest; Standard: transparent.
  • Customize Button Text. Installationsstandard auf dem dunklen Bannerhintergrund des Moduls: #b0b0b0.
  • Preferences Background. Legt den Hintergrund des Präferenzpanels fest; Standard: #ffffff.
  • Preferences Text. Legt die Textfarbe des Präferenzpanels fest; Standard: #333333.
  • Toggle Active. Legt die Farbe des aktiven Schalters fest; Standard: #2196f3.
  • Toggle Inactive. Legt die Farbe des inaktiven Schalters fest; Standard: #cccccc.
  • Floating Button Background. Legt den Hintergrund der schwebenden Schaltfläche fest; Standard: #2196f3.
  • Floating Button Icon. Legt die Iconfarbe der schwebenden Schaltfläche fest; Standard: #ffffff.
  • Banner Title. Mehrsprachige Bannerüberschrift; Standard: We respect your privacy.
  • Banner Message. Mehrsprachiger Bannerabsatz; Standard: We use cookies to enhance your browsing experience, serve personalized content, and analyze our traffic. By clicking "Accept All", you consent to our use of cookies.
  • Accept Button. Mehrsprachiger Text der Alle-akzeptieren-Schaltfläche; Standard: Accept All.
  • Reject Button. Mehrsprachiger Text der Alle-ablehnen-Schaltfläche; Standard: Reject All.
  • Customize Button. Mehrsprachiger Text der Präferenz-Schaltfläche; Standard: Customize.
  • Preferences Title. Mehrsprachiger Titel des Präferenzpanels; Standard: Cookie Preferences.
  • Preferences Description. Mehrsprachige Erklärung der Präferenzen; Standard: Choose which cookies you want to allow. You can change these settings at any time. However, blocking some types of cookies may impact your experience of the site.
  • Save Button. Mehrsprachiger Text der Schaltfläche zum Speichern der Präferenzen; Standard: Save Preferences.
  • Accept All (in prefs). Mehrsprachiger Text der Alle-akzeptieren-Schaltfläche innerhalb der Präferenzen; Standard: Accept All.
  • Floating Button Label. Mehrsprachiges Label und Tooltip für die schwebende Schaltfläche; Standard: Cookie Settings.
  • Policy Link Text. Mehrsprachiges Label für den Richtlinienlink; Standard: Cookie Policy.
  • Floating Button Size (px). Legt Breite und Höhe der schwebenden Schaltfläche fest; Standard: 48.
  • Border Radius (px). Legt abgerundete Ecken für Banner, Panel und Schaltflächen fest; Standard: 12.
  • Font Size (px). Legt die Schriftgröße für Banner und Präferenzen fest; Standard: 14.
  • Font Family. Fügt eine eigene font-family vor dem System-Fallback hinzu; Standard: ``.
  • Button Border Color. Legt die Rahmenfarbe für Ablehnen- und Anpassen-Schaltflächen fest; Standard: ``.
  • Show Overlay. Zeigt ein Seiten-Overlay hinter dem Banner oder Präferenzpanel; Standard: 1.
  • Overlay Color. Legt die Overlay-Farbe fest; Standard: rgba(0,0,0,0.5).
  • Show Close (X) Button. Fügt dem Banner eine Schließen-Schaltfläche hinzu; Standard: 0.
  • Close Button Action. Steuert, was passiert, wenn der Besucher auf die X-Schaltfläche klickt: reject speichert die Ablehnung und verhindert, dass das Banner erneut erscheint, accept gewährt alle Zustimmungen, oder dismiss blendet das Banner ohne gespeicherte Zustimmung aus, sodass es beim nächsten Besuch erneut erscheint; Standard: reject.
  • Consent Wall. Verwäscht die Seite, zentriert das Banner als Modal und sperrt das Scrollen, bis der Besucher zustimmt, ablehnt oder die Zustimmung anpasst; Standard: 0.
  • Custom CSS. Speichert zusätzliches CSS, das mit dem Moduldesign ausgegeben wird; Standard: ``.
Cookies Revolution — Admin cookie scanner Cookies Revolution — Admin design

Beispiele zur Anpassung

Verwenden Sie die Ansicht für Skriptregeln, um ein Tracking-Skript per URL zu blockieren, bis die Analyse-Zustimmung erteilt wurde:

Category: analytics
Rule Type: url_pattern
Pattern (Regex): googletagmanager\.com/gtag/js
Description: Google gtag.js
Active: 1

Verwenden Sie eine Script-Content-Regel, wenn der Tracking-Code inline ist:

Category: marketing
Rule Type: script_content
Pattern (Regex): fbq\s*\(
Description: Inline Facebook Pixel
Active: 1

Das Modul schreibt passende externe Skripte wie folgt um, bis die Kategorie akzeptiert wurde:

<script type="text/plain"
        data-cookiecategory="analytics"
        data-original-src="https://www.googletagmanager.com/gtag/js?id=G-XXXX">
</script>

Das Consent-Cookie verwendet kompakte Kategoriewerte. Das ist nützlich, wenn ein anderes eigenes Skript den Browserzustand prüfen muss:

mprcr_consent=necessary:1|functional:0|analytics:1|marketing:0
mprcr_version=1a2b3c4d

Verwenden Sie die öffentliche JavaScript-API in einem Theme oder eigenen Modul, um den aktuellen Browserzustand zu prüfen, und hören Sie auf gespeicherte Consent-Änderungen:

function loadAnalyticsCode() {
  // Load analytics-dependent code here.
}

if (window.MPRCR && window.MPRCR.isGranted('analytics')) {
  loadAnalyticsCode();
}

document.addEventListener('mprcr:consent', function (event) {
  if (event.detail && event.detail.analytics) {
    loadAnalyticsCode();
  }
});

Öffnen Sie das Präferenzpanel über Ihren eigenen Footer-Link:

<a href="#" onclick="event.preventDefault(); window.MPRCR && window.MPRCR.showPreferences();">
  Cookie Settings
</a>

Nützliche Front-Office-CSS-Hooks für das Feld Custom CSS:

.mprcr-banner__inner {
  max-width: 980px;
  margin: 0 auto;
}

.mprcr-btn--accept {
  font-weight: 700;
}

.mprcr-category__desc {
  line-height: 1.6;
}

.mprcr-floating {
  box-shadow: 0 4px 14px rgba(0,0,0,.2);
}

Ein typisches EU-Opt-in-Setup verwendet diese Werte:

DEFAULT_CONSENT = denied
SCRIPT_BLOCKING = 1
GCM_ENABLED = 1
LOG_ENABLED = 1
RECONSENT_ON_CHANGE = 1
Cookies Revolution — Admin cookie catalog Cookies Revolution — Admin integrity

Installation

  1. Gehen Sie in Ihrem PrestaShop Back Office zu Modules → Module Manager.
  2. Klicken Sie auf Upload a module.
  3. Wählen Sie die ZIP-Datei von Cookies Revolution aus.
  4. Klicken Sie auf Install.
  5. Öffnen Sie die Konfigurationsseite des Moduls.
  6. Prüfen Sie die Standardkategorien, registrierten Cookies und Regeln zur Skriptblockierung.
  7. Führen Sie den Cookie-Scanner aus und kategorisieren Sie alle ausstehenden Cookies.
  8. Prüfen Sie Bannertext, Design, Consent-Protokollierung und Richtlinienseite, bevor Sie live gehen.

Nur ein mypresta.rocks Cookie-Consent-Modul kann gleichzeitig aktiv sein. Wenn mprcookiebanner bereits aktiv ist, wird Cookies Revolution erst installiert, wenn das andere Cookie-Modul deaktiviert oder entfernt wurde.

Cookies Revolution — Admin banner design Cookies Revolution — Admin scanner

Funktionsweise

Wenn ein Besucher ankommt, bereitet Cookies Revolution einen Standard-Consent-Zustand vor. Wenn Google Consent Mode v2 aktiviert ist, gibt das Modul im Seitenheader ein standardmäßig verweigertes Consent-Signal aus, wobei security_storage gewährt ist.

Das Banner wird aus einem inerten Template geladen und angezeigt, nachdem der Besucher mit der Seite interagiert. Der Besucher kann alles akzeptieren, optionale Kategorien ablehnen oder das Präferenzpanel öffnen und pro Kategorie wählen. Nachdem eine Auswahl gespeichert wurde, speichert das Modul mprcr_consent und mprcr_version im Browser, aktualisiert Google Consent Mode, aktiviert neu erlaubte Skripte und schreibt optional einen Eintrag ins Consent-Protokoll.

Der Besucher kann Präferenzen später über die schwebende Cookie-Schaltfläche, den Kundenkonto-Link „Cookie Settings“ oder einen eigenen Link mit window.MPRCR.showPreferences() erneut öffnen.

Cookies Revolution — Admin categories list Cookies Revolution — Admin script rules

Ehrliche Grenzen

  • Dieses Modul hilft Ihnen, Cookie-Entscheidungen zu erfassen und zu speichern, ist aber keine Rechtsberatung. Ihre Richtlinientexte, Kategorieauswahl und Tracking-Konfiguration müssen weiterhin zu Ihren rechtlichen Anforderungen passen.
  • Der Scanner erkennt während des Scans Cookies aus Set-Cookie-Headern und einfachem document.cookie = "name=value"-Code. Cookies, die nach Benutzerinteraktion, nach Zustimmung oder innerhalb komplexem Drittanbieter-Code erstellt werden, müssen möglicherweise manuell geprüft werden.
  • Skripte, die bereits ausgeführt wurden, bevor die Zustimmung widerrufen wird, können per JavaScript nicht rückgängig gemacht werden. Das Modul kann registrierte Cookies beim Widerruf löschen und verhindern, dass künftig passende Skripte ausgeführt werden.
  • Re-consent after wird vom Einstellungsformular gespeichert, aber die aktuelle erneute Consent-Prüfung im Frontend basiert auf Änderungen der Consent-Version.
  • Der generierte CMS-Richtlinieninhalt basiert auf den im Modul registrierten Kategorien und Cookies. Erstellen- und Aktualisieren-Aktionen sind manuelle Back-Office-Aktionen; der gespeicherte Schalter CMS_AUTO_UPDATE wird vom aktuellen Quellcode nicht verwendet, um die Seite synchron zu halten.
  • Wenn Sie eine eigene rechtliche Seite verwenden, tragen Sie sie unter Custom Policy URL ein.
  • Der Consent-Protokollexport enthält eine Spalte country_code, aber die aktuelle Protokollierungsmethode befüllt sie nicht.
Cookies Revolution — Admin consent log

Häufig gestellte Fragen

Was ist der Unterschied zwischen diesem Modul und Lightweight Cookie Banner?
Lightweight Cookie Banner ist für einen einfacheren Hinweis zum Akzeptieren/Ablehnen gedacht. Cookies Revolution ergänzt Kategoriepräferenzen, Regeln zur Skriptblockierung, Consent-Protokollierung, Cookie-Scanning, generierte Richtlinieninhalte und Google Consent Mode v2.

Kann Skriptblockierung meinen Shop beschädigen?
Ja, wenn essenzielle checkout-, Login-, Warenkorb-, Zahlungs- oder Sicherheitsskripte optionalen Tracking-Kategorien zugewiesen werden. Halten Sie shopkritische Skripte außerhalb optionaler Blockierungsregeln oder legen Sie sie in eine erforderliche Kategorie.

Blockiert das Modul Google Analytics vor der Zustimmung?
Ja, wenn das relevante Google-Skript zu einer aktiven Analyse-Regel passt und Skriptblockierung aktiviert ist. Das Modul sendet außerdem Google Consent Mode-Standards vor der Zustimmung.

Können Besucher ihre Auswahl später ändern?
Ja. Sie können die Präferenzen über die schwebende Cookie-Schaltfläche, den Kundenkonto-Link, einen eigenen Link oder die öffentliche JavaScript-API erneut öffnen.

Kann ich eigene Kategorien erstellen?
Ja. Sie können Kategorien hinzufügen, mehrsprachige Namen und Beschreibungen schreiben, festlegen, ob sie erforderlich sind, und sie Google Consent Mode-Signalen zuordnen.

Löscht das Modul Cookies, nachdem eine Kategorie abgelehnt wurde?
Wenn ein Besucher Präferenzen speichert und eine zuvor gewährte Kategorie widerruft, versucht das Front-Skript, registrierte Cookies für diese Kategorie zu löschen.

Kann ich Consent-Datensätze exportieren?
Ja. Die Consent-Protokollansicht enthält einen CSV-Export mit Besucher-Hash, IP-Hash, Consent-Daten, Version, Quelle, Ländercode-Spalte und Datum. Die aktuelle Protokollierungsmethode befüllt country_code nicht.

Muss ich nach dem Hinzufügen von Cookies erneut Zustimmung einholen?
Ja, wenn erneute Zustimmung bei Änderungen aktiviert ist. Das Modul aktualisiert die Consent-Version, wenn sich aktive Kategorien oder Cookies ändern, und wiederkehrende Besucher werden erneut um Bestätigung gebeten.

Findet der Scanner jedes mögliche Cookie?
Nein. Er findet Set-Cookie-Header und einfache document.cookie-Zuweisungen während des Scans. Einige Drittanbieter-Cookies erscheinen erst nach Zustimmung oder nach Besucherinteraktion, daher bleibt eine manuelle Prüfung wichtig.

Kann ich eine eigene Cookie-Richtlinienseite verwenden?
Ja. Tragen Sie in den Einstellungen eine eigene Richtlinien-URL ein. Wenn dieses Feld ausgefüllt ist, verwenden Banner und Präferenzpanel diese Seite statt der generierten CMS-Seite.

Kompatibilität: PrestaShop 1.6 bis 9.0 (neueste Version), PHP 7.1+. Wir unterstützen weiterhin kommende PrestaShop-Versionen.

Cookies Revolution — Admin cookie inventory
Nach oben