Migration von WordPress

EmDash bietet einen vollständigen Migrationspfad von WordPress. Importieren Sie Beiträge, Seiten, Medien und Taxonomien über das Admin-Dashboard – ohne CLI.

Bevor Sie starten

Importmethoden

EmDash unterstützt drei Methoden zum Import von WordPress-Inhalten:

Der WXR-Datei-Upload wird für die meisten Migrationen empfohlen. Er erfasst alle Inhalte einschließlich Entwürfe, benutzerdefinierter Felder und privater Beiträge.

WXR-Dateiimport

Inhaltskonvertierung

Gutenberg zu Portable Text

EmDash wandelt Gutenberg-Blöcke in Portable Text, ein strukturiertes Inhaltsformat.

Unbekannte Blöcke werden als htmlBlock mit Original-HTML und Block-Metadaten gespeichert. Sie können sie manuell prüfen und konvertieren oder eigene Portable-Text-Komponenten zum Rendern erstellen.

Classic-Editor-Inhalte

HTML aus dem Classic Editor wird in Portable-Text-Blöcke umgewandelt. Inline-Styles (<strong>, <em>, <a>) werden zu Markierungen auf Spans.

Status-Zuordnung

Taxonomie-Import

Kategorien und Schlagwörter werden als Taxonomien mit erhaltener Hierarchie importiert:

WordPress:                    EmDash:
├── Categories (hierarchical) ├── taxonomies table
│   ├── News                  │   ├── category/news
│   │   ├── Local             │   ├── category/local (parent: news)
│   │   └── World             │   ├── category/world (parent: news)
│   └── Sports                │   └── category/sports
└── Tags (flat)               └── content_taxonomies junction
    ├── featured                  ├── tag/featured
    └── breaking                  └── tag/breaking

Benutzerdefinierte Felder und ACF

WordPress-Post-Meta und ACF-Felder werden beim Import analysiert:

URL-Weiterleitungen

Nach dem Import erzeugt EmDash eine Redirect-Map:

{
	"redirects": [
		{ "from": "/?p=123", "to": "/posts/hello-world" },
		{ "from": "/2024/01/hello-world/", "to": "/posts/hello-world" },
		{ "from": "/category/news/", "to": "/categories/news" }
	],
	"feeds": [
		{ "from": "/feed/", "to": "/rss.xml" },
		{ "from": "/feed/atom/", "to": "/atom.xml" }
	]
}

Diese Weiterleitungen anwenden auf:

• Cloudflare Redirect Rules
• Redirect-Konfiguration Ihrer Hosting-Plattform
• Astros Option redirects in astro.config.mjs

Konzept-Mapping (Referenz)

Diese Tabelle hilft beim Übertragen von WordPress-Mustern auf EmDash:

API-Import (fortgeschritten)

Der WordPress-Import ist über das Admin-Dashboard und die REST-API verfügbar. Für die beste Erfahrung den Import-Assistenten nutzen – er bietet Feldzuordnung, Konfliktlösung und Fortschrittsanzeige.

Die Import-API-Endpunkte liegen unter /_emdash/api/import/wordpress/ für programmatischen Zugriff.

Fehlerbehebung

„XML parsing error“

Die Exportdatei ist möglicherweise beschädigt oder unvollständig. Erneut aus WordPress exportieren.

Medien-Download schlägt fehl

Einige Bilder können hinter Authentifizierung liegen oder umgezogen sein. Der Import läuft weiter; fehlgeschlagene URLs werden protokolliert.

Feldtyp-Konflikte

Wenn eine bestehende Collection ein Feld mit inkompatiblem Typ hat, zeigt der Assistent den Konflikt. Dann entweder:

• EmDash-Feld umbenennen
• WordPress-Feldzuordnung ändern
• Collection löschen und neu anlegen

Große Exporte

Bei Exporten über 100 MB:

1. Post Types in WordPress getrennt exportieren
2. Dateien nacheinander importieren
3. CLI mit --resume für Zuverlässigkeit nutzen

Nächste Schritte

• Content Import — Weitere Importquellen und -methoden
• Plugin Porting — WordPress-Plugin-Funktionalität migrieren
• Working with Content — Importierte Inhalte abfragen und rendern