DfRedirects — Redirections 301 et capture des 404 pour Shopware 6

Présentation

DfRedirects ajoute à Shopware 6 un véritable gestionnaire de redirections : règles 301, 302, 307, 308 et 410 avec correspondance exacte, wildcard ou expression régulière, capture automatique des erreurs 404 rencontrées par vos visiteurs, suggestions de cible par similarité d’URL et import CSV en masse. Le plugin fonctionne sur Shopware 6.5, 6.6 et 6.7 avec un seul et même ZIP.

Installation

Depuis l’administration

1. Rendez-vous dans Extensions > Mes extensions.
2. Cliquez sur Téléverser une extension et sélectionnez le fichier DfRedirects-1.0.0.zip.
3. Cliquez sur Installer, puis activez l’extension.

En ligne de commande

bin/console plugin:refresh
bin/console plugin:install --activate DfRedirects
bin/build-administration.sh
bin/console cache:clear

L’installation crée deux tables dédiées : df_redirect (vos règles de redirection) et df_redirect_404 (le journal des URL introuvables).

Configuration générale

Ouvrez Extensions > Mes extensions > DfRedirects > Configurer. Trois réglages sont disponibles :

• Activer le journal des 404 : enregistre les URL introuvables rencontrées par vos visiteurs. Activé par défaut.
• Motifs ignorés : une entrée par ligne. Les URL correspondantes ne sont ni redirigées ni journalisées. Les jokers sont acceptés (par exemple /api-legacy/*) ; une simple chaîne suffit également, elle est recherchée dans l’URL.
• Conserver la query string : reporte les paramètres d’URL (par exemple ?utm_source=newsletter) sur l’URL de destination. Activé par défaut, sans effet sur les réponses 410.

Créer une redirection

Le module se trouve dans le menu Contenus > Redirections de l’administration. Cliquez sur Ajouter une redirection et renseignez :

• URL source : le chemin à intercepter, relatif à la racine du canal de vente (par exemple /anciens-produits/sneakers-cuir).
• URL cible : le chemin ou l’URL absolue de destination. Ce champ est masqué pour le code 410.
• Code HTTP : 301 (permanent), 302 (temporaire), 307, 308 ou 410 (page définitivement supprimée).
• Type de correspondance : exact, wildcard ou regex (voir la section suivante).
• Priorité : ordre d’évaluation des motifs, du plus élevé au plus faible. Sans effet sur les correspondances exactes.
• Canal de vente : laissez vide pour appliquer la règle à toute la boutique, ou sélectionnez un canal précis.
• Actif : permet de désactiver une règle sans la supprimer.

Les trois modes de correspondance

Exact

L’URL source doit correspondre au chemin demandé. La présence ou l’absence de barre oblique finale est tolérée : /ma-page et /ma-page/ déclenchent la même règle. C’est le mode à privilégier, il couvre la grande majorité des cas et reste le plus rapide.

Wildcard

L’astérisque * capture n’importe quelle portion d’URL. Dans l’URL cible, un astérisque au même rang reprend la valeur capturée.

Source : /collection/ete-*
Cible  : /nouveautes/*

/collection/ete-robes  →  /nouveautes/robes
/collection/ete-shorts →  /nouveautes/shorts

Regex

Pour les cas les plus fins, saisissez une expression régulière (sans délimiteurs) et référencez les groupes capturés dans la cible avec $1, $2, etc.

Source : ^/produit/([0-9]+)-(.+)$
Cible  : /p/$2

Ordre d’évaluation

1. Correspondances exactes attachées au canal de vente courant.
2. Correspondances exactes globales.
3. Motifs wildcard et regex actifs, triés par priorité décroissante.

Journal des 404

L’onglet Journal des 404 liste toutes les URL introuvables rencontrées par vos visiteurs. Chaque entrée est dédupliquée : une même URL n’apparaît qu’une fois, avec son nombre d’occurrences, le référent de la dernière visite et la date du dernier passage. Triez par nombre d’occurrences pour traiter en priorité les URL cassées qui vous coûtent le plus de trafic.

Deux actions sont disponibles sur chaque ligne :

• Créer une redirection : ouvre le formulaire avec l’URL source pré-remplie et les suggestions de cible déjà chargées. Après enregistrement, la 404 est automatiquement marquée comme résolue.
• Marquer comme résolu : classe l’entrée sans créer de règle, par exemple pour une URL qui n’a jamais existé.

Un interrupteur Afficher les résolus permet de réafficher les entrées traitées.

Suggestions de cible

Dès que vous saisissez une URL source, le plugin propose jusqu’à cinq destinations classées par score de similarité. Le calcul compare le dernier segment de l’URL cassée à vos URL SEO canoniques : un pré-filtre en base restreint le champ des candidats, puis un score de proximité textuelle les classe. Un clic sur une suggestion remplit le champ cible.

Import CSV

Le bouton Importer ouvre une fenêtre acceptant soit un fichier, soit un collage direct. Le format attendu comporte cinq colonnes :

source;cible;code;type;actif
/ancienne-page;/nouvelle-page;301;exact;1
/collection/ete-*;/nouveautes/*;301;wildcard;1
/produit-supprime;;410;exact;1

• Délimiteur : point-virgule ou virgule, détecté automatiquement.
• Ligne d’en-tête : optionnelle, elle est ignorée si elle est détectée.
• Colonnes 3 à 5 : facultatives. Par défaut, code 301, type exact, règle active.
• Type : déduit automatiquement si la source contient un astérisque.
• Codes acceptés : 301, 302, 307, 308 et 410. La cible peut rester vide pour un 410.

L’import fonctionne en mise à jour : une règle existante portant la même URL source est mise à jour plutôt que dupliquée. Les règles importées sont créées en portée globale (tous canaux). À la fin, le plugin affiche le nombre de lignes créées, mises à jour et ignorées, avec le détail des erreurs rencontrées.

Suivi des performances

Chaque règle compte ses déclenchements et mémorise la date du dernier passage. Une règle restée à zéro pendant plusieurs mois peut souvent être archivée ; à l’inverse, une règle très sollicitée signale une ancienne URL toujours largement diffusée, qu’il peut être utile de faire corriger à la source (backlink, campagne, catalogue papier).

Dépannage

Le module n’apparaît pas dans le menu Contenus

La compilation de l’administration n’a pas été exécutée après l’installation. Lancez bin/build-administration.sh puis videz le cache de votre navigateur.

Une redirection ne se déclenche pas

1. Vérifiez que la règle est active et que son canal de vente correspond (ou qu’elle est globale).
2. Vérifiez que l’URL source est bien relative à la racine du canal : sur un canal servi depuis un sous-dossier, ne saisissez pas le préfixe du domaine.
3. Vérifiez qu’aucun motif ignoré ne couvre cette URL.
4. Videz le cache : bin/console cache:clear.
5. Assurez-vous qu’aucune redirection ne soit déjà appliquée en amont par votre serveur web ou votre CDN — dans ce cas, la requête n’atteint jamais Shopware.

Le journal des 404 reste vide

Vérifiez que l’option Activer le journal des 404 est cochée dans la configuration du plugin, et que vos motifs ignorés ne sont pas trop larges. Rappelez-vous que les ressources statiques sont exclues par conception.

Une boucle de redirection

Elle survient lorsqu’une règle pointe vers une URL elle-même redirigée en retour, directement ou via un motif wildcard trop large. Recherchez l’URL cible dans la liste des sources et resserrez le motif fautif.

Désinstallation

Lors de la désinstallation, Shopware propose de conserver les données. Si vous décochez cette option, les tables df_redirect et df_redirect_404 sont supprimées définitivement, ainsi que toutes vos règles et l’historique des 404. Pensez à exporter vos règles avant si vous prévoyez une réinstallation.