WordPress und Exponential #

Übersicht Migration · Checkliste · Abbildung · Werkzeuge

Inhalt #

• 1. Was WordPress exportieren kann
• 2. WordPress auf Exponential abbilden
• 3. Von WordPress zu Exponential, Schritt für Schritt
• 4. Adressen und Weiterleitungen
• 5. Von Exponential zu WordPress
• 6. Risiken und Checkliste
• Quellen

1. Was WordPress exportieren kann #

Laut der eigenen Dokumentation von WordPress:

Nutzen Sie WXR als eingefrorene Quelle des Imports (eine Datei, alle Inhalte, wiederholbar) und das Upload-Verzeichnis für die Dateien. Nutzen Sie die REST-API, wenn Sie keine WXR-Datei bekommen können, oder für ein Delta der letzten Tage vor der Umstellung.

Was WXR pro Eintrag enthält (die Elemente des Formats): den Titel, den Permalink (<link>), <wp:post_id>, <wp:post_name> (den Slug), <wp:post_type>, <wp:status>, <wp:post_parent>, die Datumsangaben, <content:encoded> (das HTML des Inhalts, einschließlich der Kommentare des Block-Editors), <excerpt:encoded>, die Kategorien und Schlagwörter, <wp:postmeta> (benutzerdefinierte Felder, auch die von SEO-Plugins) und <wp:comment>. Anhänge sind Einträge vom Typ attachment mit ihrer URL.

2. WordPress auf Exponential abbilden #

3. Von WordPress zu Exponential, Schritt für Schritt #

1. Bestandsaufnahme: Post Types und ihre Anzahl (wp post list --post_type=<type> --format=count), Plugins, die Inhalte speichern (Page Builder, benutzerdefinierte Felder, SEO, Formulare), die Größe der Uploads, die Permalink-Struktur (Einstellungen > Permalinks).
2. Legen Sie die Klassen in Exponential und den Ordnerbaum an (Blog, Seiten, Medien).
3. Export: wp export --dir=<dir> --max_file_size=-1 (oder Werkzeuge > Daten exportieren), und kopieren Sie wp-content/uploads.
4. Umwandeln: Ein Skript liest das WXR mit einem XML-Parser und schreibt pro Eintrag eine JSON-/CSV-Zeile mit der Remote-ID (wp-<post_id>), dem übergeordneten Eintrag, Titel, umgewandeltem Inhalt, Datumsangaben, Autor, Kategorien, Schlagwörtern, SEO-Feldern und dem alten Permalink. Page Builder, die das Layout in Post-Meta oder Shortcodes speichern, brauchen eine eigene Umwandlung oder als Ausweichlösung gerendertes HTML (die veröffentlichte Seite abrufen und den Inhaltsbereich übernehmen).
5. Importieren Sie zuerst die Medien (Anhänge als Bild-/Dateiobjekte mit wp-<post_id>; die Upload-Dateien über ihren Pfad), dann die Seiten in der Reihenfolge der Hierarchie, dann die Beiträge, dann die Kommentare. Nutzen Sie den Importer von xrowextract oder das Skript-Grundgerüst.
6. Interne Links umschreiben: Links auf /wp-content/uploads/... und auf andere Beiträge werden zu Einbettungen oder Links auf die neuen Knoten (in einem zweiten Durchlauf über die Remote-ID aufgelöst).
7. Weiterleitungen (4), SEO-Felder, Suchindex, Sitemap.
8. Delta: Exportieren Sie vor der Umstellung die seit dem Hauptexport geänderten Einträge (Datumsfilter des WXR oder die REST-API mit modified_after) und führen Sie den Import erneut aus; dank der Remote-IDs wird daraus eine Aktualisierung.
9. Stellen Sie um und beobachten Sie die 404-Liste (Checkliste, 8).

4. Adressen und Weiterleitungen #

WordPress-Adressen folgen der Permalink-Struktur (/%year%/%monthnum%/%postname%/, /%category%/%postname%/, /?p=123 bei der Standardeinstellung „Einfach“), dazu kommen Archive für Kategorien, Schlagwörter, Autoren, Datumsangaben und Feeds.

5. Von Exponential zu WordPress #

1. Exportieren Sie mit xrowextract (CSV/JSON pro Klasse, mit URL-Alias, Remote-ID und jedem Attribut) und kopieren Sie das Speicherverzeichnis (Exponential verlassen).
2. Wandeln Sie XmlText in HTML um (mit den Templates der Site rendern oder das XML transformieren) und schreiben Sie eine WXR-Datei: ein <item> pro Objekt mit <wp:post_type>, <wp:post_name> aus dem Alias, Kategorien aus dem Baum.
3. Importieren Sie mit dem WordPress Importer: Er importiert Beiträge, Seiten, Custom Post Types, Kommentare, Metadaten, Begriffe und Autoren, fragt Sie, welchem bestehenden oder neuen Benutzer jeder Autor zugeordnet werden soll, und kann „Dateianhänge herunterladen und importieren“ (halten Sie die alten Medien-URLs während des Imports also erreichbar).
4. Leiten Sie die Exponential-Adressen auf die WordPress-Permalinks um (ein Weiterleitungs-Plugin oder der Webserver).
5. Benutzer: WordPress kann die Hashes von Exponential nicht prüfen; planen Sie das Zurücksetzen der Passwörter ein.

6. Risiken und Checkliste #

• To do: WXR-Export und Kopie der Uploads eingefroren; Anzahl pro Post Type notiert.
• To do: Klassen und Baum angelegt; Abbildungstabelle geschrieben.
• To do: Umwandlung an den 20 schwierigsten Einträgen getestet; Shortcodes behandelt.
• To do: Medien, Seiten, Beiträge, Kommentare mit den Remote-IDs wp-<id> importiert; interne Links umgeschrieben.
• To do: Weiterleitungstabelle erzeugt und getestet; Feeds und Uploads behandelt.
• To do: SEO-Felder, Sitemap, Analytics; Delta-Import vor der Umstellung.

Quellen #

• WP-CLI wp export: https://developer.wordpress.org/cli/commands/export/
• Paginierung der REST-API: https://developer.wordpress.org/rest-api/using-the-rest-api/pagination/
• Die Seite Werkzeuge > Daten exportieren: https://wordpress.org/documentation/article/tools-export-screen/

Diese Seite ist Teil der Exponential-Dokumentation und freie Dokumentation unter der GNU Free Documentation License 1.3 oder einer späteren Version (die Lizenz dieser Dokumentation).