Migration von WordPress

EmDash migriert Inhalte von WordPress. Importieren Sie Ihre Beiträge, Seiten, Medien und Taxonomien über das Admin-Dashboard.

Bevor Sie beginnen

Import-Methoden

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

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

WXR-Datei-Import

Inhaltskonvertierung

Gutenberg zu Portable Text

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

Unbekannte Blöcke werden als htmlBlock mit dem ursprünglichen HTML und Block-Metadaten gespeichert. Sie können diese manuell überprüfen und konvertieren oder benutzerdefinierte Portable Text-Komponenten erstellen, um sie zu rendern.

Classic Editor-Inhalte

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

Status-Zuordnung

Taxonomie-Import

Kategorien und Tags 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 während des Imports analysiert:

URL-Weiterleitungen

Nach dem Import generiert EmDash eine Weiterleitungskarte:

{
	"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" }
	]
}

Wenden Sie diese Weiterleitungen an auf:

• Cloudflare-Weiterleitungsregeln
• Die Weiterleitungskonfiguration Ihrer Hosting-Plattform
• Astros redirects-Option in astro.config.mjs

Konzept-Zuordnungsreferenz

Verwenden Sie diese Tabelle, wenn Sie WordPress-Muster an EmDash anpassen:

API-Import (Erweitert)

Der WordPress-Import ist über das Admin-Dashboard und die REST API verfügbar. Verwenden Sie den Import-Assistenten im Admin-Dashboard für die beste Erfahrung — er bietet Feldzuordnung, Konfliktlösung und Fortschrittsverfolgung.

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

Fehlerbehebung

”XML-Parsing-Fehler”

Die Exportdatei ist möglicherweise beschädigt oder unvollständig. Exportieren Sie erneut aus WordPress.

Medien-Download-Fehler

Einige Bilder befinden sich möglicherweise hinter Authentifizierung oder wurden verschoben. Der Import wird fortgesetzt und fehlgeschlagene URLs werden zur manuellen Behandlung protokolliert.

Feldtypenkonflikte

Wenn eine bestehende Sammlung ein Feld mit einem inkompatiblen Typ hat, zeigt der Import-Assistent den Konflikt an. Entweder:

• Benennen Sie das EmDash-Feld um
• Ändern Sie die WordPress-Feldzuordnung
• Löschen und erstellen Sie die Sammlung neu

Große Exporte

Für Exporte über 100 MB erwägen Sie:

1. Exportieren Sie Beitragstypen in WordPress separat
2. Importieren Sie jede Datei nacheinander
3. Verwenden Sie die CLI mit --resume für Zuverlässigkeit

Nächste Schritte

• Inhaltsimport — Andere Importquellen und -methoden
• Plugin-Portierung — WordPress-Plugin-Funktionalität migrieren
• Arbeiten mit Inhalten — Importierte Inhalte abfragen und rendern