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.
Mit KI erstellt – redaktionelle Prüfung ausstehend
WerbelinksMit * 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.1.2 WordPress 7.0 und PHP 7.4 voraus. 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.
Verifizieren: 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.
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.
Verifizieren: 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.
Verifizieren: 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.1.2. Danach stand woocommerce_version auf 11.1.2, woocommerce_db_version aber weiter auf 9.9.5. Das Plugin war aktualisiert, die Datenbank noch nicht.
Verifizieren: 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 22 ausstehende Aktualisierungen und meldete danach Success: 22 Aktualisierungen abgeschlossen. Die Datenbankversion ist 11.1.2. 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.
Verifizieren: 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.
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.
Verifizieren: 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.
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.
Verifizieren: 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.
Testumfang
Wir haben auf einer Testinstallation unter WordPress 7.1.2 eine ältere WooCommerce-Version mit zwei ins Child-Theme kopierten Vorlagen auf die aktuelle Version aktualisiert. Das Datenbank-Update lief per WP-CLI fehlerfrei, und der Website-Zustand erkannte die tatsächlich veraltete Vorlage zuverlässig. Eine echte Bestellung mit Zahlungsanbieter und Rechnungs-Plugins haben wir nicht durchgespielt. Testen Sie Ihren Shop mit allen Erweiterungen deshalb zuerst auf einer Kopie.
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.
