Plugin-Dokumentation · JTL-Shop 5
Matomo Analytics Tracking — Installation
Setup-Guide für die Installation des Plugins in JTL-Shop 5. Dauer: ca. 5–10 Minuten.
Wichtiger Hinweis vorab
Dieses Plugin erfordert einen eigenen oder gehosteten Matomo-Server — dieser ist nicht im Lieferumfang enthalten. Ohne erreichbaren Matomo-Server kann das Plugin keine Daten aufzeichnen. Das Tracking ist standardmäßig an den JTL Consent Manager gekoppelt und startet erst nach ausdrücklicher Einwilligung des Besuchers (Fail-Closed); zusätzlich respektiert es den Do-Not-Track-Header des Browsers.
Voraussetzungen
- JTL-Shop: Version 5.2.0 oder neuer (getestet bis 5.7.x), NOVA-Template
- PHP: 8.1 oder neuer
- Matomo-Server: eigener oder gehosteter Matomo-Server mit erreichbarer URL und Site-ID
- Datenbank: keine eigenen Tabellen im Shop, keine Schema-Änderungen
- JTL Consent Manager: aktiviert empfohlen; ohne Consent Manager findet aus rechtlichen Gründen kein Tracking statt
- Sonstiges: keine Cron-Jobs erforderlich
Installation über den JTL-Extension Store
- Erwerben Sie die Erweiterung im JTL-Extension Store. Sie wird dadurch mit Ihrer Shop-Lizenz verknüpft.
- Öffnen Sie im JTL-Shop-Backend Plugins → Meine Erweiterungen. Die Erweiterung erscheint dort nach kurzer Zeit automatisch.
- Klicken Sie auf Installieren.
- Aktivieren Sie das Plugin anschließend im Plugin-Manager unter Installiert, falls es nicht bereits aktiv ist.
Alternative: manuelle Installation (ZIP)
- Öffnen Sie im JTL-Shop-Backend Plugins → Plugin-Manager und wählen Sie den Tab Upload.
- Laden Sie das Plugin-Paket (ZIP) hoch. Der Ordnername im Archiv (
webpowers_matomo_tracking) darf nicht verändert werden. - Wechseln Sie zum Tab Vorhanden, wählen Sie Matomo Analytics Tracking aus und klicken Sie auf Installieren.
- Aktivieren Sie das Plugin unter Installiert.
Nach der Installation
Öffnen Sie Installierte Plugins → Matomo Analytics Tracking → Einstellungen, aktivieren Sie das Tracking und tragen Sie Matomo-URL sowie Site-ID Ihrer Matomo-Installation ein. Stellen Sie sicher, dass der JTL Consent Manager aktiv ist und ein Consent-Eintrag für „Matomo Analytics“ existiert. Details zu allen Einstellungen finden Sie in der Konfigurationsanleitung unter webpowers.org/docs/jtl-matomo-tracking/konfiguration.
Deinstallation
Das Plugin kann jederzeit über den Plugin-Manager deinstalliert werden. Es legt keine eigenen Datenbanktabellen im Shop an und hinterlässt keine serverseitigen Restdaten. Bereits an Matomo übertragene Daten verbleiben auf Ihrem Matomo-Server und sind dort zu verwalten.
Support
webpowers UG (haftungsbeschränkt) · Hillenbrandstr. 9, 86156 Augsburg · E-Mail: max@webpowers.org
