Migrer depuis WordPress

EmDash migre le contenu depuis WordPress. Importez vos articles, pages, médias et taxonomies via le tableau de bord administrateur.

Avant de commencer

Méthodes d’importation

EmDash prend en charge trois méthodes pour importer du contenu WordPress :

Le téléchargement de fichier WXR est recommandé pour la plupart des migrations. Il capture tout le contenu, y compris les brouillons, les champs personnalisés et les articles privés.

Importation de fichier WXR

Conversion de contenu

Gutenberg vers Portable Text

EmDash convertit les blocs Gutenberg en Portable Text, un format de contenu structuré.

Les blocs inconnus sont stockés comme htmlBlock avec le HTML original et les métadonnées du bloc. Vous pouvez les réviser et les convertir manuellement ou créer des composants Portable Text personnalisés pour les rendre.

Contenu de l’éditeur classique

Le HTML de l’éditeur classique est converti en blocs Portable Text. Les styles en ligne (<strong>, <em>, <a>) deviennent des marques sur les spans.

Mappage des statuts

Importation de taxonomie

Les catégories et tags sont importés comme taxonomies avec hiérarchie préservée :

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

Champs personnalisés et ACF

Les méta de publication WordPress et les champs ACF sont analysés pendant l’importation :

Redirections d’URL

Après l’importation, EmDash génère une carte de redirection :

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

Appliquez ces redirections à :

• Règles de redirection Cloudflare
• La configuration de redirection de votre plateforme d’hébergement
• L’option redirects d’Astro dans astro.config.mjs

Référence de mappage de concepts

Utilisez ce tableau lors de l’adaptation des modèles WordPress à EmDash :

Importation API (Avancé)

L’importation WordPress est disponible via le tableau de bord administrateur et l’API REST. Utilisez l’assistant d’importation du tableau de bord administrateur pour la meilleure expérience — il fournit le mappage des champs, la résolution des conflits et le suivi de la progression.

Les endpoints de l’API d’importation sont sous /_emdash/api/import/wordpress/ pour un accès programmatique.

Dépannage

”Erreur d’analyse XML”

Le fichier d’exportation peut être corrompu ou incomplet. Réexportez depuis WordPress.

Échecs de téléchargement des médias

Certaines images peuvent être derrière une authentification ou avoir été déplacées. L’importation continue et les URLs échouées sont enregistrées pour un traitement manuel.

Conflits de types de champs

Si une collection existante a un champ avec un type incompatible, l’assistant d’importation affiche le conflit. Soit :

• Renommez le champ EmDash
• Changez le mappage de champ WordPress
• Supprimez et recréez la collection

Grandes exportations

Pour les exportations de plus de 100 Mo, envisagez :

1. Exporter les types de publication séparément dans WordPress
2. Importer chaque fichier séquentiellement
3. Utiliser la CLI avec --resume pour la fiabilité

Prochaines étapes

• Importation de contenu — Autres sources et méthodes d’importation
• Portage de plugins — Migrer les fonctionnalités de plugins WordPress
• Travailler avec le contenu — Interroger et rendre votre contenu importé