Shopware Updates und ThemeWare®
In dieser Anleitung erfährst du, wie du vorgehen sollst, wenn du Shopware 6 gemeinsam mit ThemeWare® aktualisieren bzw. updaten musst.
Wir veröffentlichen regelmäßig Updates von ThemeWare®. Die meisten ThemeWare® Updates machst du unabhängig von Shopware Updates.
Es gibt aber natürlich auch Fälle in denen du ein Shopware Update durchführen möchtest. In diesen Fällen ist es immer sinnvoll vorab bzw. danach Erweiterungen (Plugins, Apps oder Themes) zu aktualisieren.
Ob du Erweiterungen vor oder nach dem Shopware-Update aktualisieren musst hängt von der Kompatibilität der Erweiterungen (Plugins, Apps oder Themes) ab.
Hier ist auch die Art des Shopware-Releases zu beachten, denn es gibt verschiedene Arten von Shopware-Releases:
Shopware Versionierung
Major-Release
Wenn inkompatible API-Änderungen durchgeführt wurden (= breaking changes)
z.B. 6.5 > 6.6
Minor-Release
Wenn eine neue Funktionalität hinzugefügt wurde, die rückwärtskompatibel ist
z.B. 6.5.1 > 6.5.2
Patch-Release
Wenn rückwärtskompatible Fehlerbehebungen durchgeführt wurden
z.B. 6.5.1.1 > 6.5.1.2
Kompatibilität
Grundsätzlich ist ThemeWare® immer mit der aktuellsten Shopware Version kompatibel bzw. wird kurzfristig in einer kompatiblen Version veröffentlicht. Dementsprechend gibt es für ältere Shopware Versionen auch immer eine passende ThemeWare® Version.
Da wir ThemeWare® in jedem neuen Shopware-Release testen, kann es – abhängig davon, wie umfangreich die nötigen Anpassungen sind – vorkommen, dass sich ein ThemeWare® Update erst kurz nach dem Shopware-Update veröffentlicht wird.
Major-Releases
Es kann aber vorkommen, dass es keine ThemeWare® Version (dies gilt so übrigens für alle Erweiterungen) gibt, welche – gleichzeitig – sowohl mit der alten als auch mit der neuen Shopware Version kompatibel ist. Dies gilt immer dann, wenn Shopware sogenannte "Breaking Changes" macht, die eine Kompatibilität mit beiden Versionen unmöglich machen.
Wie du oben in der "Shopware Versionierung" sehen kannst, sind "Breaking Changes" vor allem in Major-Releases möglich.
Wichtig: Nutze stets die Update-Funktion der Erweiterungsverwaltung und installiere Erweiterungen nicht manuell um zu vermeiden, dass du eine inkompatible Erweiterung installierst.
Shopware-Update
Der Shopware-Update-Assistent informiert dich falls es inkompatible Erweiterungen gibt. Inkompatible Erweiterungen müssen vor dem Shopware-Update unbedingt deaktiviert werden und sollten erst aktiviert werden, wenn eine kompatible Version veröffentlicht wurde.
Schritt-für-Schritt Anleitung:
Nachfolgend findest du eine Schritt-für-Schritt Anleitung für Shopware Updates. Grundsätzlich gibt es dabei vier mögliche Fälle:
Diese vier Fälle berücksichtigt unsere nachfolgende Anleitung.
Tipp: Das meiste in dieser Anleitung gilt so übrigens für alle Erweiterungen (Plugins, Apps oder Themes), wir beziehen uns aber der Einfachheit halber auf ThemeWare®.
1) Vorbereitung
Wir empfehlen mit Shopware Updates – insbesondere bei Major-Releases von dem Update – nach Möglichkeit – ein paar Tage/Wochen mit dem Update zu warten.
Tipp: Warte besonders bei Major-Releases von Shopware ein paar Tage/Wochen mit dem Shopware-Update.
Teste jedes Update vorab in einem Testsystem oder einer Staging-Umgebung und prüfe ob alles reibungslos funktioniert.
Erstelle zudem unbedingt ein vollständiges Backup deines Shops vor dem Shopware-Update.
Tipp: Erstelle vor dem Shopware-Update ein vollständiges Backup deines Shops und teste das Update vorab in einem Test- bzw. Staging-System.
Aktualisiere ThemeWare® und alle Erweiterungen (Plugins, Apps oder Themes) in deinem System auf die aktuellsten Versionen.
Wichtig: Aktualisiere vor jedem Shopware-Update alle Erweiterungen (Plugins, Apps oder Themes) in deinem System.
Prüfe ob es für alle Erweiterungen (Plugins, Apps oder Themes) bzw. Themes schon eine kompatible Version gibt.
Führe das Shopware-Update am besten nur dann durch, wenn du sichergestellt hast, das alle genutzten Erweiterungen in einer kompatiblen und fehlerfreien Version installiert sind.
Möchtest du das Shopware-Update durchführen, auch wenn nicht alle genutzten Erweiterungen kompatibel sind, lasse inkompatible Erweiterungen solange deaktiviert, bis du eine kompatible Version installieren konntest.
Wichtig: Deaktiviere am besten alle Erweiterungen vor dem Shopware-Update und aktiviere diese erst, wenn diese in einer kompatiblen Version installiert sind.
2) Shopware-Update
Kommen wir nun zum eigentlichen Update. Es gibt bei Shopware-Updates vier Möglichkeiten:
A. Bereits kompatibel
ThemeWare® ist bereits mit der aktuellen als auch mit der neuen Shopware Version kompatibel:
Optional: Weise das "Shopware default theme" deinem Verkaufskanal zu
Optional: Deaktiviere danach dein ThemeWare® Theme
Tipp: Leere einmal den gesamten Shopware-Cache
Optional: Führe ein ThemeWare® Update aus
Führe das Shopware-Update aus
Wichtig: Nur wenn wirklich alle Erweiterungen "Bereits kompatibel" sind!
Optional: Aktiviere ThemeWare® nun wieder
Tipp: Leere einmal den gesamten Shopware-Cache
Optional: Weise ThemeWare® zum Abschluss deinem Verkaufskanal zu
Leere einmal den gesamten Shopware-Cache und lade die Administration neu
B. Jetzt verfügbar
Eine kompatible ThemeWare® Version ist vor dem Shopware-Update verfügbar:
Weise das "Shopware default theme" deinem Verkaufskanal zu
Deaktiviere danach dein ThemeWare® Theme
Tipp: Leere einmal den gesamten Shopware-Cache
Führe das ThemeWare® Update aus
Führe nun das Shopware-Update aus
Wichtig: Nur wenn wirklich alle Erweiterungen "Bereits kompatibel" sind!
Aktiviere ThemeWare® anschließend wieder
Tipp: Leere einmal den gesamten Shopware-Cache
Weise ThemeWare® zum Abschluss deinem Verkaufskanal zu
Leere einmal den gesamten Shopware-Cache und lade die Administration neu
C. Mit der neuen Shopware Version
Eine kompatible ThemeWare® Version ist nach dem Shopware-Update verfügbar:
Weise das "Shopware default theme" deinem Verkaufskanal zu
Deaktiviere danach dein ThemeWare® Theme
Leere einmal den gesamten Shopware-Cache
Führe das Shopware-Update aus
Führe nun das ThemeWare® Update aus
Aktiviere ThemeWare® (in der kompatiblen Version) anschließend wieder
Tipp: Leere einmal den gesamten Shopware-Cache
Weise ThemeWare® zum Abschluss deinem Verkaufskanal zu
Leere einmal den gesamten Shopware-Cache und lade die Administration neu
Achtung: Aktiviere keine inkompatible Version einer Erweiterung in deinem Shopware-Shop!
In diesem Szenario ist die alte ThemeWare® Version nicht mit der neuen Shopware Version und die neue ThemeWare® Version nicht mit der alten Shopware Version kompatibel.
D. Nicht kompatibel
Eine kompatible ThemeWare® Version für die neue Shopware Version ist noch NICHT verfügbar:
Gibt es von ThemeWare® noch keine kompatible Version für den neuen Shopware Release, warte mit dem Shopware-Update bis dies der Fall ist.
Wenn du dennoch das Shopware-Update durchführen möchtest, lasse ThemeWare® (bzw. jede inkompatible Erweiterung) solange deaktiviert, bist du ein Update auf eine kompatible Version machen konntest.
Fehlerbehebung
Hoffentlich hast du die Hinweise bezüglich der Erstellung eines Backups und dem Testen in einem Staging-System berücksichtigt und du kannst dein Backup wieder einspielen bzw. einen neuen Testlauf starten.
Ist die Administration aufgrund einer inkompatiblen Erweiterung nicht erreichbar, deaktiviere die entsprechende Erweiterung über die Datenbank (siehe ThemeWare® über die Datenbank deaktivieren). Danach sollte die Administration wieder funktionieren.
Update-Leitfaden 💡
Beachte bei Updates von ThemeWare® stets unseren Update-Leitfaden:
Weiterfürhende Informationen
Last updated
Was this helpful?
