Vor der Installation
- Shopware: >= 6.5.8.25 und < 6.8.0
- PHP: >= 8.1
- 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
- Vor Änderungen ein aktuelles Shop- und Datenbankbackup erstellen; produktive Shops möglichst zuerst in einer Staging-Umgebung testen.
- Die nach dem Kauf bereitgestellte Plugin-ZIP herunterladen und unverändert verwenden.
- In Shopware zu Erweiterungen → Meine Erweiterungen wechseln und „Erweiterung hochladen“ wählen.
- Die ZIP hochladen, anschließend „Installieren“ und danach „Aktivieren“ ausführen.
- Die Shopware-Administration vollständig neu laden. Bei Storefront-Plugins anschließend die Storefront kontrollieren.
- 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/SandikOrderWatchdog liegen. Anschließend im Shopware-Hauptverzeichnis:
bin/console plugin:refresh
bin/console plugin:install --activate SandikOrderWatchdog
bin/console scheduled-task:register
bin/console assets:install
bin/console cache:clear
Manueller Funktionstest
bin/console scheduled-task:run-single sandik.order_watchdog.scan
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
- Plugin-Konfiguration öffnen.
- Zeitgrenzen und zu überwachende Bestellfälle definieren.
- Empfänger für Benachrichtigungen hinterlegen.
- Scheduled Tasks registrieren und einen manuellen Testlauf starten.
- Die Watchdog-Übersicht im Bestellbereich prüfen.
Scheduled Tasks, Messenger & Cron
Im Dauerbetrieb müssen Shopwares scheduled-task:run und der Messenger regelmäßig ausgeführt werden.
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 SandikOrderWatchdog
bin/console assets:install
bin/console cache:clear
Typische Probleme
- Keine Fälle erscheinen: konfigurierte Zeitgrenzen und Bestellstatus prüfen.
- Keine Benachrichtigung: Empfänger und Shopware-Mailer prüfen.
- Task läuft nicht: scheduled-task:register ausführen und Scheduler/Messenger kontrollieren.
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.