Guide produit

Gestionnaire de redirections

Importer une cartographie CSV validée, servir des redirections exactes, exporter vers CSV, Nginx ou Apache et tracer chaque changement.

Version publiée: 0.3.4
Compatibilités: WordPress 6.3 minimum · 6.8.8, 7.0.4 et 7.1 recettés · PHP 8.2 à 8.4 recettés · CSV
Fiche produit: Gestionnaire de redirections

Prérequis

Ces extensions fonctionnent entièrement sur votre serveur, sans compte et sans connexion à un service distant : aucune clé d’activation n’est demandée, aucune vérification de licence n’est effectuée et aucun appel n’est émis vers un serveur de Novelience, ni à l’activation ni pendant l’utilisation. Une version installée continue donc de fonctionner à l’identique si votre abonnement prend fin ; l’abonnement ouvre le support et l’accès aux nouvelles versions, que vous téléchargez depuis votre espace client et installez vous-même. Le gestionnaire n’effectue aucune requête sortante : tout se passe entre WordPress et sa base de données.

Composant	Versions recettées
WordPress	6.3 minimum · 6.8.8, 7.0.4 et 7.1 recettés
PHP	8.2 minimum · 8.2, 8.3 et 8.4 recettés
Base de données	MySQL 8 ou MariaDB 10.6 et supérieurs
Droits	Un compte administrateur pour installer ; manage_options pour ouvrir l’écran, importer et exporter (modifiable par le filtre wp_redirect_map_capability)
WP-CLI	Facultatif : les mêmes opérations existent depuis l’administration

Installation

Téléchargez l’archive depuis Espace client › Mes produits et licences, puis vérifiez son empreinte SHA-256 avec celle affichée (sous Linux ou macOS : sha256sum redirect-map-manager-0.3.4.zip).
Dans WordPress, ouvrez Extensions › Ajouter › Téléverser une extension, sélectionnez l’archive et cliquez sur Installer.
Activez l’extension. Les tables nécessaires sont créées à l’activation ; un message d’erreur apparaît dans l’administration si la base de données refuse leur création.
Affectez la licence au site dans votre espace client (Réaffecter ce droit) : c’est ce qui ouvre le support et les mises à jour pour ce site.

Trois tables sont créées : {prefix}redirect_map (cartographie active), {prefix}redirect_map_history (imports) et {prefix}redirect_map_changes (changements de chaque import).

Préparer la cartographie

Le fichier CSV comporte les colonnes source_url, target_url et decision, dans l’ordre que vous voulez, plus une colonne reason facultative conservée comme note de 255 caractères au plus. Il doit être séparé par des virgules et encodé en UTF-8 : un champ contenant une virgule s’entoure de guillemets doubles, un guillemet interne se double, et un export tableur en point-virgule doit être reconverti. Seules les lignes dont decision vaut redirect_301 sont importées ; la source et la cible doivent avoir le même hôte, un préfixe www. étant ignoré de part et d’autre pour cette comparaison.

Les deux adresses doivent être absolues et commencer par http:// ou https:// ; un chemin relatif est refusé. Le schéma de la source n’est pas conservé : http et https désignent la même source. Le chemin perd sa barre finale, à l’import comme à chaque requête, si bien que /page et /page/ sont une seule source ; l’hôte est mis en minuscules, le chemin conserve sa casse. La cible, elle, est enregistrée telle quelle.

source_url,target_url,decision,reason
https://www.exemple.fr/ancienne-page,https://www.exemple.fr/nouvelle-page,redirect_301,Migration 2026
https://www.exemple.fr/promo-2024,https://www.exemple.fr/offres/,redirect_301,Campagne terminée
https://www.exemple.fr/a-conserver,https://www.exemple.fr/a-conserver,keep,Page conservée

Les chaînes A → B → C sont repliées : A redirige directement vers C. Le repli ne retient que l’hôte et le chemin du maillon suivant : une chaîne de requête portée par une cible intermédiaire disparaît de la cible finale.
Les boucles, les doublons de source, les auto-redirections, les adresses source ou cible porteuses d’identifiants, les cibles d’un autre domaine et les lignes mal formées font échouer l’import avant tout remplacement. Le contrôle de structure s’applique à toutes les lignes, y compris à celles dont la décision n’est pas redirect_301.
La limite est de 50 000 redirections redirect_301, et de 5 Mo par fichier pour l’import depuis l’administration.
Un chemin dépasse au plus 512 caractères et une cible 1 024 ; deux chemins qui partagent leurs 190 premiers caractères, ou qui ne diffèrent que par la casse, sont refusés par la base. Ce refus-là est le seul qui ne nomme pas la ligne en cause.

Utilisation

Ouvrez Outils › Cartographie de redirections, choisissez le fichier CSV, ajoutez une note (lot de migration, ticket) et cliquez sur « Valider et remplacer la cartographie ».
L’import remplace la cartographie complète dans une transaction et enregistre dans l’historique : date en temps universel, auteur, fichier et empreinte SHA-256, nombre de redirections, ajouts, modifications et suppressions par rapport à la cartographie précédente.
Cliquez sur la date d’un import pour afficher chaque changement : source, cible précédente, nouvelle cible.
La cartographie active se consulte et se recherche par hôte, chemin ou cible, cinquante lignes par page ; la note n’est pas indexée par la recherche. L’écran conserve les vingt derniers imports et affiche au plus 2 000 changements pour un import donné.
Exportez à tout moment en CSV (réimportable), en bloc map Nginx ou en directives Apache RedirectPermanent. Ces exports reproduisent la cartographie mais pas les règles de normalisation appliquées par WordPress, et l’export Apache ne transcrit pas l’hôte : une cartographie couvrant plusieurs hôtes doit y être découpée à la main.
Testez une ancienne URL : elle répond 301 vers sa destination finale. La cible stockée est revalidée à chaque requête.

wp redirect-map import /chemin/carte.csv --note="Lot 3"
wp redirect-map export --format=csv|nginx|apache
wp redirect-map history

Points d’extension

Crochet	Rôle
wp_redirect_map_capability	Capacité requise pour ouvrir l’écran, importer et exporter (manage_options par défaut).
wp_redirect_map_import_rows · wp_redirect_map_before_import · wp_redirect_map_imported	Filtrage des lignes validées et actions autour de l’import.
wp_redirect_map_target · wp_redirect_map_status · wp_redirect_map_before_redirect	Cible, code de statut (301, 302, 307, 308) et action avant redirection.

Limites et sécurité

Correspondance exacte hôte + chemin, sans motifs : c’est ce qui rend chaque redirection vérifiable. Le site répondant sous les deux écritures du même hôte, une source écrite avec www. répond aussi sans, et réciproquement.
La chaîne de requête de l’adresse demandée n’est pas reportée sur la destination : /ancienne-page?utm_source=lettre renvoie vers la cible sans ce paramètre. Les paramètres de campagne et de pagination sont donc perdus au passage.
Le chemin demandé n’est pas décodé : une source contenant un caractère accentué doit être écrite dans le fichier sous sa forme encodée, telle qu’elle apparaît dans les journaux du serveur.
Aucune redirection vers un autre domaine, à l’import comme à l’exécution.
Les redirections sont servies par WordPress ; pour les très gros volumes, exportez la cartographie vers Nginx ou Apache.

Désinstaller depuis Extensions › Supprimer retire les trois tables et les options. Désactiver sans supprimer conserve tout.

Journal des versions

Version	Changements
0.3.4	Une valeur négative de réglage n’est plus transformée en sa valeur absolue : la borne basse qui la suit s’applique enfin. Un numéro de page négatif était transformé en son opposé.
0.3.3	Une redirection allant d’une écriture de l’hôte vers l’autre est refusée à l’import : servie au visiteur, elle bouclait sans fin. Le refus d’une adresse qui se redirige vers elle-même s’applique enfin, là où il était inatteignable.
0.3.2	Un site joignable avec et sans le préfixe www. répond depuis une seule cartographie : une source écrite pour une écriture redirige aussi pour l’autre. L’extension n’interroge plus le répertoire WordPress.org pour ses mises à jour.
0.3.1	Fichier d’identité du produit ajouté dans l’archive : nom commercial, référence, version livrée et socles requis.
0.3.0	Écran Outils › Cartographie de redirections (import CSV, recherche, pagination), historique des imports avec changements par ligne, exports CSV, Nginx et Apache, commandes WP-CLI export et history, traduction française, désinstallation propre.
0.2.0	Version initiale publiée (import WP-CLI uniquement), retirée de la distribution le 6 septembre 2026.

Un e-mail vous prévient à chaque nouvelle version ; l’archive et son empreinte sont dans Espace client › Mes produits et licences.
Téléversez la nouvelle archive dans Extensions › Ajouter › Téléverser une extension et confirmez le remplacement de la version installée. Les données et réglages sont conservés ; les migrations de schéma s’exécutent au premier chargement.
Après une mise à jour, contrôlez le journal des versions ci-dessous : il indique les changements de comportement à vérifier.

Support

Une question sur l’installation ou la configuration ?

Choisir une offre Écrire au support