Entwicklungsblog
Änderung prüfen, bevor sie in WordPress gespeichert wird
Kurz gesagt
Entscheidet sich ein Websitebetreiber, einen Vorschlag zu übernehmen, rufen wir den aktuellen WordPress-Inhalt ab und prüfen, wohin die Änderung gehört. Wir schreiben, wenn das Ziel eindeutig ist, und bieten den Wortlaut zum Kopieren an, wenn eine manuelle Bearbeitung nötig ist.
Verbindung und Ziel eingrenzen
Wir speichern das WordPress-Anwendungspasswort verschlüsselt und rufen damit die REST-API über HTTPS auf dem registrierten Host auf. Beim Übernehmen prüfen wir den Abo-Status und ob die Seite des Vorschlags zu dieser Website gehört.
Bei Beiträgen und Seiten gleichen wir die URL ab, die WordPress zurückgibt. Für die Startseite lesen wir die WordPress-Einstellung für die Startseite.
Vom aktuellen Wert aus planen
Bei Titeln und Beschreibungen muss der Originaltext mit einem aktuellen Wert übereinstimmen. Bei einer Änderung am Inhalt eines Beitrags analysieren wir das HTML, suchen in einem sichtbaren Textknoten nach genau einer geeigneten Fundstelle und vergleichen die Zahl der Nicht-Text-Knoten vor und nach der Änderung.
Für das Schreiben von Inhalten ist außerdem die Berechtigung nötig, HTML unverändert zu speichern. Enthält das öffentliche HTML eine bekannte Kennzeichnung eines Page Builders oder steht der Originaltext an zwei geeigneten Stellen, bieten wir den Wortlaut an, damit der Websitebetreiber ihn in seinen Editor kopiert.
Antwort prüfen und Rückgängigmachen begrenzen
Wir halten die geplante Änderung vor dem Schreiben fest und vergleichen den zurückgegebenen gespeicherten Wert mit dem erwarteten. Weichen sie ab, versuchen wir, den vorherigen Wert wiederherzustellen, und melden einen Fehler; auch die Wiederherstellung selbst kann scheitern. Sie kann außerdem nicht vollständig verhindern, dass eine zwischenzeitliche Bearbeitung überschrieben wird.
Das Rückgängigmachen vergleicht einen Hash des gesamten Zielfelds und überschreibt es nicht, wenn es sich seit dem Schreiben geändert hat. Eine Bearbeitung zwischen Lesen und Schreiben kann trotzdem mit diesem Ablauf kollidieren. Inhalte, die manuell aus einer Kopie übernommen wurden, liegen außerhalb dieses Rückgängig-Wegs.
Eine fiktive Änderung im Inhalt nachverfolgen
Angenommen, der gespeicherte Inhalt einer fiktiven Werkstattseite lautet „<p>Wir reparieren Fahrräder.</p>“. Der vorgeschlagene Originaltext ist „Wir reparieren Fahrräder.“ und die Ersetzung „Wir warten Fahrräder.“. Stimmt die URL, kommt das Original in genau einem geeigneten sichtbaren Textknoten vor und sind die übrigen Bedingungen erfüllt, plant das System diese Ersetzung. Ein Plan ist keine Garantie, dass das Schreiben gelingt.
Steht der Originalsatz zweimal da, kann das System nicht zwischen beiden wählen und bietet den Text zum manuellen Kopieren an. Auch ein geänderter aktueller Wert, eine unterstützte SEO-Beschreibung, die sich nicht lesen lässt, oder eine fehlende Berechtigung, HTML unverändert zu speichern, können die automatische Übernahme verhindern. Vergleichen Sie den Vorschlag mit dem WordPress-Editor und wählen Sie die gewünschte Stelle.
Seite prüfen und bewusst wiederherstellen
Prüfen Sie vor dem Übernehmen die URL und beide Fassungen. Öffnen Sie danach die öffentliche Seite und sehen Sie sich den geänderten Satz und das umgebende Layout an. Ein Cache kann verzögern, was Besucher sehen. Prüfen Sie deshalb den gespeicherten Wert und die öffentliche Anzeige getrennt.
Meldet das Rückgängigmachen einen geänderten Wert oder scheitert es, überschreiben Sie spätere Bearbeitungen nicht blind. Vergleichen Sie das aktuelle WordPress-Feld mit den verfügbaren Revisionen und entscheiden Sie mit der Person, die die Website betreut, was wiederhergestellt wird. Auch die automatische Wiederherstellung kann scheitern; manuell eingefügte Änderungen liegen außerhalb des Rückgängig-Wegs dieses Dienstes.