// Shopware-Hilfe
Nach dem Shopware-Update lässt sich ein Plugin nicht mehr aktualisieren oder aktivieren, und es erscheint „Required plugin/package … does not match installed version“, „Failed Dependency“ oder „is missing or not installed and activated“? Das ist der häufigste Stolperstein bei Hauptversions-Updates, und mit dem richtigen Vorgehen bleibt der Shop dabei online.
Jedes Plugin gibt an, mit welchen Shopware-Versionen es funktioniert. Passt die installierte Shopware-Version nicht in diesen Bereich, verweigert Shopware Installation, Aktualisierung oder Aktivierung. Typisch ist das nach einem Sprung auf eine neue Hauptversion: Shopware ist schon auf dem neuen Stand, das Plugin noch auf dem alten. Lösen lässt es sich mit einer kompatiblen Plugin-Version, mit einer Anpassung des Plugins oder, wenn es keine gibt, mit einem Ersatz. Wichtig ist, das Plugin bis dahin nur zu deaktivieren und nicht zu deinstallieren.
// Ursachen
Das installierte Plugin unterstützt nur die alte Shopware-Version. Für die neue Hauptversion gibt es eine eigene Plugin-Version, die erst installiert werden muss.
Der Hersteller hat sein Plugin noch nicht oder gar nicht mehr für die neue Version veröffentlicht. Das betrifft vor allem ältere oder nicht mehr gepflegte Erweiterungen.
Das Plugin braucht ein zusätzliches Paket, etwa eine Bibliothek des Zahlungsanbieters, das bei Composer-Installationen nicht automatisch mitinstalliert wurde.
Mehrere Hauptversionen wurden in einem Sprung aktualisiert. Plugins, Datenbank und Theme kommen dabei leichter durcheinander als bei einem schrittweisen Update.
Neue Shopware- und Plugin-Versionen setzen oft eine neuere PHP-Version voraus. Läuft der Server noch auf der alten, scheitert das Update der Plugins.
Die Kompatibilitätsprüfung im Admin kennt vor allem Plugins aus dem Store. Eigenentwicklungen, angepasste Themes und Abhängigkeiten über Composer prüft sie nicht vollständig.
Vorher Datenbank und Dateien sichern. Diese Befehle zeigen den Stand und ändern nichts Gefährliches:
php bin/console plugin:refresh
php bin/console plugin:listDie Liste zeigt Version und Status jedes Plugins. Ein Plugin, das den Shop blockiert, deaktivieren Sie mit php bin/console plugin:deactivate PluginName. Ist eine neue Plugin-Version eingespielt, aktualisiert php bin/console plugin:update PluginName sie in Shopware.
Wenn es für ein wichtiges Plugin keine kompatible Version gibt, wenn ein eigenes Plugin angepasst werden muss oder wenn das nächste Hauptversions-Update ansteht. Wir machen Plugins von Drittanbietern und Eigenentwicklungen fit für neue Versionen, testen Updates auf einer Kopie und spielen sie ein, wenn alles läuft. Steht der Shop gerade, hilft der 24/7 Notfallservice.
// Soforthilfe
Schicken Sie uns kurz die Fehlermeldung, Ihre Shopware-Version und das betroffene Plugin. Wir sagen Ihnen, ob es eine kompatible Version gibt oder was eine Anpassung kostet.
// Häufige Fragen
Das Plugin verlangt eine andere Shopware-Version als die installierte. Meist ist das Plugin noch für die alte Hauptversion gebaut. Abhilfe schafft eine kompatible Plugin-Version oder eine Anpassung des Plugins.
Davon raten wir ab. Shopware blockiert das aus gutem Grund: Ein Plugin, das nicht für die Version gebaut ist, kann Fehler im Checkout oder einen Ausfall des Shops verursachen. Bis zur Lösung bleibt es deaktiviert.
Es gibt drei Wege: auf eine Version des Herstellers warten, ein anderes Plugin mit ähnlicher Funktion nehmen oder das vorhandene Plugin anpassen lassen. Welcher Weg sinnvoll ist, hängt davon ab, wie wichtig die Funktion ist und wie gut das Plugin gepflegt wird.
Die Prüfung im Admin stützt sich auf die Angaben der Hersteller im Store. Eigene Plugins, angepasste Themes, Composer-Abhängigkeiten und die PHP-Version deckt sie nicht vollständig ab. Ein Testlauf auf einer Kopie zeigt solche Probleme vorher.
Bei Hauptversions-Updates sollten Plugins ohne Freigabe für die neue Version vorher deaktiviert werden. Nach dem Update werden sie in der passenden Version wieder aktiviert.
Anpassungen an einzelnen Plugins kommen dazu, wenn es keine kompatible Version gibt.
Eine Zeit lang ja, aber ältere Versionen bekommen irgendwann keine Sicherheitsupdates mehr, und Plugins sowie Zahlungsanbieter stellen die Unterstützung ein. Je länger das Update wartet, desto größer und teurer wird der Sprung.