DSGVO-konforme Cookie-Verwaltung für OXID eShop 7.x mit der Open-Source Klaro-Bibliothek.
Wichtig: Dieses Modul ist vollständig selbst-gehostet. Die Klaro JavaScript-Bibliothek ist im Modul gebündelt und wird direkt von deinem Shop-Server ausgeliefert. Es werden keine Daten an externe Services gesendet - weder an Klaro/KIProtect noch an andere Drittanbieter.
Das bedeutet:
| Feature | Beschreibung |
|---|---|
| Selbst-gehostet | Klaro-Bibliothek lokal gebündelt - keine externen Abhängigkeiten |
| Google Consent Mode v2 | Bereit für Googles Anforderungen seit März 2024 |
| Multi-Shop | Unterschiedliche Konfigurationen pro Shop (Enterprise Edition) |
| Admin UI | Cookie-Services direkt im OXID Admin verwalten |
| Anpassbares Styling | Farben, Position, Hell/Dunkel-Theme |
| Cookie-Löschung | Automatische Bereinigung bei Widerruf der Einwilligung |
| Kontextuelle Einwilligung | Einwilligung pro Embed für YouTube, Vimeo etc. |
| Mehrsprachig | Deutsch und Englisch vorinstalliert |
Füge das private Composer-Repository zur composer.json deines Shops hinzu:
{
"repositories": [
{
"type": "composer",
"url": "https://packeton.markus-michalski.net"
}
]
}
Hinweis: Die Repository-Zugangsdaten werden nach dem Lizenzkauf bereitgestellt. Private Repositories werden über Packeton verwaltet.
composer require mmd/klaro-consent
Bei der Authentifizierungsabfrage die mit der Lizenz erhaltenen Zugangsdaten eingeben.
vendor/bin/oe-console oe:module:install source/modules/mmd/klaro-consent
vendor/bin/oe-console oe:module:activate mmd_klaro_consent
vendor/bin/oe-console oe:cache:clear
Update auf die neueste Version:
composer update mmd/klaro-consent
vendor/bin/oe-console oe:cache:clear
Navigiere zu Erweiterungen > Module > Klaro Cookie Consent > Einstellungen zur Konfiguration:
| Einstellung | Standard | Beschreibung |
|---|---|---|
| Aktiv | Aus | Aktivieren/Deaktivieren des Consent-Dialogs |
| Datenschutz-URL | /datenschutz | Link zu deiner Datenschutzerklärung |
| Position | unten | Banner-Position: unten, oben, unten-links, unten-rechts |
| Theme | hell | Visuelles Theme: hell oder dunkel |
| Einwilligung erforderlich | An | Benutzer muss eine Auswahl treffen vor dem Schließen |
| Alle akzeptieren Button | An | "Alle akzeptieren" Button anzeigen |
| Alle ablehnen verstecken | Aus | "Alle ablehnen" Button verstecken |
| Google Consent Mode | Aus | Google Consent Mode v2 Integration aktivieren |
Passe die Button-Farben an dein Shop-Design an:
| Einstellung | Standard | Beschreibung |
|---|---|---|
| Primärfarbe | #1a73e8 | "Alle akzeptieren" Button |
| Sekundärfarbe | #2581c4 | "Auswahl speichern" Button |
| Ablehnen-Farbe | #5c5c5c | "Alle ablehnen" Button |
Navigiere zu Kundeninformationen > Klaro Cookie Consent um deine Cookie-Services zu verwalten.
Jeder Service repräsentiert ein Drittanbieter-Script oder Cookie, das Benutzereinwilligung erfordert:
| Feld | Erforderlich | Beschreibung |
|---|---|---|
| Technischer Name | Ja | Eindeutiger Bezeichner (Kleinbuchstaben, Bindestriche erlaubt, z.B. google-analytics) |
| Titel | Ja | Anzeigename für Benutzer |
| Beschreibung | Ja | Erkläre was dieser Service macht und warum er benötigt wird |
| Zweck | Ja | Kategorie: functional, analytics, marketing, security |
| Erforderlich | Nein | Essentieller Service, der nicht deaktiviert werden kann |
| Standard aktiviert | Nein | Vorausgewählt (nicht DSGVO-empfohlen) |
| Aktiv | Ja | Service aktivieren/deaktivieren |
Wenn ein Benutzer seine Einwilligung widerruft, kann Klaro automatisch die zugehörigen Cookies löschen. Konfiguriere Cookies im JSON-Format:
[
{"pattern": "_ga", "path": "/", "domain": ".example.com"},
{"pattern": "_gid"},
{"pattern": "_gat"}
]
| Feld | Erforderlich | Beschreibung |
|---|---|---|
| pattern | Ja | Cookie-Name oder Regex-Muster |
| path | Nein | Cookie-Pfad (Standard: /) |
| domain | Nein | Cookie-Domain (Standard: aktuelle Domain) |
Technischer Name: google-analytics
Titel (DE): Google Analytics
Titel (EN): Google Analytics
Beschreibung (DE): Webanalyse-Dienst, der uns hilft zu verstehen, wie Besucher unsere Website nutzen. Sammelt anonyme Nutzungsdaten.
Beschreibung (EN): Web analytics service that helps us understand how visitors use our website. Collects anonymous usage data.
Zweck: analytics
Cookies:
[
{"pattern": "_ga", "path": "/", "domain": ".dein-shop.de"},
{"pattern": "_ga_*"},
{"pattern": "_gid"},
{"pattern": "_gat"}
]
Technischer Name: youtube
Titel (DE): YouTube
Titel (EN): YouTube
Beschreibung (DE): Eingebettete Videos von YouTube. YouTube kann Cookies setzen und Daten erfassen, wenn Sie Videos ansehen.
Beschreibung (EN): Embedded videos from YouTube. YouTube may set cookies and collect data when you watch videos.
Zweck: marketing
Nur kontextuelle Einwilligung: Ja (zeigt Platzhalter bis Benutzer einwilligt)
Cookies:
[
{"pattern": "VISITOR_INFO1_LIVE", "domain": ".youtube.com"},
{"pattern": "YSC", "domain": ".youtube.com"},
{"pattern": "GPS", "domain": ".youtube.com"}
]
Technischer Name: facebook-pixel
Titel (DE): Facebook Pixel
Titel (EN): Facebook Pixel
Beschreibung (DE): Verfolgt Conversions und ermöglicht zielgerichtete Werbung auf Facebook und Instagram.
Beschreibung (EN): Tracks conversions and enables targeted advertising on Facebook and Instagram.
Zweck: marketing
Cookies:
[
{"pattern": "_fbp"},
{"pattern": "fr", "domain": ".facebook.com"}
]
Technischer Name: google-maps
Titel (DE): Google Maps
Titel (EN): Google Maps
Beschreibung (DE): Ermöglicht die Einbindung von Google Maps für interaktive Standortkarten.
Beschreibung (EN): Enables Google Maps integration for interactive location maps.
Zweck: functional
Nur kontextuelle Einwilligung: Ja
Cookies:
[
{"pattern": "NID", "domain": ".google.com"},
{"pattern": "CONSENT", "domain": ".google.com"}
]
Technischer Name: matomo
Titel (DE): Matomo Analytics
Titel (EN): Matomo Analytics
Beschreibung (DE): Selbst-gehostete Webanalyse. Alle Daten bleiben auf unserem Server.
Beschreibung (EN): Self-hosted web analytics. All data stays on our server.
Zweck: analytics
Cookies:
[
{"pattern": "_pk_id"},
{"pattern": "_pk_ses"},
{"pattern": "_pk_ref"}
]
Wenn aktiviert, initialisiert das Modul automatisch Google Consent Mode v2 mit abgelehnten Standardwerten:
gtag('consent', 'default', {
'ad_storage': 'denied',
'analytics_storage': 'denied',
'ad_user_data': 'denied',
'ad_personalization': 'denied'
});
Wenn Benutzer die Einwilligung für Analytics/Marketing-Services erteilen, wird der Consent-Status entsprechend aktualisiert.
Seit März 2024 erfordert Google den Consent Mode v2 für:
Ohne ordnungsgemäße Consent-Signale funktionieren diese Features im EWR nicht.
Das Modul fügt automatisch einen "Cookie-Einstellungen" Link zum Shop-Footer hinzu. Benutzer können darauf klicken um ihre Einwilligungs-Präferenzen jederzeit zu ändern.
Kommerzielle Lizenz - Einzelinstallations-Lizenz:
Entwicklungs- und Staging-Umgebungen inklusive. 12 Monate kostenlose Updates.
Siehe LICENSE-Datei für vollständige Bedingungen.
Bei Fragen und Support:
Markus Michalski
E-Mail: support@markus-michalski.net