Matomo Analytics
Matomo-Webanalyse für OXID eShop 7 mit E-Commerce-Tracking, Cookieless-Modus, Do-Not-Track, Klaro-Anbindung und Opt-Out-Widget. Apex-Theme mitgeliefert, Twig-Templates.
Matomo Analytics
Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.
Live Demo: Teste dieses und weitere Plugins live — ohne Installation, ohne Risiko: demo.markus-michalski.net
Überblick
Das Modul bindet Matomo in den OXID eShop 7 ein: Tracking-Code im Storefront, E-Commerce-Tracking für Produktansichten, Warenkorb und Bestellungen, Cookieless-Modus, Do-Not-Track, Anbindung an den Klaro Consent Manager und ein Opt-Out-Widget. Die Templates sind Twig-Templates und für das Apex-Theme mitgeliefert.
Das Modul ist nach der Installation ausgeschaltet. Die Einstellung "IP-Anonymisierung" hat keine Wirkung, anonymisiere IP-Adressen in Matomo selbst. Details: Datenschutz und Einwilligung.
graph TD
A["Seitenaufruf im Storefront"] --> B["Block base_js"]
B --> C{"isMatomoEnabled"}
C -->|"Nein"| D["Kein Tracking-Code"]
C -->|"Ja, Klaro aus"| E["Script läuft sofort"]
C -->|"Ja, Klaro an"| F["Script als text/plain, Klaro führt es nach Einwilligung aus"]
E --> G["Matomo-Server"]
F --> G
Dokumentation
| Seite | Inhalt |
|---|---|
| Installation | Voraussetzungen, Composer, Aktivierung, Update |
| Konfiguration | Alle Einstellungen mit Standardwerten, E-Commerce-Werte, Klaro, Praxisbeispiele |
| Datenschutz und Einwilligung | Was die Datenschutz-Einstellungen im Code bewirken, Consent-Cookies, Klaro-Handler |
| Storefront und Templates | Twig-Templates, eigenes Theme anbinden, Methoden, Opt-Out-Seite und Widget |
| Fehlerbehebung | Tracking-Code fehlt, keine Daten, Klaro, E-Commerce, bekannte Einschränkungen |
| Technische Details | Architektur, Klassen, erzeugter Tracking-Code, Session-Variablen |
Features
| Feature | Beschreibung |
|---|---|
| Tracking-Code | Matomo-JavaScript im Block base_js, nur bei gültiger Konfiguration |
| Cookieless-Modus | Gibt disableCookies aus (Standard: an) |
| Do-Not-Track | Gibt setDoNotTrack aus und liefert ohne Klaro bei DNT: 1 keinen Code aus |
| Consent erforderlich | Gibt requireConsent aus, prüft ohne Klaro ein Consent-Cookie |
| Klaro-Integration | Tracking-Script als text/plain, Handler für setConsentGiven und forgetConsentGiven |
| E-Commerce-Tracking | Produktansicht, Warenkorb-Update, Bestellung |
| Heartbeat-Timer | Optional, mit einstellbarem Intervall |
| Link- und Download-Tracking | Ein gemeinsamer Aufruf enableLinkTracking |
| Opt-Out | Eigene Seite index.php?cl=matomo_optout und einbindbares Widget |
Anforderungen
| Anforderung | Hinweis |
|---|---|
| OXID eShop | oxid-esales/oxideshop-ce ^7.0 |
| PHP | >=8.2 laut composer.json. Der Code nutzt typisierte Klassenkonstanten (PHP 8.3). |
| Matomo | Erreichbar über eine HTTPS-URL |
| Theme | Apex (mitgeliefert), andere Themes brauchen eigene Template-Erweiterungen |
| Lizenz | Erforderlich |
Lizenz
Kommerzielle Lizenz:
- CE/PE Lizenz: Eine OXID eShop Installation
- EE Lizenz: Eine OXID eShop Installation inkl. aller Subshops
Siehe LICENSE-Datei für vollständige Bedingungen.
Support
Bei Fragen und Support erreichst du Markus Michalski unter support@markus-michalski.net.