Zum Inhalt springen

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

  1. Erwerben Sie die Erweiterung im JTL-Extension Store. Sie wird dadurch mit Ihrer Shop-Lizenz verknüpft.
  2. Öffnen Sie im JTL-Shop-Backend Plugins → Meine Erweiterungen. Die Erweiterung erscheint dort nach kurzer Zeit automatisch.
  3. Klicken Sie auf Installieren.
  4. Aktivieren Sie das Plugin anschließend im Plugin-Manager unter Installiert, falls es nicht bereits aktiv ist.

Alternative: manuelle Installation (ZIP)

  1. Öffnen Sie im JTL-Shop-Backend Plugins → Plugin-Manager und wählen Sie den Tab Upload.
  2. Laden Sie das Plugin-Paket (ZIP) hoch. Der Ordnername im Archiv (webpowers_matomo_tracking) darf nicht verändert werden.
  3. Wechseln Sie zum Tab Vorhanden, wählen Sie Matomo Analytics Tracking aus und klicken Sie auf Installieren.
  4. 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