English Version

Zurück zur Übersicht

Matomo Analytics: Installation und Betrieb

Voraussetzungen

Installation

Über den Shopware Store (empfohlen)

1. Plugin im Shopware Store erwerben
2. Im Shopware Admin unter Erweiterungen > Meine Erweiterungen das Plugin installieren und aktivieren
3. Cache leeren

Via Composer

1. Privates Repository in der composer.json deines Shops eintragen:

{
    "repositories": [{"type": "composer", "url": "https://packeton.markus-michalski.net"}]
}

Die Zugangsdaten für das Repository erhältst du nach dem Kauf.

2. Plugin installieren:

composer require mmd/sw67-matomo-analytics

3. Plugin aktivieren:

bin/console plugin:refresh
bin/console plugin:install --activate MmdMatomoAnalytics
bin/console cache:clear

Via ZIP-Upload

1. ZIP-Datei unter Erweiterungen > Meine Erweiterungen hochladen
2. Plugin installieren und aktivieren
3. Cache leeren

Nach der Installation

Das Plugin gibt erst dann Tracking-Code aus, wenn Matomo-URL und Site ID eingetragen sind und Tracking aktivieren eingeschaltet ist. Die Einstellungen findest du unter Erweiterungen > Meine Erweiterungen > Matomo Analytics, siehe Konfiguration.

Klaro-Service (automatische Einrichtung)

Bei Installation, Update oder Aktivierung des Plugins wird automatisch ein Klaro-Cookie-Service für Matomo angelegt, sofern zu diesem Zeitpunkt die Tabelle mmd_klaro_cookie_service (Plugin MmdKlaroConsent) existiert und noch kein Service mit dem technischen Namen matomo vorhanden ist. Dafür sorgen zwei unabhängige Mechanismen: eine Datenbank-Migration, die bei Installation und Update läuft, und eine zusätzliche Prüfung beim Aktivieren des Plugins. Beide legen den Service mit denselben Werten an und weisen ihn allen Storefront-Verkaufskanälen zu:

Installierst du MmdKlaroConsent erst nach dem Matomo-Plugin, wird der Service bei der nächsten Aktivierung automatisch nachgezogen: deaktiviere das Matomo-Plugin unter Erweiterungen > Meine Erweiterungen (oder per bin/console plugin:deactivate MmdMatomoAnalytics) und aktiviere es wieder (oder per bin/console plugin:activate MmdMatomoAnalytics). Nur falls das in deiner Umgebung nicht möglich ist, lege den Service als Fallback manuell in der Klaro-Verwaltung an, mit einem technischen Namen, der zur Einstellung Klaro Service-Name passt.

Update

composer update mmd/sw67-matomo-analytics
bin/console plugin:update MmdMatomoAnalytics
bin/console cache:clear

Deine Einstellungen bleiben beim Update erhalten.

Deinstallation

Das Plugin über Erweiterungen > Meine Erweiterungen deinstallieren, oder per Konsole mit bin/console plugin:uninstall MmdMatomoAnalytics. Beim Deinstallieren kannst du wählen, ob die Daten des Plugins behalten werden sollen (im Admin die Option „Daten behalten“, auf der Konsole das Flag --keep-user-data).

Wählst du „Daten behalten“, bleibt alles unverändert, auch ein vorhandener Klaro-Service matomo wird nicht angefasst. Ohne diese Option entfernt die Deinstallation:

• den Klaro-Service matomo samt seinen Übersetzungen, sofern die Tabelle mmd_klaro_cookie_service existiert und ein Service mit diesem technischen Namen gefunden wird
• alle Plugin-Einstellungen (Einträge in system_config mit dem Präfix MmdMatomoAnalytics.config.)

Existiert kein Service mit dem technischen Namen matomo oder die Klaro-Tabelle gar nicht, bleibt dieser Schritt wirkungslos; die Einstellungen werden trotzdem entfernt.

Support

Bei Fragen erreichst du mich unter support@markus-michalski.net.