English Version

Zurück zur Übersicht

Matomo Analytics: Installation und Betrieb

Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.

Installation

Hinweis: Das Plugin ist privat und wird über Packeton verwaltet (https://packeton.markus-michalski.net). Die Zugangsdaten erhältst du nach dem Lizenzkauf.

1. Paket installieren

Trage das Packeton-Repository in die composer.json deines Shops ein:

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

composer require mmd/sylius-matomo-integration-plugin

2. Bundle registrieren

In config/bundles.php:

Mmd\SyliusMatomoIntegrationPlugin\MmdSyliusMatomoIntegrationPlugin::class => ['all' => true],

3. Admin-Routen importieren

Lege die Datei config/routes/mmd_sylius_matomo_integration.yaml an:

mmd_sylius_matomo_integration_admin:
    resource: "@MmdSyliusMatomoIntegrationPlugin/config/routes/admin.yaml"

Das Storefront braucht keine eigenen Routen, das Plugin definiert dafür keine. Admin-Grid, Twig-Hooks, die Shop-API-Ressource und das Doctrine-Mapping registriert das Bundle selbst.

4. Setup-Befehl ausführen

bin/console mmd:matomo-integration:setup

Der Befehl legt die Tabelle mmd_sylius_matomo_channel_settings an. Er verhält sich so:

• Er führt nur die noch offenen Migrationen dieses Plugins aus, nichts von deiner App oder anderen Plugins.
• Er ist idempotent: Ohne neue Migration passiert nichts, auch nach jedem composer update ist er gefahrlos.
• Er prüft, ob die Admin-Routen aus Schritt 3 importiert sind, und gibt andernfalls den YAML-Ausschnitt aus. Er schreibt nie in config/.
• Er bricht ab, wenn Migrationen von Sylius selbst noch offen sind, auf denen das Plugin aufbaut. Führe dann zuerst bin/console doctrine:migrations:migrate aus und starte den Befehl erneut.
• Er fragt interaktiv um Bestätigung. In Skripten übergibst du --no-interaction.

Alternativ funktioniert auch bin/console doctrine:migrations:migrate. Das führt aber alle offenen Migrationen deines Projekts aus, der Setup-Befehl nur die dieses Plugins.

Die Migration läuft nur auf MySQL 8 und MariaDB und bricht auf anderen Datenbanken ab. Installiere das Plugin nicht in einem Projekt auf PostgreSQL oder SQLite.

5. Channel einrichten

Nach der Installation ist noch nichts aktiv: Ein neuer Eintrag ist ausgeschaltet. Öffne MMKreativ Plugins > Matomo Analytics im Admin und richte deinen ersten Channel ein, siehe Konfiguration.

Update

composer update mmd/sylius-matomo-integration-plugin
bin/console mmd:matomo-integration:setup
bin/console cache:clear

Der Setup-Befehl ist idempotent und führt nur neue Migrationen aus. Die installierte Version zeigt der Admin in der Kopfzeile der Seite Matomo Analytics an.

Cronjobs

Das Plugin braucht keine Cronjobs und liefert keine Befehle aus, die du regelmäßig ausführen musst.

Deinstallation

Halte diese Reihenfolge ein, denn die Migration lässt sich nur zurückrollen, solange das Bundle noch registriert ist:

1. Tabelle entfernen, solange das Bundle noch registriert ist:

   bin/console doctrine:migrations:execute --down 'Mmd\SyliusMatomoIntegrationPlugin\Migrations\Version20261004100000'
   

2. Die Datei config/routes/mmd_sylius_matomo_integration.yaml löschen und die Zeile des Bundles aus config/bundles.php entfernen.

3. Paket entfernen:

   composer remove mmd/sylius-matomo-integration-plugin
   

Das Plugin legt keine Templates in deinem Projekt an, die du zusätzlich entfernen müsstest. Ein Klaro-Dienst, den das Plugin angelegt hat, bleibt im Katalog des Klaro-Plugins bestehen. Entferne ihn bei Bedarf im Klaro-Admin.