« 404 Not Found » sur une fiche produit qui recevait encore des visites la veille : c’est le symptôme qui apparaît systématiquement quand une migration vers WooCommerce se limite à recréer les produits sans faire correspondre les anciennes URL aux nouvelles. Sur un catalogue d’artisanat d’un peu plus de trois cents références, cette correspondance a été traitée comme une étape à part entière, avant même l’import des fiches dans WooCommerce.
La méthode qui suit part du principe que la migration technique du catalogue et la préservation du référencement sont deux chantiers distincts, mais qui doivent être menés dans le même ordre : d’abord la correspondance, ensuite l’import, puis les redirections, jamais l’inverse.
Étape 1 : exporter la structure d’URL existante
Avant toute chose, un export complet des URL produit actuelles, avec leur identifiant interne, sert de base à la correspondance. Sur un ancien système de vente en ligne, cet export peut venir d’un sitemap existant ou d’une extraction directe de la base de données.
wp option get siteurl
wp post list --post_type=produit --fields=ID,post_title,post_name --format=csv > ancien-catalogue.csv
Étape 2 : construire le tableau de correspondance
Chaque ligne de ce tableau associe une ancienne URL à la future URL de la fiche WooCommerce correspondante. Sur ce projet, la correspondance s’est faite par référence produit interne (SKU), un identifiant stable qui ne change pas d’un système à l’autre, plutôt que par titre, souvent reformulé pendant la migration.
ancienne_url,sku,nouvelle_url
/produit/bol-en-gres-emaille/,BG-042,/produit/bol-gres-emaille-fait-main/
/produit/plateau-bois-olivier/,PB-017,/produit/plateau-olivier-massif/
Étape 3 : importer le catalogue dans WooCommerce
L’import des fiches peut se faire via l’outil natif d’import CSV de WooCommerce ou via wp wc product create pour un import scriptable. Le point de vigilance à cette étape : conserver le SKU d’origine dans le champ dédié de chaque fiche, il servira de clé de jointure pour générer les redirections à l’étape suivante.
wp wc product create \
--name="Bol en grès émaillé fait main" \
--sku="BG-042" \
--regular_price="34.00" \
--user=1
Étape 4 : générer les redirections en masse
Une fois les nouvelles URL connues, une boucle WP-CLI permet de générer les règles de redirection à partir du tableau de correspondance, sans passer une par une dans une interface d’administration.
while IFS=, read -r ancienne sku nouvelle; do
wp eval "add_redirect('$ancienne', '$nouvelle', 301);" --path=/var/www/site
done < correspondance.csv
add_redirect() représente ici une fonction interne au projet qui enregistre la règle dans la table dédiée aux redirections ; le nom exact dépend de l’extension de redirection utilisée sur le site.
Étape 5 : vérifier l’absence de boucle avant déploiement
Une redirection mal renseignée, par exemple une ancienne URL qui pointe par erreur vers elle-même après un copier-coller dans le tableau, crée une boucle immédiatement détectable par un simple test en ligne de commande sur chaque lot avant sa mise en production.
- Extraire un échantillon de vingt lignes du tableau de correspondance.
- Tester chaque redirection avec
curl -ILpour observer la chaîne complète de statuts renvoyés. - Rejeter tout lot où une chaîne dépasse un seul saut de redirection.
- Ne déployer le lot complet qu’après validation de l’échantillon.
Étape 6 : soumettre le nouveau sitemap et surveiller
Le nouveau sitemap WooCommerce, généré nativement par le cœur de WordPress depuis la version 5.5, doit être soumis dans la Search Console dès la bascule effective. Le suivi du rapport de couverture pendant les deux semaines suivantes permet de repérer rapidement toute fiche qui basculerait en erreur d’exploration plutôt qu’en redirection propre.
- Vérifier que chaque ancienne URL renvoie un statut 301 unique, jamais une chaîne de plusieurs sauts.
- Comparer les positions des mots-clés principaux avant et après bascule sur un échantillon des fiches les plus visitées.
- Garder le tableau de correspondance comme documentation de référence en cas d’anomalie détectée plus tard.
Sur ce type de migration, le SKU est systématiquement préféré au titre ou à l’identifiant interne comme clé de correspondance : c’est la seule donnée qui survit intacte à un changement complet de système de vente en ligne.
En résumé
Migrer un catalogue vers WooCommerce sans perdre les positions acquises tient moins à la technique d’import elle-même qu’à la rigueur de la correspondance d’URL établie en amont. Une clé stable comme le SKU, un tableau de correspondance vérifié par lot et des redirections testées avant déploiement suffisent, sur un catalogue de taille artisanale, à traverser la bascule sans creux de trafic.
