WooCommerce-Updates sicher einspielen: Datenbank-Update und Vorlagen prüfen
Ein planbarer Ablauf für WooCommerce-Updates im kleinen Shop: Stand erfassen, Erweiterungen prüfen, sichern, aktualisieren, Datenbank-Update ausführen und veraltete Template-Überschreibungen finden.
Werbung Mit * markierte Links sind Werbelinks: Bei einem Kauf erhalten wir eine Provision, der Preis bleibt gleich. Mehr dazu
Ein WooCommerce-Update ist mehr als ein Plugin-Update. Neben den Dateien ändert WooCommerce bei vielen Versionen auch die Struktur seiner Datenbank, und Themes bringen oft eigene Kopien von WooCommerce-Vorlagen mit, die nach dem Update veralten können. Beides fällt im Alltag kaum auf, bis im Shop ein Preis fehlt, eine Bestellmail seltsam aussieht oder der Checkout hakt. Diese Anleitung zeigt einen Ablauf, mit dem Sie WooCommerce-Updates in einem kleinen Shop planbar einspielen: Sicherung, Kompatibilität prüfen, Update, Datenbank-Update und die Kontrolle überschriebener Vorlagen.
Voraussetzungen
- WordPress und PHP in den Versionen, die die aktuelle WooCommerce-Version verlangt. Laut der mitgelieferten
readme.txtsetzt WooCommerce 11.2.1 WordPress 7.0 und PHP 7.4 voraus. Ab WooCommerce 11.6, geplant für Februar 2027, verlangt WooCommerce laut Entwicklerblog PHP 8.1 oder neuer. Getestet wurde mit WordPress 7.1.2 und PHP 8.4. - Die Rolle Administrator im Backend.
- Zugriff auf die Dateien per SFTP oder SSH, für die Befehle in dieser Anleitung außerdem WP-CLI.
- Ein aktuelles, geprüftes Backup von Dateien und Datenbank. Bei einem Shop mit laufenden Bestellungen ist das keine Formalität: Ein Zurückspielen löscht alle Bestellungen seit der Sicherung.
- Möglichst eine Staging-Kopie des Shops, auf der Sie das Update vorab ausprobieren.
Schritt 1: Zeitpunkt wählen und Stand erfassen
Spielen Sie Updates in einer ruhigen Zeit ein, etwa früh am Morgen, und nicht kurz vor einer Aktion oder am Freitagnachmittag. Erfassen Sie vorher den Ist-Zustand, damit Sie nach dem Update vergleichen können:
$ wp plugin list --fields=name,status,version,update_version
$ wp option get woocommerce_version
$ wp option get woocommerce_db_versionwoocommerce_version ist die Version der Plugin-Dateien, woocommerce_db_version der Stand der Datenbank. Im Normalbetrieb sind beide gleich. Laufen sie auseinander, wurde ein Datenbank-Update noch nicht ausgeführt. Lesen Sie außerdem die Änderungshinweise der neuen Version. Wie Sie Changelogs einschätzen, beschreibt die Anleitung WordPress-Updates prüfen und das Risiko einschätzen.
Sie haben die Liste der Plugins mit Versionen und die beiden Versionswerte notiert, zum Beispiel in Ihrer Website-Dokumentation.
Schritt 2: Erweiterungen und Theme auf Kompatibilität prüfen
Zahlungs-, Versand- und Rechnungs-Plugins hängen eng an WooCommerce. Viele Erweiterungen geben im Kopf ihrer Hauptdatei an, mit welcher WooCommerce-Version sie getestet wurden, über die Angaben WC requires at least und WC tested up to. Prüfen Sie außerdem, ob für Ihre Erweiterungen und Ihr Theme selbst Updates bereitstehen, und spielen Sie diese in der vom Hersteller empfohlenen Reihenfolge ein.
Wie wichtig die Reihenfolge ist, zeigt ein Hinweis in den Release Notes von WooCommerce 11.2.0: PublishPress Future in den Versionen 3.0.0 bis 4.10.3 lädt eine eigene, veraltete Kopie des Action Schedulers und kann mit WooCommerce 11.2 einen fatalen Fehler auslösen. Behoben ist das laut den Release Notes ab Version 4.10.4, die Erweiterung gehört also vor WooCommerce aktualisiert. Im Test lieferte die Startseite nach dem Update von WooCommerce 11.1.2 auf 11.2.1 mit PublishPress Future 4.10.3 den Status 500, im Debug-Protokoll stand:
PHP Fatal error: Declaration of PublishPress\Future\Modules\Expirator\Tables\ScheduledActionsTable::column_hook(array $row) must be compatible with ActionScheduler_ListTable::column_hook($row) in /var/www/html/wp-content/plugins/post-expirator/src/Modules/Expirator/Tables/ScheduledActionsTable.php on line 401Auch wp plugin update post-expirator brach mit diesem Fehler ab. Erst wp --skip-plugins=post-expirator plugin update post-expirator brachte die Erweiterung auf 4.11.1, danach lud die Startseite wieder.
Bei Premium-Erweiterungen, die nicht aus dem Verzeichnis auf wordpress.org stammen, brauchen Sie eine gültige Lizenz, um Updates zu erhalten. Ist eine Lizenz abgelaufen, bleibt die Erweiterung auf dem alten Stand, während WooCommerce weiterzieht. Genau diese Kombination führt häufig zu Fehlern.
Für jede aktive WooCommerce-Erweiterung wissen Sie, ob sie mit der Zielversion getestet ist oder ob der Hersteller ein passendes Update anbietet.
Schritt 3: Backup erstellen
Sichern Sie direkt vor dem Update die Datenbank und den Ordner wp-content. Per WP-CLI geht der Datenbankteil in wenigen Sekunden:
$ mkdir -p ~/backups
$ wp db export ~/backups/vor-woocommerce-update-$(date +%F-%H%M).sqlLegen Sie die Datei außerhalb des Webordners ab, weil sie Kundendaten und Bestellungen enthält. Aus Datenschutzsicht gilt für diese Sicherung dasselbe wie für die Live-Datenbank: Nach dem erfolgreichen Update löschen Sie sie oder übernehmen sie in Ihre reguläre Backup-Aufbewahrung. Ein Datenbank-Update von WooCommerce lässt sich nicht rückgängig machen, das Zurückspielen dieser Sicherung ist der einzige Weg zurück. Mehr zu Aufbewahrung und Rücksicherung finden Sie in der Anleitung WordPress-Datenbank mit WP-CLI sichern und wiederherstellen.
wp db export meldet Success: Exported to '…'., und die Datei ist größer als null Byte.
Schritt 4: WooCommerce aktualisieren
Im Backend aktualisieren Sie WooCommerce unter Dashboard > Aktualisierungen oder unter Plugins > Installierte Plugins. Per WP-CLI lautet der Befehl:
$ wp plugin update woocommerceAktualisieren Sie WooCommerce einzeln und nicht zusammen mit allen anderen Plugins. Tritt ein Fehler auf, wissen Sie so sofort, woher er kommt. Im Test sprang eine Installation von Version 9.9.5 auf 11.2.1. Danach stand woocommerce_version auf 11.2.1, woocommerce_db_version aber weiter auf 9.9.5. Das Plugin war aktualisiert, die Datenbank noch nicht.
wp plugin list --name=woocommerce zeigt die neue Version, und der Shop lädt im Frontend ohne Fehlermeldung.
Schritt 5: Datenbank-Update ausführen
Steht ein Datenbank-Update an, blendet WooCommerce im Backend den Hinweis „Aktualisierung der WooCommerce-Datenbank erforderlich“ mit der Schaltfläche WooCommerce-Datenbank aktualisieren ein. Nach dem Klick läuft das Update laut WooCommerce im Hintergrund und kann etwas dauern. Bei großen Shops ist die Kommandozeile zuverlässiger, weil sie nicht von Hintergrundaufgaben und Seitenaufrufen abhängt:
$ wp wc update
$ wp option get woocommerce_db_versionIm Test fand WooCommerce 31 ausstehende Aktualisierungen und meldete danach Success: 31 Aktualisierungen abgeschlossen. Die Datenbankversion ist 11.2.1. Von 11.1.2 auf 11.2.1 waren es neun, weil WooCommerce 11.2.0 laut Release Notes ein Datenbank-Update mitbringt. Diese Schritte ändern unter anderem Indizes, Optionen und Einstellungen. Deshalb verlangt Schritt 3 die Sicherung davor. Alternativ finden Sie die Aufgabe im Backend unter WooCommerce > Status > Werkzeuge als Datenbank aktualisieren.
woocommerce_db_version entspricht der neuen Plugin-Version, und der Hinweis auf ein Datenbank-Update ist im Backend verschwunden.
Schritt 6: Überschriebene Vorlagen prüfen
Themes können WooCommerce-Vorlagen überschreiben, indem sie Kopien im Ordner woocommerce des Themes ablegen, etwa woocommerce/emails/email-footer.php. Jede Vorlage trägt im Kopf eine Zeile @version. Ändert WooCommerce eine Vorlage, steigt diese Nummer, die Kopie im Theme bleibt aber alt. Die Folge können fehlende Felder, Darstellungsfehler oder PHP-Warnungen sein.
WooCommerce meldet das an zwei Stellen. Unter Werkzeuge > Website-Zustand erscheint die Empfehlung, dass Ihr Theme veraltete WooCommerce-Template-Überschreibungen enthält, mit dem Link Betroffene Templates anzeigen. Unter WooCommerce > Status im Systemstatus listet der Abschnitt zum Theme alle Überschreibungen mit Theme-Version und Plugin-Version. Im Test hatten wir zwei Vorlagen in ein Child-Theme kopiert. Nach dem Update war email-footer.php im Theme auf Stand 9.6.0, im Plugin auf 10.4.0, und der Website-Zustand zeigte genau diese Empfehlung. Die zweite Kopie blieb unverändert gültig, weil WooCommerce sie nicht geändert hatte. Ein aktuelles Beispiel ist single-product/meta.php: Mit WooCommerce 11.2.0 stieg ihre Version von 9.7.0 auf 11.2.0, und eine Kopie aus 11.1.2 meldete der Website-Zustand nach dem Update als veraltet.
Die WooCommerce-Dokumentation beschreibt die Korrektur so: die veraltete Kopie sichern, die aktuelle Vorlage aus wp-content/plugins/woocommerce/templates/ an dieselbe Stelle im Theme kopieren und Ihre eigenen Änderungen erneut einarbeiten. Ein Vergleich der alten und neuen Datei zeigt, was sich geändert hat:
cd wp-content
cp themes/IHR-THEME/woocommerce/emails/email-footer.php ~/backups/email-footer.php.alt
diff ~/backups/email-footer.php.alt plugins/woocommerce/templates/emails/email-footer.phpStammt die Überschreibung von einem gekauften Theme, bringt oft ein Update des Themes die neue Fassung mit. Fragen Sie in diesem Fall zuerst den Theme-Hersteller.
Im Website-Zustand erscheint die Prüfung „WooCommerce-Template-Überschreibungen“ nicht mehr unter den Empfehlungen, und im Systemstatus stimmen Theme- und Plugin-Version jeder Vorlage überein. Der Systemstatus speichert die Theme-Angaben bis zu einer Stunde zwischen. Im Test zeigte er die neue Version erst nach wp transient delete wc_system_status_theme_info, der Website-Zustand dagegen sofort.
Schritt 7: Shop durchtesten
Technische Prüfungen ersetzen keinen echten Durchlauf. Legen Sie im Frontend ein Produkt in den Warenkorb, gehen Sie zur Kasse und schließen Sie eine Bestellung mit einer Testzahlart ab, etwa Vorkasse. Prüfen Sie danach, ob die Bestellbestätigung per E-Mail ankommt und richtig aussieht, ob die Bestellung im Backend unter WooCommerce > Bestellungen erscheint und ob Ihr Rechnungs-Plugin eine Rechnung erzeugt. Stornieren Sie die Testbestellung anschließend.
Diese Kontrolle wiederholt sich bei jedem Update, und WooCommerce erscheint in kurzen Abständen. Wer das nicht selbst im Kalender halten möchte, kann es abgeben: Die WordPress-Wartung von wordpressupdate.de spielt Updates von WordPress, Plugins und Themes mit Kompatibilitätsprüfung ein und sichert die Website wöchentlich auf externen Speicher.
Die Testbestellung lief vom Warenkorb bis zur E-Mail durch, und unter WooCommerce > Status > Protokolle finden sich keine neuen Fehlereinträge.
Typische Fehler
| Symptom | Ursache | Lösung |
|---|---|---|
| Hinweis auf Datenbank-Update bleibt stehen | Hintergrundaufgabe läuft nicht, etwa weil WP-Cron nicht ausgelöst wird | wp wc update auf der Kommandozeile ausführen |
| Website-Zustand meldet veraltete Template-Überschreibungen | Kopie im Theme hat eine ältere @version als das Plugin | Aktuelle Vorlage kopieren, eigene Änderungen neu einarbeiten, oder Theme aktualisieren |
| Erweiterung funktioniert nach dem Update nicht mehr | Erweiterung ist mit der neuen WooCommerce-Version nicht kompatibel | Update der Erweiterung einspielen, sonst Backup zurückspielen |
| Kritischer Fehler nach dem Update | PHP-Fehler in einer Erweiterung oder im Theme | Wiederherstellungsmodus nutzen, siehe Wiederherstellungsmodus bei kritischem Fehler |
| Datenbank-Stand nach Rückkehr zur alten Version höher als Plugin | Nur die Plugin-Dateien wurden zurückgesetzt, die Datenbank nicht | Vollständig aus dem Backup von Schritt 3 zurückspielen |
Häufige Fragen
Kann ich WooCommerce auf eine ältere Version zurücksetzen?
Die Plugin-Dateien lassen sich mit wp plugin install woocommerce --version=VERSION --force auf eine ältere Version bringen. Hat das Datenbank-Update schon stattgefunden, passt die Datenbank aber nicht mehr zu den alten Dateien. Sauber ist nur das Zurückspielen des vollständigen Backups. Bestellungen, die seitdem eingegangen sind, müssen Sie dann gesondert sichern. Details zu Rollbacks finden Sie in der Anleitung Plugin-Update rückgängig machen.
Sollte ich automatische Updates für WooCommerce einschalten?
Für einen Shop mit Umsatz eher nicht. Ein automatisches Update kann nachts ein Datenbank-Update auslösen, ohne dass jemand danach den Checkout prüft. Kleinere Sicherheitsupdates spielen Sie dennoch zeitnah ein, nur eben bewusst.
Wie lange dauert das Datenbank-Update?
Bei kleinen Shops Sekunden. Bei vielen Bestellungen und Produkten kann es deutlich länger laufen. Probieren Sie es deshalb auf einer Staging-Kopie mit echtem Datenbestand aus, dann kennen Sie die Dauer vorher.
Brauche ich den Systemstatus, wenn der Website-Zustand nichts meldet?
Der Systemstatus zeigt mehr Details, etwa alle Überschreibungen mit Versionen, auch die aktuellen. Er ist außerdem der Bericht, den Support-Teams von Erweiterungen meist anfordern.
Fazit
WooCommerce-Updates bleiben beherrschbar, wenn Sie immer denselben Ablauf gehen: Stand erfassen, Kompatibilität prüfen, sichern, Plugin aktualisieren, Datenbank-Update ausführen, Vorlagen kontrollieren und eine Testbestellung durchspielen. Wer diese Routine für seinen Shop lieber abgibt, findet sie in der WordPress-Wartung von Marcel Schönfelder.
