Vor der Installation
- Shopware: >= 6.6.10.19 und < 6.7.0.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
- 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/SandikVacationNotice liegen. Anschließend im Shopware-Hauptverzeichnis:
bin/console plugin:refresh
bin/console plugin:install --activate SandikVacationNotice
bin/console assets:install
bin/console cache:clear
bin/console theme:compile
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 für den gewünschten Verkaufskanal öffnen.
- Bis zu drei Urlaubszeiträume mit Vorankündigung und aktivem Zeitraum hinterlegen.
- Anzeigeort Header oder Produktdetailseite auswählen.
- Zeitzone prüfen; Standard ist Europe/Berlin.
- Storefront und eine Produktdetailseite testen.
Scheduled Tasks, Messenger & Cron
Für die eigentliche Urlaubsmeldung ist kein fachlicher Scheduled Task erforderlich; die Zeiträume werden anhand der aktuellen Zeit ausgewertet.
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 SandikVacationNotice
bin/console assets:install
bin/console cache:clear
Bei Storefront-Änderungen anschließend das aktive Theme neu kompilieren.
Typische Probleme
- Meldung fehlt: Verkaufskanal, Zeitraum, Zeitzone und Anzeigeort prüfen.
- Nach Konfigurationsänderung weiterhin alter Stand: Cache leeren und Theme kompilieren.
- Direct-Lizenz nicht gefunden: Shop-Domain im Kauf/Lizenzserver mit der produktiven Domain vergleichen.
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.