Weniger ist mehr: aufräumen und Konflikte lösen

Modul 5: Themes und Plugins · Lesezeit: 9 Minuten

Lernziel: Nach dieser Lektion können Sie Plugins aufräumen und einen Konflikt oder eine weiße Seite selbst aufspüren und beheben.

Kernbegriffe: Deaktivieren vs. Löschen, inaktiver Code, kritischer Fehler, Wiederherstellungsmodus (Recovery Mode), Website-Zustand, Fehlerbehebungsmodus, Plugin-Ordner umbenennen, WP_DEBUG, WP_DEBUG_LOG, debug.log, Fehlerprotokoll

Ausschalten ist nicht wegwerfen

Unter Plugins können Sie ein Plugin deaktivieren oder löschen. Der Unterschied:

Deaktivieren: WordPress lädt das Plugin nicht mehr. Die Dateien bleiben aber in wp-content/plugins/ liegen und sind oft noch direkt über den Webserver abrufbar. Steckt eine Sicherheitslücke in einer einzelnen PHP-Datei dieses Plugins, dann besteht diese Lücke weiterhin. Angreifer suchen nach bekannten verwundbaren Dateien, nicht nach aktiven Plugins.
Löschen: Die Dateien werden entfernt. Manche Plugins räumen beim Löschen auch ihre Einstellungen und Tabellen in der Datenbank auf, andere lassen sie stehen.

Verwenden Sie ein Plugin nicht mehr, dann löschen Sie es. Deaktivieren ist nur für kurze Zeit gedacht (während der Suche nach einem Problem). Dasselbe gilt für Themes (Lektion 2.4).

Aufräumen: eine feste Runde

Gehen Sie einmal pro Quartal (Lektion 9.4) Ihre Plugins durch. Für jedes Plugin:

Wofür ist es da? Wissen Sie es nicht mehr, finden Sie es heraus. Oft stellt sich heraus, dass ein Plugin irgendwann für eine einzige Sache installiert und nie wieder entfernt wurde.
Wird es noch verwendet? Ein Slider-Plugin, obwohl nirgends ein Slider zu sehen ist, ein Formular-Plugin, obwohl Ihre Kontaktseite ein anderes Formular verwendet.
Geht es auch ohne? Kann WordPress, das Theme oder ein anderes Plugin das bereits (Lektion 5.3)?
Wird es noch gepflegt? Wann zuletzt aktualisiert, noch im Plugin-Verzeichnis?

Räumen Sie zuerst in Staging auf (Lektion 8.3) oder erstellen Sie mindestens ein Backup, und löschen Sie jeweils nur ein Plugin, damit Sie wissen, was schiefging, falls etwas schiefgeht. Achten Sie auf Shortcodes: Löschen Sie ein Plugin, das [formular id="2"] geliefert hat, dann steht dieser Text danach wörtlich auf Ihrer Seite.

Wenn es schiefgeht: der kritische Fehler

Nach einem Update, einem neuen Plugin oder einem PHP-Upgrade sehen Sie plötzlich:

Es gab einen kritischen Fehler auf dieser Website.

oder eine komplett weiße Seite. Das bedeutet: PHP ist mit einem fatalen Fehler abgebrochen, bevor eine Seite entstanden ist (Lektion 1.2). Meistens liegt das an einem Plugin oder Theme, das sich mit etwas anderem nicht verträgt: einem anderen Plugin, der neuen WordPress-Version oder der PHP-Version.

Seit WordPress 5.2 macht WordPress dann zwei Dinge:

Es sendet eine E-Mail an die Administrator-Adresse mit dem Plugin oder Theme, das den Fehler verursacht hat, und einem speziellen Link;
mit diesem Link melden Sie sich im Wiederherstellungsmodus (Recovery Mode) an: Der Adminbereich funktioniert dann, wobei das fehlerhafte Plugin vorübergehend ausgeschaltet ist, sodass Sie es aktualisieren, ersetzen oder löschen können.

Deshalb ist eine Administrator-Adresse, die Sie auch lesen, so wichtig (Lektion 2.2).

Selbst suchen: die Schritte

Kommt keine E-Mail an oder funktioniert der Wiederherstellungsmodus nicht? So finden Sie den Fehler selbst.

1. Sehen Sie im Fehlerprotokoll nach

Der Fehler steht fast immer im Fehlerprotokoll des Webservers oder von PHP. In DirectAdmin finden Sie es bei den Protokollen Ihrer Domain. Sie suchen eine Zeile mit PHP Fatal error und dem Zeitpunkt Ihres Versuchs:

PHP Fatal error:  Uncaught Error: Call to undefined function create_function()
in /home/benutzer/domains/example.com/public_html/wp-content/plugins/alter-slider/slider.php:42

Der Pfad verrät Ihnen den Schuldigen: hier das Plugin im Ordner alter-slider. Der Rest der Zeile sagt, warum (hier: eine Funktion, die in PHP 8 entfernt wurde, Lektion 8.4).

2. Schalten Sie das Debug-Log ein (nicht die Bildschirmausgabe)

Steht im Fehlerprotokoll nichts Brauchbares, dann tragen Sie in wp-config.php ein (oberhalb von "Schluss mit dem Bearbeiten"):

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

WordPress schreibt dann alle Fehler in wp-content/debug.log, ohne sie Besuchern anzuzeigen. Lassen Sie das nie länger eingeschaltet als nötig: debug.log liegt in einem Ordner, den der Webserver ausliefert, und wer die Adresse kennt, kann die Datei lesen. Darin stehen Pfade, manchmal Benutzernamen und andere Informationen, die einem Angreifer helfen. Schalten Sie es nach der Suche wieder aus und löschen Sie debug.log. Oder lassen Sie WordPress die Logdatei außerhalb des Webverzeichnisses schreiben, indem Sie bei WP_DEBUG_LOG einen Pfad angeben (zum Beispiel '/home/benutzer/logs/wp-debug.log', sofern Ihr Hoster das erlaubt). In Lektion 7.4 prüfen Sie, dass debug.log nicht öffentlich ist.

3. Plugin ohne Adminbereich ausschalten

Kommen Sie nicht in den Adminbereich, schalten Sie das verdächtige Plugin aus, indem Sie seinen Ordner umbenennen, über den Dateimanager oder per SFTP:

wp-content/plugins/alter-slider   wird zu   wp-content/plugins/alter-slider-aus

WordPress findet das Plugin dann nicht mehr und schaltet es aus. Wissen Sie nicht, welches es ist, benennen Sie den ganzen Ordner plugins in plugins-aus um: Alle Plugins werden ausgeschaltet. Funktioniert die Website dann, erstellen Sie einen neuen leeren Ordner plugins, legen die Plugins einzeln zurück und prüfen nach jedem Plugin, ob der Fehler wiederkommt. Für ein Theme gilt dasselbe: Benennen Sie den Ordner des aktiven Themes um, und WordPress greift auf ein Standard-Theme zurück, sofern noch eines vorhanden ist (Lektion 2.4).

4. Konflikte ohne fatalen Fehler

Nicht jedes Problem ist ein kritischer Fehler. Manchmal funktioniert nur eine Funktion nicht: Ein Button reagiert nicht, das Formular wird nicht gesendet, der Editor lädt nur halb. Dann ist es oft ein Konflikt zwischen zwei Plugins oder zwischen einem Plugin und dem Theme. Dafür ist das offizielle Plugin Health Check & Troubleshooting praktisch: Im Fehlerbehebungsmodus schaltet es nur für Ihre eigene Sitzung alle Plugins aus und wechselt zu einem Standard-Theme, während Besucher ganz normal die gewohnte Website sehen. Danach schalten Sie die Plugins einzeln wieder ein, bis das Problem zurückkehrt.

Sehen Sie auch in der Konsole Ihres Browsers nach (F12): JavaScript-Fehler nennen oft die Datei und damit das Plugin.

Website-Zustand

Unter Werkzeuge > Website-Zustand prüft WordPress Ihre Website selbst: veraltete PHP-Version, Plugins und Themes, die nicht aktiv sind, fehlende PHP-Erweiterungen, eine REST API, die nicht funktioniert, geplante Aufgaben, die im Rückstand sind. Auf dem Tab Bericht stehen alle Daten Ihrer Installation (Versionen, Pfade, PHP-Einstellungen). Diesen Tab können Sie kopieren und mitschicken, wenn Sie um Hilfe bitten. Schauen Sie hier nach jeder größeren Änderung kurz vorbei.

Zusammenfassung

Deaktivieren lässt die Dateien liegen; löschen Sie Plugins und Themes, die Sie nicht verwenden.
Räumen Sie jedes Quartal auf, jeweils ein Plugin, mit einem Backup oder in Staging.
Bei einem kritischen Fehler sendet WordPress eine E-Mail mit einem Link zum Wiederherstellungsmodus.
Das Fehlerprotokoll oder debug.log nennt den Pfad des Schuldigen; schalten Sie Debug nach der Suche wieder aus, denn debug.log ist sonst öffentlich.
Ohne Adminbereich schalten Sie ein Plugin aus, indem Sie seinen Ordner umbenennen; Konflikte suchen Sie mit dem Fehlerbehebungsmodus.

Quiz

Aufgabe

Aufgabe A5.4: Ist Ihr Debug-Log nicht öffentlich? Geben Sie die Adresse Ihrer Website ein und weisen Sie mit dem Code, den Ihnen die Aufgabe gibt, nach, dass es Ihre eigene Website ist (ein TXT-Record oder eine kleine Datei). Das Programm ruft /wp-content/debug.log ab: Gut ist, wenn die Datei nicht existiert oder der Zugriff verweigert wird (404 oder 403). Bekommt das Programm eine Datei zurück, ist das Ergebnis rot. Außerdem zählt das Programm, wie viele verschiedene Plugin-Ordner im HTML Ihrer Startseite vorkommen (nur zur Information).

Aufgabe D5.4: Ihre Plugin-Liste aufräumen. Erstellen Sie eine Liste all Ihrer Plugins (aktiv und inaktiv): Name, Zweck, noch nötig (ja/nein), Alternative ohne Plugin. Löschen Sie (nach einem Backup oder in Staging) die Plugins, die nicht mehr nötig sind, jeweils eines, und prüfen Sie nach jedem Löschen, ob die Website noch funktioniert. Tragen Sie ein, wie viele Plugins Sie hatten und wie viele übrig sind, und notieren Sie, ob Shortcodes zurückgeblieben sind, die Sie aufräumen mussten.

Aufgabe D5.4: Ihre Plugin-Liste aufräumen

Diese Aufgabe machen Sie selbst; niemand prüft sie nach. Haken Sie ab, was Sie erledigt haben, und markieren Sie die Aufgabe als erledigt.

Zuerst ein Backup erstellt oder in Staging gearbeitet
Ein Plugin nach dem anderen entfernt
Nach jedem Entfernen die Website überprüft
Zurückgebliebene Shortcodes überprüft

Ihre Liste: Name, wofür, noch nötig, Alternative

Wie viele Plugins hatten Sie vorher und nachher?

Ihre Haken und Notizen bleiben nur in diesem Browser; wir senden sie nirgendwohin. Sind Sie angemeldet, speichern wir in Meine Kurse nur, dass Sie die Aufgabe erledigt haben.

Weiterlesen

Diese Artikel beschreiben die Schritte in den Panels von WebOké; in anderen Panels funktionieren sie ähnlich.

Cookies bei WebOké

Cookie-Einstellungen

Notwendig

Marketing