Comment migrer de WordPress vers EmDash: Guide complet (2026)

Migrer votre site d’une plateforme à une autre est décourageant. Vous vous inquiétez:

• Perdre des classements de recherche
• Briser l’expérience utilisateur
• Perdre du contenu ou des fonctionnalités
• Les temps d’arrêt

La bonne nouvelle: la migration WordPress vers EmDash est simple. La différence de plateforme est énorme, mais la migration de contenu est gérable. Ce guide couvre à la fois l’approche DIY (si vous êtes technique) et quand embaucher un service.

Conditions préalables

Avant de commencer, vous aurez besoin de:

1. Accès à votre site WordPress (identifiants d’administrateur, accès à la base de données si vous empruntez la route DIY)
2. Un compte Cloudflare (le niveau gratuit est bien au démarrage)
3. Un projet EmDash (créé sur https://emdash.io)
4. Une familiarité de base avec les concepts de génération de sites statiques (pas requis, mais utile)

Méthode 1: Utilisation de l’exportateur WordPress EmDash (Recommandé pour DIY)

EmDash fournit un plugin d’exportateur WordPress officiel. C’est le chemin le plus facile.

Étape 1: Installez le plugin d’exportateur EmDash

1. Allez au tableau de bord d’administration WordPress
2. Naviguez vers Plugins → Ajouter nouveau
3. Cherchez «EmDash Exporter»
4. Cliquez sur Installer et Activer

Étape 2: Exportez votre contenu

1. Allez à Outils → EmDash Export
2. Sélectionnez les types de contenu que vous souhaitez exporter (articles, pages, types de messages personnalisés)
3. Configurer:
   • Exporter les fichiers multimédias: Oui (recommandé)
   • Inclure les commentaires: Choisissez selon vos besoins
   • Exporter les données utilisateur: Non (vous recréerez les utilisateurs dans EmDash)
4. Cliquez sur Générer l’exportation
5. Téléchargez le fichier .zip

Cela crée une exportation structurée de tout votre contenu, formatée pour les collections de contenu d’EmDash.

Étape 3: Préparez votre projet EmDash

1. Créez un nouveau projet EmDash sur https://emdash.io (ou utilisez l’existant)
2. Clonez le référentiel du projet localement:

   git clone https://github.com/yourusername/your-emdash-project.git
   cd your-emdash-project
   

Étape 4: Importez le contenu

1. Extrayez le fichier d’exportation WordPress
2. Copiez les fichiers de contenu dans le répertoire src/content/ de votre projet EmDash
3. Examinez le frontmatter (titre, date, description, etc.) — EmDash utilise le frontmatter YAML/TOML
4. Assurez-vous que le formatage markdown est correct (les exportations HTML WordPress doivent être converties)

Remarque: EmDash utilise des collections de contenu TypeScript avec des schémas Zod. L’exportateur gère la plupart de cela, mais vous devrez peut-être ajuster manuellement:

• Images en vedette (EmDash s’attend à des chemins d’image, pas des URL)
• Métadonnées personnalisées
• Catégories imbriquées (EmDash utilise des tags, pas des catégories hiérarchiques)

Étape 5: Créez des redirections 301

C’est critique pour le référencement. Vous devez rediriger chaque URL WordPress vers son équivalent EmDash.

Dans Cloudflare Pages:

1. Créez un fichier _redirects dans votre répertoire public/:

   /blog/old-post-slug /blog/new-post-slug 301
   /category/news /blog 301
   /2024/04/my-post /blog/my-post 301
   

2. Ou utilisez Cloudflare Workers pour les redirections dynamiques (plus flexible):

   export default {
     async fetch(request) {
       const url = new URL(request.url);
   
       // Carte de redirection
       const redirects = {
         '/old-url': '/new-url',
         '/blog/wordpress-post': '/blog/emdash-post',
       };
   
       if (redirects[url.pathname]) {
         return Response.redirect(redirects[url.pathname], 301);
       }
   
       return fetch(request);
     },
   };
   

Pro tip: Utilisez les outils de migration EmDash pour générer automatiquement des cartes de redirection à partir de votre exportation WordPress.

Étape 6: Testez sur staging

1. Construisez votre projet EmDash localement:

   npm install
   npm run build
   npm run preview
   

2. Vérifier:

   • Tout le contenu est présent
   • Les images s’affichent correctement
   • Les liens fonctionnent (y compris les redirections)
   • La mise en page et le style semblent bons
   • Pas d’erreurs de console

3. Déployez sur un environnement de staging sur Cloudflare Pages:

   npm run build
   # Déployer sur la branche de staging ou un domaine séparé
   

4. Testez de manière approfondie en staging — c’est ici que vous repérez les problèmes avant de passer en direct.

Étape 7: Basculement DNS (Zéro temps d’arrêt)

C’est le moment de la vérité. Vous pointez votre domaine vers EmDash.

Timing: Planifiez ceci pour les heures à faible trafic (par exemple, 2h du matin un mardi).

1. Vérifiez que Cloudflare Pages est configuré:

   • Le DNS de votre domaine pointe vers Cloudflare Pages
   • Le certificat SSL est configuré
   • Toutes les pages se chargent correctement en staging

2. Planifiez votre séquence de basculement:

   • Gardez le site WordPress en cours d’exécution (ne l’éteignez pas encore)
   • Mettez à jour le DNS pour pointer vers EmDash (TTL: 5 minutes)
   • Vérifiez que le nouveau site est servi correctement
   • Gardez la surveillance pendant 30 minutes
   • Après 30 minutes de trafic stable, vous pouvez désactiver WordPress

3. Pendant le basculement:

   Ancien DNS: CNAME yoursite.com → wordpress-server.com
   Nouveau DNS: CNAME yoursite.com → yoursite.pages.dev
   

4. Mettez à jour les enregistrements DNS dans votre registraire (GoDaddy, Namecheap, etc.):

   • Pointez le CNAME de votre domaine vers yoursite.pages.dev
   • Mettez à jour les enregistrements MX si vous utilisez le courrier électronique
   • Mettez à jour les autres enregistrements DNS (SPF, DKIM, etc.)

5. Attendez la propagation (généralement 5-15 minutes, jusqu’à 48 heures dans le pire cas)

6. Vérifier:

   # Vérifier la résolution DNS
   nslookup yoursite.com
   
   # Devrait retourner l'IP de Cloudflare Pages
   # Devrait se charger correctement dans le navigateur
   

Méthode 2: Export manuel via XML WordPress (pour sites complexes)

Si le plugin d’exportateur ne gère pas votre configuration, vous pouvez exporter manuellement.

Étape 1: Exportez les données WordPress

1. Allez à Outils → Exporter
2. Sélectionnez «Tout le contenu»
3. Téléchargez le fichier .xml (format WXR)

Étape 2: Convertir au format EmDash

Le format XML doit être converti en markdown. Utilisez un outil de conversion:

# Utilisation du package npm (exemple)
npx wordpress-to-markdown yoursite.xml --output ./src/content/blog

Cela génère des fichiers .md avec frontmatter YAML, prêts pour EmDash.

Étape 3: Assurance qualité manuelle

Vous devrez probablement:

• Vérifier le formatage markdown
• Corriger les chemins des images
• Ajuster les champs personnalisés
• Gérer les taxonomies (catégories → tags)

Cette méthode prend plus de temps mais vous donne plus de contrôle.

Gestion des cas spéciaux

Boutiques WooCommerce

La migration WooCommerce n’est pas encore couverte par le service de migration actuel. La couche e-commerce EmDash (shopemdash.com) est actuellement en développement. Une fois disponible, elle permettra des migrations WooCommerce complètes incluant produits, données clients et historique des commandes.

En attendant, si votre site comporte une boutique WooCommerce, deux options s’offrent à vous :

1. Migrer uniquement la partie contenu/blog de votre site maintenant, et conserver WooCommerce sur un sous-domaine temporairement
2. Rejoindre la liste d’attente shopemdash.com pour être notifié dès que la migration e-commerce sera disponible

Types de messages personnalisés

Si vous avez des types de messages personnalisés (par exemple, « Projets de portefeuille »), vous devez:

1. Les mapper aux collections de contenu EmDash:

   // src/content/config.ts
   const portfolio = defineCollection({
     type: 'content',
     schema: z.object({
       title: z.string(),
       description: z.string(),
       images: z.array(z.string()),
       projectLink: z.string(),
     }),
   });
   

2. Exportez les données et créez les fichiers markdown correspondants

3. Mettez à jour vos modèles pour afficher la nouvelle collection

Sites multilingues

Si vous avez un site WordPress multilingue (utilisant WPML ou Polylang):

1. Exportez chaque langue séparément

2. Organisez dans EmDash en utilisant les collections de contenu localisées:

   src/content/blog/
   ├── en/
   │   ├── post-1.md
   │   └── post-2.md
   └── fr/
       ├── post-1.md
       └── post-2.md
   

3. Configurez le routage d’internationalisation Astro pour servir la version linguistique correcte

Liste de vérification post-migration

Après que votre site soit en direct, vérifiez tout:

• Toutes les pages se chargent sans erreurs
• Les images s’affichent correctement
• Les liens fonctionnent (internes et externes)
• Les redirections 301 fonctionnent (curl -I yoursite.com/old-url devrait afficher 301)
• Les formulaires se soumettent correctement
• Google Analytics suit les pages vues
• La fonctionnalité de recherche fonctionne
• La mise en page mobile est réactive
• Tous les éléments qui existaient avant fonctionnent maintenant

Surveiller pendant 30 jours

Après la mise en direct, surveillez de près:

1. Métriques de trafic — Surveillez les baisses de trafic organique/référencé (il ne devrait y en avoir aucune)
2. Search Console — Surveillez les erreurs d’exploration ou les chaînes de redirection
3. Journaux d’erreurs — Vérifiez les erreurs 404 ou du serveur
4. Commentaires des utilisateurs — Demandez aux utilisateurs de signaler les problèmes

La plupart des problèmes apparaissent dans la première semaine. Au jour 30, vous pouvez être sûr que la migration est stable.

Quand utiliser le service professionnel

La migration DIY a du sens si:

• Votre site est simple (< 50 pages, < 200 articles)
• Aucun plugin personnalisé ni type de message
• Vous êtes à l’aise avec les tâches techniques
• Aucun WooCommerce ou intégration complexe

Utilisez le service professionnel si:

• Votre site est volumineux (1000+ pages)
• Vous avez des plugins ou des types de messages personnalisés
• Vous exécutez WooCommerce
• Vous ne pouvez pas vous permettre les temps d’arrêt ou les problèmes
• Vous voulez le support post-lancement garanti de 30 jours

WP→EmDash gère:

• Migration complète du contenu
• Récréation du design (pixel-parfait si possible)
• Toutes les redirections 301
• Validation de staging
• Basculement DNS sans temps d’arrêt
• Surveillance post-lancement de 30 jours et support

Coût: 499€ pour les sites simples, devis personnalisés pour les migrations complexes.

Dépannage des problèmes courants

Les images ne se chargent pas après la migration

Cause: Les chemins de l’image sont incorrects

Solution:

// Dans vos composants Astro, utilisez les chemins d'image corrects
import { Image } from 'astro:assets';

<Image src={import('../../images/my-image.png')} alt="..." />

Les anciennes URL ne sont pas redirigées

Cause: La carte de redirection est incomplète ou mal configurée

Solution:

1. Testez les redirections: curl -I yourdomain.com/old-url
2. Vérifiez que le fichier _redirects existe dans public/
3. Vérifiez le script Cloudflare Workers (si utilisé)
4. Reconstruisez et redéployez

Google Search Console affiche des erreurs

Cause: Problèmes d’exploration pendant la migration

Solution:

1. Allez à Google Search Console
2. Soumettez votre sitemap (Astro génère sitemap.xml automatiquement)
3. Marquez les URL comme «corrigées» après vérification
4. Demandez la réindexation des pages critiques

Les performances ne sont pas comme prévu

Cause: Images non optimisées ou trop de JavaScript

Solution:

• Utilisez astro:assets pour l’optimisation automatique des images
• Supprimez le JavaScript inutile (EmDash est par défaut zéro JS)
• Utilisez la génération statique pour toutes les pages de contenu
• Vérifiez que la mise en cache Cloudflare est activée

Conclusion

La migration WordPress vers EmDash est réalisable, que ce soit en DIY ou avec une aide professionnelle. Les étapes clés sont:

1. Exportez votre contenu (à l’aide de l’exportateur officiel)
2. Importez dans les collections de contenu EmDash
3. Configurez les redirections 301 appropriées
4. Testez de manière approfondie en staging
5. Basculement DNS pendant les heures à faible trafic
6. Surveillez pendant 30 jours

Le résultat: un site plus rapide, plus sûr et moins cher sans temps d’arrêt.

Prêt à commencer? Obtenez un devis de migration gratuit ou contactez-nous si vous avez des questions.