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?
Für den App Hub erhältst du ebenfalls eine fertig installierbare Plugin-ZIP. Der Hub ist kostenlos und benötigt keine Kauf-Lizenz.
Der App Hub ist Direct-only und wird nicht über den Shopware Store ausgeliefert.
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.
- Der App Hub benötigt keine Kauf-Lizenz. Die Installation registriert sich für Direct-Updates automatisch kostenfrei am Sandik-Update-System.
Alternative: Installation per SSH / CLI
Das Plugin-Verzeichnis muss unter custom/plugins/SandikAppHub liegen. Anschließend im Shopware-Hauptverzeichnis:
bin/console plugin:refresh
bin/console plugin:install --activate SandikAppHub
bin/console assets:install
bin/console cache:clear
Kostenlose Registrierung
Der App Hub ist kostenlos. Beim ersten erfolgreichen Check wird die Installation am Sandik-Update-System registriert, damit Version, Installation und Direct-Updates verwaltet werden können. Es wird keine Kauf-Lizenz benötigt.
Grundkonfiguration
- App Hub installieren und aktivieren.
- Shopware-Administration vollständig neu laden.
- Den Sandik App Hub öffnen; installierte Sandik-Erweiterungen werden automatisch erkannt.
- Status, Lizenz, Umgebung und verfügbare Updates prüfen.
- Optional für kompatible Plugins Update-Modus oder Rollback zentral verwalten.
Scheduled Tasks, Messenger & Cron
Der App Hub ist optional. Jedes kompatible Sandik-Kaufplugin bleibt ohne App Hub eigenständig. Der Hub registriert seine Installation kostenfrei am Sandik-Update-System, damit Direct-Updates und Installationsstatus bereitgestellt werden können.
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 SandikAppHub
bin/console assets:install
bin/console cache:clear
Typische Probleme
- Plugin wird im Hub nicht angezeigt: Administration neu laden und prüfen, ob es ein installiertes Sandik-Plugin ist.
- PLUGIN_NOT_FOUND: das jeweilige Plugin/Release ist noch nicht korrekt im zentralen Updater hinterlegt.
- LICENSE_NOT_FOUND: für ein kostenpflichtiges Direct-Plugin fehlt eine Lizenz für die erkannte Shop-Domain.
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.