Kann KI eine alte WordPress-Website reparieren? Ein Test

15 Min. Lesezeit

Eine WordPress-Website kann von außen fehlerfrei wirken, während darauf seit Jahren nicht aktualisierte Plugins laufen, sich im Protokoll schwerwiegende Fehler sammeln und ein Teil der Besucher eine nur halb geladene Seite sieht. Solche Probleme zeigen sich selten auf der Startseite, und gerade deshalb bleiben sie oft monatelang bestehen.

Uns interessierte, wie viel davon ein KI-Programmierassistent selbstständig aufdecken und beheben kann, ohne dass dabei etwas kaputtgeht. Wir haben auf einem Testkonto unseres cPanel-Hostings einen absichtlich veralteten WooCommerce-Shop aufgesetzt, im WP Toolkit einen Staging-Klon davon erstellt und ihn von Claude Code, dem KI-Agenten von Anthropic, untersuchen, aktualisieren und optisch auffrischen lassen. In diesem Artikel beschreiben wir, was er fand, was er behob, was wir an seiner Stelle entscheiden mussten und was Sie davon übernehmen sollten, wenn Sie Ihre eigene alte Website in Ordnung bringen möchten.

Die Ausgangslage: ein Online-Shop von 2023

Die Testseite ist ein erfundener Keramikladen namens „Agyagműhely“ („Tonwerkstatt“): neun Produkte, eine mit Elementor gestaltete Startseite, ein Kontaktformular und Zahlung per Nachnahme. WordPress und die Plugins haben wir in den Versionen vom Frühjahr 2023 installiert, so wie sie auf einer damals fertiggestellten und seitdem sich selbst überlassenen Website laufen würden:

Bestandteil Version zu Beginn des Tests
WordPress 6.2.6
PHP (auf dem Server) 8.4
Astra-Theme 4.0.2, mit einem eigenen Child-Theme
Elementor 3.12.2
WooCommerce 7.6.1
Contact Form 7 5.7.5.1
Yoast SEO 20.5
Starter Templates 3.2.4
UpdraftPlus, Classic Editor, WP Super Cache 1.23.3, 1.6.3, 1.9.4

In das Child-Theme haben wir einige Code-Schnipsel eingefügt, wie sie Shop-Betreiber gern aus Blogs und Foren kopieren: eine Aktionsleiste über dem Header, die den aktuellen Monat anzeigt, und auf der Produktseite eine Zeile „Wenn Sie heute bestellen, kann es … schon bei Ihnen sein“. Den Code haben wir für den Test selbst geschrieben, seine Fehler sind aber durchaus realistisch.

Die Startseite des Testshops Agyagműhely vor der Modernisierung: grüner Button, hellblaue Überschriften

Die erste Überraschung erlebten wir noch vor dem Einsatz der KI. Als das WP Toolkit die Website erkannte, aktualisierte es den WordPress-Core sofort von 6.2.6 auf 7.1.4, obwohl automatische Updates in der Datei wp-config.php deaktiviert waren. Das WP Toolkit installiert auf den hinzugefügten Websites standardmäßig alle WordPress-Updates (kleinere wie größere) automatisch, überlässt die Plugins jedoch ihren eigenen Einstellungen. So entstand eine Situation, die auch in der Praxis sehr häufig vorkommt: ein aktueller WordPress-Core neben zwei bis drei Jahre alten Plugins. Wie Sie das für jede Website einzeln einstellen, zeigt unser Artikel über automatische Plugin-Updates.

Erster Schritt: Backup und Staging-Klon

Bevor wir irgendetwas änderten, erstellten wir mit der Schaltfläche Sichern/Wiederherstellen des WP Toolkit ein Backup (81 MB, im Ordner wordpress-backups des Hostings) und kopierten die Website anschließend mit der Funktion Klonen auf eine neue Subdomain. Der Klon erhält eine eigene Datenbank, die Indexierung durch Suchmaschinen ist darauf deaktiviert, sodass man dort gefahrlos experimentieren kann. Die Schritte mit Bildern beschreibt unser Knowledge-Base-Artikel über das Erstellen einer Staging-Website, die allgemeinen Regeln für die Arbeit mit Staging dieser Blogbeitrag.

Claude Code lief auf unserem eigenen Rechner und führte die Befehle in der Shell des Hostings aus: WP-CLI, grep, curl und PHP. Wir haben ihm die Shell über das Symbol Terminal in cPanel bereitgestellt, per SSH steht aber genau dieselbe Umgebung zur Verfügung. Unter den Hosting-Paketen von aWh bieten cP Premium, cP Pro, cP Pro 100 sowie WP Premium und WP Pro SSH-Zugang; die Einrichtung beschreibt unser Artikel über die Verwendung von WP-CLI.

Zweiter Schritt: Audit ohne Änderungen

Wir haben nicht mit „Aktualisiere die Website“ begonnen. Die erste Anweisung verlangte nur eine Untersuchung:

Untersuchen Sie die WordPress-Installation im Staging-Ordner. Suchen Sie veraltete Plugins und Themes, eigenen Code, mit PHP 8.4 nicht kompatible Stellen, wiederkehrende Fehler im Protokoll und alles, was unnötig läuft. Geben Sie zu jeder Feststellung den Beleg an, und trennen Sie bestätigte Fehler von möglichen Risiken. Ändern Sie nichts: keine Datei, kein Plugin, keine Datenbank.

Die KI fragte die Versionen und verfügbaren Updates ab, prüfte die Dateien von WordPress und den Plugins anhand der offiziellen Prüfsummen, öffnete die wichtigsten Seiten und einige REST-API-Endpunkte und sah sich dann die neuen Zeilen im PHP-Fehlerprotokoll an. Sie untersuchte die automatisch geladenen Optionen, die Hintergrundaufgaben, den Code des Child-Themes sowie die von der Startseite geladenen Skripte und Schriften. Danach schrieb sie einen Browsertest und führte ihn aus, der den Einkauf durchklickt: Produktseite, In den Warenkorb, Bestellung per Nachnahme und schließlich das Kontaktformular.

Was das Audit fand

Feststellung Beleg
Die Produktseite bricht ab Jede Produktseite lieferte HTTP 500. Die Funktion des Child-Themes erwartete einen Parameter vom Typ WC_Product, der WooCommerce-Hook übergibt jedoch einen leeren String, deshalb brach PHP die Seite mit einem TypeError ab.
Ein Elementor-Endpunkt liefert Fehler 500 Auf die Anfrage /wp-json/elementor/v1/globals folgte ein schwerwiegender PHP-Fehler: Call to undefined method WP_Error::get_data(), im Elementor-Kompatibilitätscode des alten Astra.
Englischer Bestellvorgang Die Sprache der Website war en_US; die ungarischen Sprachpakete waren installiert, aber nicht in Gebrauch, sodass Warenkorb und Kasse Englisch sprachen.
Englischer Monatsname in der ungarischen Leiste setlocale() gab false zurück, weil auf dem Server keine Locale hu_HU vorhanden ist, deshalb schrieb strftime() „November“. strftime() ist seit PHP 8.1 veraltet, utf8_encode() seit PHP 8.2, und letztere würde einen Monatsnamen mit Akzent („március“) sogar verstümmeln.
Veraltungen in PHP 8.4 Die PHP-Prüfung mit vollständiger Fehlerberichterstattung wies den implizit nullable Parameter nach, und Elementor schrieb ähnliche Meldungen in sein eigenes Protokoll. Das PHP des Webservers protokolliert Veraltungsmeldungen nicht, deshalb tauchten sie im Fehlerprotokoll nicht auf.
Anfällige Plugins Das WP Toolkit meldete sechs anfällige Komponenten. Das höchste Risiko hatte Elementor 3.12.2 (2,3/10), danach WooCommerce 7.6.1 (1,6/10).
Unnötig laufende Komponenten Das Plugin Starter Templates wurde seit der Erstellung der Website nicht mehr gebraucht, war aber noch aktiv. WP Super Cache war aktiv, das Caching jedoch ausgeschaltet, sodass der Cache-Loader bei jeder Anfrage unnötig lief. Außerdem befanden sich zwei inaktive Plugins und vier alte Standard-Themes in der Installation.
Schriften von Google-Servern Elementor lud die Schriften Roboto und Roboto Slab, beide in 18 Schnitten, direkt von den Servern von Google. Dabei wird auch die IP-Adresse des Besuchers an Google übermittelt, und die Seite wird langsamer.
Schwacher Kontrast Der weiße Text auf dem Button hatte einen Kontrast von 1,99:1, die hellblaue Überschrift 2,02:1. Die WCAG-Stufe AA verlangt für normalen Text mindestens 4,5:1.

Das Fenster „Sicherheitsstatus“ im WP Toolkit mit den sechs anfälligen Plugins, angeführt von Elementor 3.12.2

Den Fehler der Produktseite brachte der Browsertest ans Licht, nicht das Öffnen der Startseite. Der Besucher sah trotz des Fehlers den Produktnamen, den Preis und den Warenkorb-Button, es fehlten nur das Produktbild, der untere Teil der Seite und der Footer; an ihrer Stelle stand die WordPress-Meldung „critical error“. Bei einem flüchtigen Blick übersieht man das leicht, Suchmaschinen und Käufer bekommen aber eine fehlerhafte Seite. Wenn Ihnen so etwas auf Ihrer eigenen Website begegnet, hilft Ihnen unser Artikel über den WordPress-Debug-Modus, der Ursache auf die Spur zu kommen.

Die Produktseite zum Zeitpunkt des Fehlers: unter dem Warenkorb-Button die WordPress-Meldung „critical error“, das Produktbild fehlt

Was sie nicht als Fehler einstufte

Ein gutes Audit listet nicht nur die Fehler auf, sondern auch das, was sich als in Ordnung herausgestellt hat. Die automatisch geladenen Optionen machten insgesamt 75 KB aus (243 Zeilen), was für einen Shop dieser Größe kein Problem ist, deshalb empfahl die KI keine Bereinigung. Die Prüfsummenabweichung des Plugins Hello Dolly stufte sie als Fehlalarm ein, da dieses Plugin mit dem WordPress-Core mitgeliefert wird und nicht aus dem Plugin-Verzeichnis auf die Website gelangt ist. Die einzige fehlgeschlagene Hintergrundaufgabe war ein alter Migrationsschritt, der keine Auswirkung auf die Funktion der Seite hatte. Wenn auf Ihrer Website mehr Daten automatisch geladen werden, beschreiben wir in diesem Knowledge-Base-Artikel, wie Sie diese überprüfen können.

Dritter Schritt: Reparatur Schritt für Schritt

Die Updates haben wir nicht alle auf einmal ausgeführt. Werden sechs Plugins und ein Theme gleichzeitig aktualisiert und geht danach etwas kaputt, lässt sich nicht sagen, welches Update es verursacht hat. Die Anweisung lautete deshalb:

Führen Sie die Korrekturen einzeln durch, beginnend mit der risikoärmsten. Prüfen Sie nach jedem Schritt den HTTP-Code der wichtigsten Seiten und des Elementor-Endpunkts sowie die neuen Zeilen im PHP-Fehlerprotokoll, und halten Sie an, wenn ein neuer Fehler auftritt.

Schritt Was die KI tat Ergebnis
1. Eigener Code und Sprache Sie schrieb zwei Funktionen des Child-Themes um und stellte die Sprache der Website auf Ungarisch Die Produktseite liefert 200 statt 500
2. Aufräumen Zuerst prüfte sie, ob etwas von Starter Templates abhängt (nur ein Admin-Menüpunkt von Astra verwies darauf), und löschte dann das Plugin, WP Super Cache, die zwei inaktiven Plugins und die vier alten Themes WP Super Cache entfernte beim Deaktivieren selbst die Einstellung WP_CACHE und seinen Loader
3. Astra 4.0.2 → 4.14.3 Sie aktualisierte das Theme und suchte darin die Korrektur Der Elementor-Endpunkt liefert statt 500 die korrekte Antwort 401, ohne neue Protokollzeile
4. Elementor 3.12.2 → 4.4.0 Update, danach die Datenbankaktualisierung von Elementor (wp elementor update db, 4 Schritte) Der Screenshot der Startseite ist vorher und nachher identisch
5. WooCommerce 7.6.1 → 11.3.0 Update, danach wp wc update (61 Datenbankschritte) Der vollständige Kauftest läuft fehlerfrei, mit ungarischen Texten
6. Die übrigen Plugins Contact Form 7, Yoast SEO, UpdraftPlus, Classic Editor und die Sprachpakete Kein Plugin meldet ein Update, das Fehlerprotokoll ist leer

Die Korrektur des Child-Themes lohnt einen genaueren Blick, weil sie gut zeigt, wofür die KI bei altem Code taugt. Wir hatten mit einem einfachen Austausch gerechnet, doch die KI fand mehr Fehler: wp_date() gibt das Datum in der Sprache der Website aus, sodass die Locale des Servers nicht nötig ist. Und da der Wochentag nun auf Ungarisch erscheint, bemerkte sie auch, dass er im Satz eine gebeugte Form braucht: „kedden“ (also „am Dienstag“), nicht die Grundform „kedd“:

// Der Hook übergibt kein Produkt: Der alte Parametertyp WC_Product verursachte den TypeError.
add_action( 'woocommerce_single_product_summary', 'agyag_szallitas', 25 );
function agyag_szallitas() {
	$napok = array( 1 => 'am Montag', 'am Dienstag', 'am Mittwoch', 'am Donnerstag', 'am Freitag', 'am Samstag', 'am Sonntag' );
	$nap   = current_datetime()->modify( '+2 weekdays' );
	printf( '<p class="szallitas">Wenn Sie heute bestellen, kann es %s bei Ihnen sein.</p>', esc_html( $napok[ (int) $nap->format( 'N' ) ] ) );
}

Beim Fehler in Astra verglich die KI den Code der alten und der neuen Version und fand die Bedingung, die die Korrektur bringt. Die neue Version prüft, ob die REST-Anfrage erfolgreich war, bevor sie auf deren Daten zugreift:

if ( is_wp_error( $response ) || ! $response instanceof \WP_REST_Response ) {
	return $response;
}

Sie hätte diese Zeile auch in die Datei des alten Themes schreiben können, doch eine solche Korrektur überschreibt das nächste Theme-Update, und bis dahin weiß niemand, dass das Theme verändert wurde. Das offizielle Update war die bessere Lösung.

Ein Fehler, mit dem wir nicht gerechnet hatten

Am Ende des WooCommerce-Updates brach der WP-CLI-Prozess mit einem schwerwiegenden Fehler ab: Der Loader von Elementor suchte eine WooCommerce-Datei, die es in der neuen Version nicht mehr gibt. Das Update lief trotzdem durch. Die KI gab sich damit nicht zufrieden: Sie wies mit Prüfsummen nach, dass die Dateien von WooCommerce und Elementor vollständig sind, führte die Datenbankaktualisierung aus und machte erst danach weiter, nachdem der vollständige Kauftest fehlerfrei durchgelaufen war. Der Fehler trat innerhalb des Update-Prozesses auf, in dem sich alte und neue Dateien für einen Moment vermischten; die Funktion der Website war nicht betroffen. Auf der Live-Website trat derselbe Fehler genauso auf und richtete auch dort keinen Schaden an. Wenn Ihre Seite nach einem Update nicht mehr lädt, hilft Ihnen dieser Artikel.

Eine Kleinigkeit behoben auch die Updates nicht: Das Kontaktformular bedankte sich nach dem erfolgreichen Absenden auf Englisch. Contact Form 7 speichert die Meldungen eines Formulars bei dessen Erstellung in der Datenbank, und das später installierte ungarische Sprachpaket überschreibt sie nicht mehr. Die KI bemerkte das im Browsertest und setzte die Meldungen auf die ungarischen Standardtexte zurück.

Vierter Schritt: neues Erscheinungsbild aus den vorhandenen Elementen

Für das neue Erscheinungsbild brauchte es weder ein neues Theme noch eine neu aufgebaute Seite. Die KI bekam diese Anweisung:

Frischen Sie das Erscheinungsbild des Shops auf, ohne dass sich die Produkte, die Seiten und die Elementor-Inhalte ändern. Legen Sie Farben und Schriften in den globalen Einstellungen fest, nicht einzeln, der Kontrast soll die WCAG-Stufe AA erreichen, und nichts darf von den Servern von Google geladen werden.

Die KI änderte Farben und Schriften dort, wo die Elemente der Seite sie erben: in den globalen Farben und Schriften von Elementor (Site Settings) sowie in der globalen Palette von Astra, die die Buttons und Links von WooCommerce einfärbt. Statt des alten Grüns und Blaus wurde ein toniger Terrakotta-Ton zur Grundfarbe; weißer Text darauf hat einen Kontrast von 7,47:1 (das erfüllt sogar die Stufe AAA), die Textfarbe ist Dunkelbraun. Für die Überschriften wählte sie die Schrift Lora (SIL Open Font License), die aus dem Child-Theme, also vom eigenen Hosting, ausgeliefert wird, und schaltete das Laden von Google Fonts in Elementor ab. In das Stylesheet des Child-Themes kamen einige Zeilen CSS: abgerundete Buttons, umrandete Produktkarten mit dezentem Schatten, eine dunkle Aktionsleiste und für Besucher, die reduzierte Bewegung wünschen, eine Variante ohne Animationen.

Die Startseite von Agyagműhely nach der Modernisierung: Terrakotta-Buttons, Lora-Überschriften, umrandete Produktkarten

Nach der Änderung lud die Startseite keine einzige Datei mehr von den Servern von Google, das PHP-Fehlerprotokoll blieb leer, und der Kauftest lief genauso durch wie zuvor.

Fünfter Schritt: Livegang bei einem Online-Shop

Mit der Funktion Daten kopieren des WP Toolkit lassen sich die auf dem Staging vorgenommenen Änderungen mit einem Klick auf die Live-Website übertragen. Bei einem Online-Shop ist dabei jedoch Vorsicht geboten: Wenn Sie auch die Datenbank kopieren, überschreibt sie die Bestellungen, Registrierungen und Nachrichten, die seit der Erstellung des Staging-Klons eingegangen sind. Bei einer Firmenwebsite ist das selten ein Problem, bei einem laufenden Shop dagegen bedeutet es Datenverlust.

Deshalb haben wir auf der Live-Website nach einem Backup dieselbe Schrittfolge wiederholt, die wir auf dem Staging bereits erprobt hatten: Wir kopierten die Dateien des Child-Themes und führten die Updates und Datenbankschritte in derselben Reihenfolge aus. Vor dem Durchlauf schalteten wir die Seite in den Wartungsmodus, doch dieser schaltete sich während der Updates von selbst ab, weil der WordPress-Updater am Ende jedes Updates die Wartungsdatei löscht, auch die, die wir selbst angelegt hatten. Bei einem Shop mit wenig Traffic ist das kein Problem, bei einem größeren sollten Sie die Updates in einem solchen Fall auf eine ruhigere Zeit legen. Auf der Live-Seite landete während des gesamten Durchlaufs eine einzige Zeile im Fehlerprotokoll (eine durch den Updater verursachte Warnung „headers already sent“), danach funktionierten der Kauftest und das Kontaktformular genauso fehlerfrei wie auf dem Staging.

Was haben wir gelernt?

KI sollte man nicht als Wundermittel einsetzen, sondern als sorgfältigen, schnellen Techniker. Die meiste Zeit kosteten nicht die Korrekturen, sondern herauszufinden, wo das eigentliche Problem liegt. Darin ist die KI stark: Sie liest das Protokoll durch, verfolgt die Aufrufkette bis zur fehlerhaften Zeile, vergleicht den Code zweier Versionen und schreibt in Sekunden einen Test, den man für einen kleinen Shop von Hand kaum je schreiben würde.

Beginnen Sie nur mit Lesezugriff. Sagen Sie in der ersten Anweisung, dass nichts geändert werden darf, und verlangen Sie für jede Aussage einen Beleg. So erhalten Sie zuerst eine Liste, über die Sie entscheiden, statt hinterher herausfinden zu müssen, was sich geändert hat.

Eine Änderung nach der anderen, danach messen. In unserem Fall bestand die Messung aus den HTTP-Codes von acht URLs, der Anzahl neuer Protokollzeilen und einem Kauftest. Das ist wenig Aufwand, und dadurch wussten wir bei jedem Schritt, was besser geworden war und ob nicht zwischendurch etwas kaputtgegangen ist.

Ein Code 200 der Startseite ist kein Beweis. Der schwerwiegendste Fehler, die abbrechende Produktseite, zeigte sich erst, als der Test den Einkauf durchklickte. Und die Veraltungsmeldungen protokollierte das PHP des Webservers überhaupt nicht; sie kamen erst durch die Durchsicht des Codes und eine strengere PHP-Prüfung ans Licht. Mehr über die Risiken eines PHP-Versionswechsels lesen Sie in unserem Artikel über PHP 8.5.

Manche Entscheidungen bleiben bei Ihnen. Die KI wies darauf hin, dass die Backups von UpdraftPlus neben den Backups des Hostings überflüssig sein könnten und dass der Classic Editor auf einer Elementor-Website womöglich nicht nötig ist, löschte diese aber nicht, weil das davon abhängt, wie Sie mit der Website arbeiten. Dasselbe gilt für das Erscheinungsbild: Farben und Schrift hat die KI vorgeschlagen, ob sie aber zu Ihrer Marke passen, entscheiden Sie.

Bedenken Sie auch, worauf sie Zugriff hat. Ein KI-Agent, der in der Shell Ihres Hostings arbeitet, sieht dasselbe wie Sie: das Datenbankpasswort in der wp-config.php, die Daten der Kunden und auch die E-Mails. Deshalb haben wir ihn auf einem Staging-Klon arbeiten lassen, und deshalb sollten Sie lesen, welche Befehle er ausführt, bevor Sie sie freigeben.

Wie können Sie das auf Ihrem eigenen Hosting umsetzen?

Dafür brauchen Sie nichts Besonderes, nur die Werkzeuge von cPanel:

  • WP Toolkit in allen Paketen von cPanel-Hosting und WordPress-Hosting: Backup, Klonen, Schwachstellenprüfung und Updates an einem Ort. Die Verwaltung der Updates zeigt dieser Knowledge-Base-Artikel, die Meldung anfälliger Plugins dieser hier.
  • Shell und WP-CLI in den Paketen mit SSH, über das Terminal von cPanel oder mit einem SSH-Schlüssel auf Port 4231 (so richten Sie den Schlüssel ein). Ein Tipp für die KI: wp db query und wp db export laufen auf dem Hosting nicht, weil die PHP-Funktion proc_open() auf dem Server gesperrt ist. Die Datenbank fragt man deshalb am besten mit dem Befehl wp eval oder mit den Clients mysql und mysqldump ab.
  • Backup vor großen Schritten: Neben dem Backup des WP Toolkit können Sie auch aus den eigenen Backups des Hostings wiederherstellen; mehr dazu lesen Sie in diesem Artikel.

Wenn Ihnen dafür Zeit oder Lust fehlt oder Sie bei einer alten Website nicht entscheiden können, wo das eigentliche Problem liegt, schreiben Sie uns, und wir helfen Ihnen, die sichere Reihenfolge zu finden.

Zurück zum Blog