Migrer depuis WordPress
Utilisez la migration lorsque vous disposez d’un blog WordPress existant et souhaitez déplacer ses articles vers un site headless Structura — par exemple, vous fermez une installation WordPress auto-hébergée et servez le même contenu depuis un front-end Next.js, Astro ou autre.
La migration copie vos articles publiés (et optionnellement les brouillons) dans le site headless, réhéberge chaque image sur le stockage durable de Structura afin que rien ne se casse lorsque l’ancien site disparaît, conserve le slug et les métadonnées SEO de chaque article, et produit une carte de redirections pour que les moteurs de recherche suivent vos anciennes URL vers les nouvelles.
La migration est disponible sur tous les plans, y compris le plan gratuit — le plan gratuit importe jusqu’aux 500 articles les plus récents ; les plans payants sont illimités.
Avant de commencer
Vous aurez besoin de :
- Un site headless Structura déjà créé (il s’agit de la destination). Consultez Mode headless pour une vue d’ensemble de la publication headless.
- L’adresse de votre ancien site WordPress (par ex.
https://old-blog.com). - Gardez l’ancien site WordPress en ligne pendant la migration. Les images sont copiées en direct depuis celui-ci au fur et à mesure de l’importation des articles — si le site est déjà hors ligne, les images ne peuvent pas être enregistrées.
Optionnel : connecter avec des identifiants
Par défaut, la migration lit le contenu public de votre site — chaque article publié, ainsi que le titre/la description SEO depuis Yoast ou Rank Math. C’est suffisant pour la plupart des migrations.
Connectez-vous avec un mot de passe d’application si vous souhaitez également importer les brouillons et articles en attente, les champs SEO personnalisés, ou vos règles existantes du plugin Redirection. Pour en créer un sur l’ancien site :
- Sur l’ancien WordPress, allez dans Utilisateurs → Profil → Mots de passe d’application.
- Saisissez un nom (par ex. “Migration Structura”) et cliquez sur Ajouter un nouveau mot de passe d’application.
- Copiez le mot de passe généré et collez-le, avec votre nom d’utilisateur WordPress, dans l’option Avancé de la migration.
Le mot de passe d’application est utilisé uniquement pendant la durée de la migration et est supprimé dès qu’elle se termine. Vous pouvez le révoquer sur l’ancien site par la suite.
Étapes
- Ouvrez votre site headless dans le portail client et lancez une migration depuis WordPress.
- Saisissez l’adresse de votre ancien WordPress. Développez optionnellement Avancé pour vous connecter avec un nom d’utilisateur et un mot de passe d’application.
- Structura vérifie la connexion et affiche ce qu’il a trouvé — le nombre d’articles, le plugin SEO utilisé, et un modèle d’URL suggéré qui correspond à vos anciens permalinks. Ajustez le modèle d’URL de destination si vous souhaitez que les nouvelles URL correspondent exactement aux anciennes.
- Lancez la migration. Une vue de progression affiche les articles et les images en cours d’importation. Vous pouvez quitter et revenir en toute sécurité — la migration continue de s’exécuter et la progression reprend là où elle s’était arrêtée.
- Lorsqu’elle se termine, révisez l’étape des redirections et téléchargez la configuration pour votre front-end (voir ci-dessous).
Ce qui se passe ensuite
- Les articles importés apparaissent dans la liste des articles de votre site headless. Les articles qui étaient publiés sur WordPress sont publiés ; les brouillons arrivent en révision pour que vous puissiez les vérifier d’abord.
- Chaque article conserve son slug, son titre/sa description SEO et son image à la une d’origine, et son contenu est entièrement modifiable dans l’éditeur Structura.
- Les liens à l’intérieur de vos articles qui pointaient vers d’autres articles de votre ancien site sont automatiquement redirigés vers leur nouvelle adresse, de sorte que le site migré se lie à lui-même. L’importation affiche un compteur Liens corrigés une fois terminée. Quelques liens peuvent encore pointer vers votre ancien site — par exemple, des liens vers des pages qui ne sont pas des articles de blog, des articles que vous avez choisi de ne pas importer, ou des articles au-delà de la limite du plan gratuit. Ces liens fonctionnent toujours et vous pouvez les mettre à jour quand vous le souhaitez.
- La migration produit une carte de redirections de vos anciennes URL vers les nouvelles. Appliquez-la sur ce qui sert votre nouveau site afin que les anciens liens et les résultats des moteurs de recherche continuent de fonctionner :
- Next.js / Vercel — collez dans les redirections de votre
next.configou dansvercel.json. - Apache — ajoutez les règles à votre
.htaccess. - nginx — ajoutez les règles à votre bloc serveur.
- CSV / JSON — une carte portable pour toute autre configuration.
- Next.js / Vercel — collez dans les redirections de votre
Une fois le nouveau site en ligne et les redirections en place, vous pouvez fermer l’ancien blog WordPress en toute sécurité.
Problèmes courants
« Impossible d’atteindre le site. » Vérifiez l’adresse (incluez https://) et que le site est en ligne. Les sites protégés par un mot de passe, une liste d’autorisation d’IP ou un plugin « coming soon » ne peuvent pas être lus.
« Échec de connexion » avec des identifiants. Le nom d’utilisateur ou le mot de passe d’application est incorrect, ou les mots de passe d’application sont désactivés sur le site source. Recréez le mot de passe d’application et réessayez — ou laissez les champs Avancé vides pour importer uniquement les articles publics.
Certaines images ne sont pas arrivées. Les images sont copiées en direct depuis l’ancien site ; si celui-ci est passé hors ligne en cours de migration, ou si une image était déjà un lien brisé, cette image est ignorée et le reste de l’article est tout de même importé.
Le plan gratuit s’est arrêté à 500 articles. Le plan gratuit importe vos 500 articles les plus récents. Effectuez une mise à niveau pour importer le reste d’une archive plus importante.
Pages connexes
- Mode headless — publication vers un site public distinct.
- Articles générés — modification et publication d’articles dans un site headless.
Dernière mise à jour :