Sandik Shop-Statistik

Vor der Installation

• Shopware: >= 6.6.0 und < 6.8.0
• PHP: >= 8.2
• Vor Änderungen ein aktuelles Datei- und Datenbankbackup erstellen.
• Bei produktiven Shops empfiehlt sich ein Test in einer Staging-Umgebung.

Welche Datei wird installiert?

Bei einem Kauf über shop.sandik-it.de erhältst du eine fertig installierbare Plugin-ZIP. Diese wird unverändert in Shopware hochgeladen und enthält bereits Lizenzaktivierung, Domainbindung und die Update-Funktion.

Eine über den offiziellen Shopware Store bezogene Version wird über Shopware installiert und aktualisiert. Die Store-Version enthält keine Sandik-Lizenzsperre.

Installation über die Shopware-Administration

1. Vor Änderungen ein aktuelles Shop- und Datenbankbackup erstellen; produktive Shops möglichst zuerst in einer Staging-Umgebung testen.
2. Die nach dem Kauf bereitgestellte Plugin-ZIP herunterladen und unverändert verwenden.
3. In Shopware zu Erweiterungen → Meine Erweiterungen wechseln und „Erweiterung hochladen“ wählen.
4. Die ZIP hochladen, anschließend „Installieren“ und danach „Aktivieren“ ausführen.
5. Die Shopware-Administration vollständig neu laden. Bei Storefront-Plugins anschließend die Storefront kontrollieren.
6. Bei einem Kauf direkt über Sandik-IT erfolgt die Lizenzaktivierung automatisch. Voraussetzung ist, dass die beim Kauf hinterlegte Shop-Domain zur Installation passt.

Alternative: Installation per SSH / CLI

Das Plugin-Verzeichnis muss unter custom/plugins/SandikShopStatistik liegen. Anschließend im Shopware-Hauptverzeichnis:

bin/console plugin:refresh
bin/console plugin:install --activate SandikShopStatistik
bin/console scheduled-task:register
bin/console assets:install
bin/console cache:clear

Manueller Funktionstest

bin/console sandik:statistik:auswerten

Lizenzaktivierung

Ein sichtbarer Lizenzschlüssel muss nicht eingegeben werden. Die über Sandik-IT bezogene Version prüft nach der Aktivierung automatisch die Shop-Domain beim Sandik-Update-System. Die beim Kauf angegebene Shop-URL muss zur Installation passen.

Production ist voll nutzbar. Staging und Development werden als getrennte Umgebungen erkannt und verwenden die jeweils für das Plugin hinterlegten Testlimits. Nach einer erfolgreichen Prüfung steht bei vorübergehender Nichterreichbarkeit des Lizenzservers ein Offline-Puffer zur Verfügung.

Grundkonfiguration

1. Plugin installieren und die Administration vollständig neu laden.
2. Plugin-Konfiguration prüfen; der einfache Gesamt-Aufrufzähler ist standardmäßig aktiv.
3. Für Detailstatistik den Cookie-Dienst im Storefront testen und Zustimmung erteilen.
4. Einen Auswertungslauf starten und anschließend Bestellungen → Shop-Statistik öffnen.
5. Für den Dauerbetrieb entweder den direkten Cronjob oder Shopwares Scheduled Task verwenden.

Scheduled Tasks, Messenger & Cron

Empfohlen ist ein Auswertungslauf alle fünf Minuten. Alternativ kann der registrierte Shopware Scheduled Task zusammen mit dem Messenger verwendet werden. Eine der beiden Varianten genügt.

Empfohlener Cronjob

*/5 * * * * cd /PFAD/ZUM/SHOP && php bin/console sandik:statistik:auswerten --no-interaction

Updates installieren

Bei der über Sandik-IT bezogenen Version werden kompatible Updates über den integrierten Sandik-Updater erkannt. Der Standardmodus ist manuell. Alternativ kann der Sandik App Hub die verfügbaren Updates zentral anzeigen und auslösen.

Vor einem integrierten Update wird ein Dateibackup angelegt. Ein Datei-Rollback ersetzt kein Datenbankbackup, da Datenbankmigrationen bei einem Downgrade nicht automatisch zurückgeführt werden.

Ein manuelles Update kann außerdem durch Hochladen einer neueren Plugin-ZIP über die Shopware-Erweiterungsverwaltung erfolgen. Das Plugin dabei nicht deinstallieren, damit vorhandene Daten und Einstellungen erhalten bleiben.

bin/console plugin:refresh
bin/console plugin:update SandikShopStatistik
bin/console assets:install
bin/console cache:clear

Bei Storefront-Änderungen anschließend das aktive Theme neu kompilieren.

Typische Probleme

• Statistik leer: zunächst einen Auswertungslauf starten und prüfen, ob Ereignisse/Bestellungen verarbeitet werden.
• Menüpunkt fehlt: Administration vollständig neu laden; bei manueller Installation assets:install ausführen.
• Cron meldet PHP-/Pfadfehler: den auf dem Server passenden PHP-Binary und Shop-Pfad verwenden.

Wenn die Installation mit einem HTTP-500-Fehler abbricht, zuerst den Shopware-Logeintrag sowie var/log/ prüfen. Bei Dateirechtefehlern keine pauschalen 777-Rechte setzen, sondern Eigentümer und Schreibrechte der Shopware-Verzeichnisse korrigieren.

Installation & Konfiguration durch Sandik-IT

Wenn du die Einrichtung nicht selbst durchführen möchtest, kann Sandik-IT Installation, Aktivierung, Grundkonfiguration und einen kontrollierten Funktionstest übernehmen.

Installationsservice ansehen ↗