# Shopware Updates und ThemeWare® 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. {% hint style="info" %} **Hinweis**: Wie du ThemeWare® aktualisieren kannst erfährst du im Artikel [ThemeWare® updaten](/wissensdatenbank/anleitungen/administration/themeware-update-durchfuehren.md). {% endhint %} 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. {% hint style="info" %} **Hinweis**: Mehr Informationen zum Thema "Shopware Kompatibilität" findest du in unserem Artikel [Shopware Kompatibilität](/wissensdatenbank/grundwissen/shopware-kompatibilitaet.md). {% endhint %} {% hint style="success" %} **Tipp**: Mehr Informationen über mögliche Inkompatibilitäten oder Hinweise zu Updates findest du im Bereich [Neuigkeiten und Ankündigungen](https://service.themeware.design/news) in unserem Service Portal. {% endhint %} {% hint style="warning" %} **Wichtig**: Nutze stets die Update-Funktion der Erweiterungsverwaltung und installiere Erweiterungen nicht manuell um zu vermeiden, dass du eine inkompatible Erweiterung installierst. {% endhint %} *** ## 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. {% hint style="info" %} **Hinweis**: Das "Deaktivieren" von Erweiterungen (Plugins, Apps oder Themes) löscht keine Daten. *(Stand: Shopware 6.6)* {% endhint %} #### 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: 1. Ist die aktuelle Version von ThemeWare® sowohl **mit der aktuellen als auch mit der neuen Shopware Version kompatibel**, kannst du Shopware problemlos updaten ([A](#a.-bereits-kompatibel)). 2. Ist die aktuelle Version von ThemeWare® **nicht** mit der neuen Shopware Version kompatibel aber es gibt eine **kompatible ThemeWare® Version für die aktuelle und die neue Shopware** Version, aktualisiere vor dem Shopware-Update zuerst ThemeWare® ([B](#b.-jetzt-verfuegbar)). 3. Ist die aktuelle Version von ThemeWare® **nicht** mit der neuen Shopware Version kompatibel aber es gibt eine **kompatible Version für die neue Shopware Version**, deaktiviere ThemeWare®, aktualisiere erst Shopware und dann ThemeWare® ([C](#c.-mit-der-neuen-shopware-version)). 4. Ist die aktuelle Version von ThemeWare® **nicht** mit der neuen Shopware Version kompatibel und gibt es derzeit **keine kompatible ThemeWare® Version**, deaktiviere ThemeWare®, führe das Shopware-Update aus und aktiviere ThemeWare® erst wieder nachdem du es aktualisieren konntest ([D](#c.-nicht-kompatibel)). Diese vier Fälle berücksichtigt unsere nachfolgende Anleitung. {% hint style="success" %} **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®. {% endhint %} *** ## 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. {% hint style="success" %} **Tipp**: Warte besonders bei Major-Releases von Shopware ein paar Tage/Wochen mit dem Shopware-Update. {% endhint %} 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. {% hint style="success" %} **Tipp**: Erstelle vor dem Shopware-Update ein **vollständiges Backup** deines Shops und **teste das Update** vorab in einem Test- bzw. Staging-System. {% endhint %} Aktualisiere ThemeWare® und alle Erweiterungen (Plugins, Apps oder Themes) in deinem System auf die aktuellsten Versionen. {% hint style="warning" %} **Wichtig**: Aktualisiere vor jedem Shopware-Update alle Erweiterungen (Plugins, Apps oder Themes) in deinem System. {% endhint %} 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. {% hint style="success" %} **Tipp**: Wenn du sicher gehen möchtest ob eine Erweiterung bereits kompatible ist, kannst du auf der Store-Seite der entsprechenden Erweiterung im [Shopware Store](https://store.shopware.com/tc-innovations-gmbh.html?p=1\&o=12\&n=21\&c=1033\&shopwareVersion=6) prüfen, welche Versionen aktuell unterstützt werden. {% endhint %} 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. {% hint style="warning" %} **Wichtig**: Deaktiviere am besten alle Erweiterungen vor dem Shopware-Update und aktiviere diese erst, wenn diese in einer kompatiblen Version installiert sind. {% endhint %} *** ## 2) Shopware-Update Kommen wir nun zum eigentlichen Update. Es gibt bei Shopware-Updates vier Möglichkeiten: * [#a.-bereits-kompatibel](#a.-bereits-kompatibel "mention") * [#b.-jetzt-verfugbar](#b.-jetzt-verfugbar "mention") * [#c.-mit-der-neuen-shopware-version](#c.-mit-der-neuen-shopware-version "mention") * [#d.-nicht-kompatibel](#d.-nicht-kompatibel "mention") ### A. Bereits kompatibel #### ThemeWare® ist bereits mit der aktuellen als auch mit der neuen Shopware Version kompatibel: ![Bereits kompatibel](/files/WLlyUAJZplCRn5GXwmIA) 1. *Optional*: Weise das "Shopware default theme" deinem Verkaufskanal zu 2. *Optional*: Deaktiviere danach dein ThemeWare® Theme * **Tipp**: Leere einmal den gesamten Shopware-Cache 3. *Optional*: Führe ein ThemeWare® Update aus 4. Führe das Shopware-Update aus * **Wichtig**: Nur wenn wirklich *alle* Erweiterungen "Bereits kompatibel" sind! 5. *Optional*: Aktiviere ThemeWare® nun wieder * **Tipp**: Leere einmal den gesamten Shopware-Cache 6. *Optional*: Weise ThemeWare® zum Abschluss deinem Verkaufskanal zu 7. Leere einmal den gesamten Shopware-Cache und lade die Administration neu {% hint style="info" %} **Hinweis**: Konntest du ThemeWare® nicht auf die neuste Version aktualisieren, schaue einmal in den Artikel [ThemeWare® Update nicht verfügbar](/wissensdatenbank/haeufige-fehler/administration/themeware-update-veroeffentlicht-aber-nicht-verfuegbar.md). {% endhint %} ### B. Jetzt verfügbar #### Eine kompatible ThemeWare® Version ist vor dem Shopware-Update verfügbar: ![Jetzt verfügbar](/files/zjVRPOxywWgaaRTqT6TJ) 1. Weise das "Shopware default theme" deinem Verkaufskanal zu 2. Deaktiviere danach dein ThemeWare® Theme * **Tipp**: Leere einmal den gesamten Shopware-Cache 3. Führe das ThemeWare® Update aus 4. ThemeWare® ist nun "Bereits kompatibel" ([A](#a.-bereits-kompatibel)) 5. Führe nun das Shopware-Update aus * **Wichtig**: Nur wenn wirklich *alle* Erweiterungen "Bereits kompatibel" sind! 6. Aktiviere ThemeWare® anschließend wieder * **Tipp**: Leere einmal den gesamten Shopware-Cache 7. Weise ThemeWare® zum Abschluss deinem Verkaufskanal zu 8. Leere einmal den gesamten Shopware-Cache und lade die Administration neu {% hint style="info" %} **Hinweis**: Konntest du ThemeWare® nicht auf die neuste Version aktualisieren, schaue einmal in den Artikel [ThemeWare® Update nicht verfügbar](/wissensdatenbank/haeufige-fehler/administration/themeware-update-veroeffentlicht-aber-nicht-verfuegbar.md). {% endhint %} ### C. Mit der neuen Shopware Version #### Eine kompatible ThemeWare® Version ist nach dem Shopware-Update verfügbar:

Mit der neuen Shopware Version

1. Weise das "Shopware default theme" deinem Verkaufskanal zu 2. Deaktiviere danach dein ThemeWare® Theme 3. Leere einmal den gesamten Shopware-Cache 4. Führe das Shopware-Update aus 5. Führe nun das ThemeWare® Update aus 6. **Wichtig**: Vergewissere dich, dass deine ThemeWare® Version wirklich kompatibel mit der aktuellen Shopware Version ist: [Shopware-Kompatibilität](https://service.themeware.design/shopware-kompatibilitaet) 7. Aktiviere ThemeWare® (in der kompatiblen Version) anschließend wieder * **Tipp**: Leere einmal den gesamten Shopware-Cache 8. Weise ThemeWare® zum Abschluss deinem Verkaufskanal zu 9. Leere einmal den gesamten Shopware-Cache und lade die Administration neu {% hint style="danger" %} **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. {% endhint %} {% hint style="info" %} **Hinweis**: Konntest du ThemeWare® nicht auf die neuste Version aktualisieren, schaue einmal in den Artikel [ThemeWare® Update nicht verfügbar](/wissensdatenbank/haeufige-fehler/administration/themeware-update-veroeffentlicht-aber-nicht-verfuegbar.md). {% endhint %} ### D. Nicht kompatibel #### Eine kompatible ThemeWare® Version für die neue Shopware Version ist noch NICHT verfügbar: ![Nicht kompatibel](/files/BazW43bER8G4QtIxu1Bc) * 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. ### Diese Erweiterung ist im Store nicht verfügbar.
Diese Meldung ist weitgehend selbsterklärend. Die betreffende Erweiterung ist nicht im Shopware Store verfügbar und kann daher nicht automatisch aktualisiert werden. Aktualisiere sie in diesem Fall manuell oder deaktiviere sie vor einem Shopware-Update, bis die Kompatibilität geprüft und sichergestellt wurde. *** ## 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. Falls dies nicht der Fall ist, deaktiviere die problematische Erweiterung und aktiviere diese erst wenn du die entsprechende Erweiterung auf eine kompatible Version updaten konntest (siehe [Shopware Kompatibilität](/wissensdatenbank/grundwissen/shopware-kompatibilitaet.md#kompatibilitat-prufen)). Ist die Administration aufgrund einer inkompatiblen Erweiterung nicht erreichbar, deaktiviere die entsprechende Erweiterung über die Datenbank (siehe [ThemeWare® über die Datenbank deaktivieren](/wissensdatenbank/profiwissen/themeware-ueber-die-datenbank-deaktivieren.md)). Danach sollte die Administration wieder funktionieren. *** ## Update-Leitfaden 💡 Beachte bei Updates von ThemeWare® stets unseren Update-Leitfaden: {% content-ref url="/pages/qWyqwns5jjMp60vx0mWB" %} [Update-Leitfaden](/wissensdatenbank/grundwissen/update-leitfaden.md) {% endcontent-ref %} *** ## Weiterfürhende Informationen * FAQ: [Was bedeutet "Bereits kompatibel"?](/wissensdatenbank/haeufige-fragen/was-bedeutet-bereits-kompatibel.md) * FAQ: [Was bedeutet "Jetzt verfügbar"?](/wissensdatenbank/haeufige-fragen/was-bedeutet-jetzt-verfugbar.md) * FAQ: [Was bedeutet "Mit der neuen Shopware Version"?](/wissensdatenbank/haeufige-fragen/was-bedeutet-mit-der-neuen-shopware-version.md) * FAQ: [Was bedeutet "Nicht kompatibel"?](/wissensdatenbank/haeufige-fragen/was-bedeutet-nicht-kompatibel.md) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://wiki.themeware.design/wissensdatenbank/anleitungen/administration/shopware-updates-und-themeware.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.