L’extension « Migrate Polylang to WPML » facilite la migration des sites de l’extension Polylang vers WPML. Elle migre les informations de langue pour les articles, les pages, les types de publication personnalisés et les taxonomies.
Prérequis
Bien sûr, vous devez posséder un compte WPML pour migrer vers WPML. Le compte Multilingual Blog conviendra à la plupart des sites provenant de Polylang. Pour profiter de toutes les fonctionnalités de WPML, vous devriez obtenir le compte Multilingual CMS, qui inclut la Traduction de chaînes et la Gestion de traduction.
Vous devez également installer l’extension Migrate Polylang to WPML.
Téléchargement de l’extension « Migrate Polylang to WPML »
Pour la télécharger, accédez à Migrate Polylang to WPML sur Github et obtenez la dernière version publiée (cliquez sur la dernière version dans la barre latérale droite). Sur la page qui se charge, cliquez sur le format que vous préférez (zip ou tar.gz).
Après avoir téléchargé l’extension, vous pouvez la téléverser sur votre site WordPress comme n’importe quelle autre extension : accédez à la page Tableau de bord → Extensions et cliquez sur le bouton Ajouter. Sur la page suivante, cliquez sur Téléverser une extension et choisissez l’archive téléchargée.
Étape de migration 1 : enregistrer les données de Polylang et le désactiver
Pour enregistrer les données de Polylang, suivez les étapes ci-dessous :
- Accédez à Langues → Langues.
- Cliquez sur le lien Modifier pour chaque langue, puis cliquez sur le bouton Mettre à jour.
Après avoir enregistré les données de Polylang pour toutes les langues, vous devez désactiver Polylang avant de lancer le processus de migration vers WPML. Toute tentative d’activation de WPML alors que Polylang est actif entraînera une erreur fatale de WordPress. N’oubliez donc pas de désactiver Polylang avant d’activer toutes les extensions mentionnées dans la section Prérequis.
Étape de migration 2 : sauvegarde de la base de données
Le processus de migration modifie les paramètres globaux du site et met à jour les informations de langue de tout le contenu de votre site. Vous devez absolument créer une sauvegarde complète de votre base de données avant de démarrer le processus de migration (même si vous l'avez déjà fait avec succès sur d'autres sites).
Il existe plusieurs excellentes extensions de sauvegarde et vous pouvez également faire un instantané de la base de données depuis le panneau de configuration de votre hébergement.
Étape de migration 3 : terminer l'assistant WPML
Lorsque vous activez WPML, vous verrez un message vous demandant de terminer l'assistant d'installation de WPML. Il s'agit de l'assistant standard d'installation de l'extension WPML affiché pour chaque utilisateur de WPML, et pas seulement pour ceux qui migrent depuis Polylang. Veuillez suivre les instructions à l'écran de l'assistant. N'oubliez pas de sélectionner les mêmes langues que celles que vous avez sélectionnées dans Polylang. L'extension de migration affichera des infobulles vous rappelant les paramètres que vous avez choisis pour Polylang :
Étape de migration 4 : lancer la migration
Accédez à Tableau de bord → Outils → Migrate from Polylang to WPML, cochez la case « I confirm that I’ve created database backup » pour confirmer que vous avez sauvegardé votre base de données (voir l'étape 1 ci-dessus) et cliquez sur le bouton Migrate.
Important : ne fermez pas cette page tant que vous ne voyez pas le message indiquant que la migration est terminée. Cela peut prendre quelques minutes selon la quantité de contenu de votre site Web.
Examinez votre site et vérifiez que la migration s'est bien déroulée
Une fois le processus de migration terminé, vérifiez si tout fonctionne comme prévu :
- Les articles sont dans les bonnes langues.
- Le sélecteur de langue redirige vers les bonnes traductions.
Si un problème est survenu lors de la migration, veuillez le signaler à l'assistance WPML. Si le processus s'est bloqué pendant la migration, vous pouvez le relancer. La migration ne traitera que le contenu qui n'a pas encore été traité.
Vous aurez la possibilité de supprimer les données restantes de Polylang après la migration. Nous vous recommandons vivement de reporter le processus de suppression des données de Polylang de quelques jours ou semaines. N'oubliez pas que la suppression du contenu de la base de données de Polylang est un processus irréversible. Si vous remarquez qu'un problème est survenu, vous ne pourrez pas refaire la migration une fois la base de données de Polylang supprimée.
Gestion des différentes structures d'URL
Polylang redirige toujours de la racine du site (example.com) vers le dossier de la langue par défaut (example.com/en/). WPML affiche la langue par défaut dans l'URL racine. S'il existe des liens vers le dossier de la langue par défaut, nous vous recommandons d'ajouter une redirection de serveur de celui-ci vers la racine du site.
Suivez ces étapes pour ajouter une redirection 301 à l'aide du fichier .htaccess :
- Connectez-vous à votre site WordPress à l'aide d'un client FTP et téléchargez le fichier « .htaccess », qui se trouve dans le dossier racine de WordPress.
- À la fin du fichier, ajoutez cette ligne :
RedirectMatch 301 /en/$ http://example.com/index.php(remplacez « en » par le slug de votre langue par défaut et « example.com » par l'URL de votre site)
- Téléversez à nouveau ce fichier sur votre serveur.
Enfin, désactivez l'extension de migration
L'extension Migrate Polylang to WPML n'est nécessaire que pour le processus de migration. Une fois que vous avez terminé, vous devez la désactiver. Vous pouvez également la supprimer du répertoire « plugins » de votre site.
Obtenir de l'aide
Si vous rencontrez des problèmes avec le processus de migration, veuillez poser une question à l'assistance WPML.