Redirections 301 et journal 404 – manuel d’utilisation

Page du module : Redirections 301 et journal 404 PDF · 171 KB

1. À quoi sert le module

Après une migration vers PrestaShop, un changement de nom de produits ou la suppression de catégories, les anciennes adresses ne fonctionnent plus : les visiteurs venus de Google ou d’anciens liens tombent sur « Page introuvable » et la boutique perd ses positions dans les résultats de recherche. Le module envoie ces visiteurs vers la bonne page avec une redirection 301 (Google transfère le classement vers la nouvelle adresse) ou 302, et tient un journal des adresses qui ont abouti à une page 404 : vous voyez ce qui est cassé et le réparez en un clic.

Compatible avec PrestaShop 1.7.8, 8.x et 9.x (PHP 7.2.5 ou plus récent), avec les thèmes Classic et Hummingbird et en multiboutique.

2. Installation

  1. Téléchargez le module depuis Mon compte → Historique des commandes sur addonspresta.com.
  2. Dans votre back-office, ouvrez Modules → Gestionnaire de modules et cliquez sur Installer un module.
  3. Déposez le fichier ap_redirects_v1.0.0.zip et attendez la confirmation.
  4. Cliquez sur Configurer sur la carte du module.

Dès l’installation, les redirections et le journal 404 sont actifs. Le journal se remplit dès que des visiteurs arrivent sur des pages manquantes.

3. Fonctionnement

Chaque page de la boutique ouverte par un visiteur ou un moteur de recherche passe par le module avant que PrestaShop ne la construise. Le module compare l’adresse avec vos redirections :

  • d’abord une redirection de cette adresse exacte avec ses paramètres (?…), puis de ce chemin exact ;
  • ensuite la redirection « commence par » la plus longue, par exemple /blog/ pour toutes les anciennes adresses du blog ;
  • une redirection de la boutique choisie en multiboutique l’emporte sur une redirection pour toutes les boutiques.

Quand une redirection correspond, le visiteur part directement vers la nouvelle adresse et le compteur de la redirection augmente. Les formulaires envoyés par le visiteur, les appels AJAX et le back-office ne sont jamais redirigés.

Les adresses sont comparées sans le domaine, décodées (%20 est une espace), avec les majuscules et la barre oblique finale telles que saisies. Les paramètres de l’adresse du visiteur ne sont pas ajoutés à la nouvelle adresse.

Quand une page aboutit à « Page introuvable » (code 404) — adresse erronée, produit, catégorie ou page CMS supprimés —, le module enregistre l’adresse dans le journal 404, ou augmente son nombre de visites, avec la date et le dernier référent (la page d’où vient le visiteur). Les deux sont enregistrés sans la partie après ?, qui peut contenir des codes d’autres pages. Il n’enregistre aucune adresse IP ni rien sur le visiteur.

Les images et les fichiers CSS et JavaScript sont servis directement par le serveur web et n’atteignent jamais PrestaShop : le module ne peut ni les rediriger ni les enregistrer. Le module ne modifie pas les tables de PrestaShop et ne se connecte ni à addonspresta.com ni à aucun autre serveur.

4. Fonctionnalités et réglages

Ouvrez Modules → Gestionnaire de modules → Redirections 301 et journal 404 → Configurer. Le cadre Aide, en haut, renvoie vers ce manuel et vers la page du module sur addonspresta.com, dans la langue de votre back-office.

Réglages

  • Rediriger les anciennes adresses : désactivez pour arrêter toutes les redirections d’un coup sans les supprimer.
  • Enregistrer les pages 404 : active ou désactive le journal 404.
  • Conserver au maximum … entrées du journal : de 100 à 100 000 (5 000 par défaut). Les adresses non visitées depuis le plus longtemps sont supprimées en premier.

Redirections

La liste affiche 50 redirections par page avec l’ancienne adresse, la correspondance, la nouvelle adresse, le type, le nombre de visites et la dernière visite. Le champ de recherche retrouve une adresse et les numéros de page permettent de parcourir la liste. Cliquez sur l’icône d’état pour activer ou désactiver une redirection, sur Modifier pour la changer et sur Supprimer pour l’effacer. Cliquez sur Ajouter une redirection (le bouton + de la liste) pour en créer une :

  • Ancienne adresse : l’adresse qui ne fonctionne plus, en URL complète (https://ancienne-boutique.fr/fr/ancien-produit.html) ou en chemin (/fr/ancien-produit.html). Le domaine est ignoré. Saisissez des paramètres (?id_product=12) seulement si l’ancienne adresse en avait qui comptent.
  • Correspondance : Exactement cette adresse, ou Toute adresse qui commence ainsi pour déplacer toute une ancienne catégorie ou un blog : /blog/ couvre /blog/article-1 et /blog/2019/article-2. Terminez le préfixe par / pour que /blog ne couvre pas aussi /blogueurs.
  • Nouvelle adresse : un chemin de cette boutique (/fr/nouveau-produit.html) ou une URL complète commençant par https://.
  • Type : 301 quand la page a déménagé définitivement (les moteurs de recherche transfèrent son classement), 302 pour un déplacement temporaire.
  • Activée : une redirection désactivée est conservée mais n’est pas utilisée.

Une redirection dont la nouvelle adresse ramène à l’ancienne (même en URL complète de votre boutique) est refusée, car elle redirigerait sans fin, tout comme une nouvelle adresse qu’une autre redirection renvoie ailleurs : saisissez alors l’adresse finale. Chaque ancienne adresse peut avoir, par boutique, une redirection exacte et une redirection « commence par ».

Journal 404

Le journal liste les adresses qui ont abouti à une page 404, les plus visitées en premier, avec la première et la dernière visite et le dernier référent. Rediriger ouvre le formulaire de redirection avec l’adresse déjà remplie : saisissez la nouvelle adresse et enregistrez ; l’adresse quitte le journal. Supprimer retire une adresse, Vider le journal retire toutes les adresses affichées.

Import et export

  • Exporter télécharge les redirections de la liste dans un fichier CSV qui s’ouvre dans Excel ou LibreOffice.
  • Importer lit un fichier CSV enregistré en UTF-8 (.csv ou .txt, 2 Mo et 10 000 lignes au plus), avec ;, , ou une tabulation entre les colonnes : ancienne adresse, nouvelle adresse, puis en option type (301 ou 302), correspondance (exact ou prefix) et actif (1 ou 0). Une ligne d’en-tête est acceptée. Une ligne dont l’ancienne adresse a déjà une redirection la met à jour. Après l’import, vous voyez combien de redirections ont été ajoutées, mises à jour et ignorées, avec le numéro de ligne et la raison pour les 20 premières lignes ignorées.

5. Multiboutique

Choisissez une boutique dans l’en-tête du back-office pour voir et modifier ses propres redirections (et les redirections pour toutes les boutiques) et son journal 404 ; les nouvelles redirections ne s’appliquent alors qu’à cette boutique. Avec Toutes les boutiques, les listes montrent toutes les boutiques avec une colonne Boutique et les nouvelles redirections s’appliquent à toutes les boutiques. Un employé qui ne gère pas toutes les boutiques ne voit que les redirections et les journaux de ses boutiques et ajoute des redirections avec une seule boutique choisie. Les réglages suivent la boutique ou le groupe de l’en-tête. Une licence couvre toutes les boutiques de l’installation.

6. Désinstallation

Gestionnaire de modules → Redirections 301 et journal 404 → Désinstaller supprime toutes les redirections, le journal 404 et les réglages. Exportez d’abord vos redirections si vous pouvez en avoir encore besoin, ou utilisez Désactiver.

7. Questions fréquentes et dépannage

Une redirection ne fonctionne pas. Vérifiez que la redirection et le réglage Rediriger les anciennes adresses sont activés, que l’ancienne adresse de la règle est exactement celle du navigateur (majuscules, barre oblique finale, paramètres) et qu’un cache de pages ou un proxy ne sert pas une copie enregistrée. Testez l’adresse dans une fenêtre de navigation privée : les navigateurs retiennent les redirections 301.

Puis-je rediriger une adresse qui fonctionne encore, par exemple un produit existant ? Oui. Les redirections s’appliquent avant que PrestaShop ne construise la page, donc aussi aux adresses qui existent.

Le journal 404 est rempli d’adresses comme /wp-login.php. Ce sont des robots qui cherchent d’autres logiciels de boutique. Supprimez-les ou videz le journal : ils sont sans danger. Le journal ne garde que le nombre d’entrées choisi.

L’import CSV indique que le fichier n’est pas en UTF-8. Enregistrez le fichier au format « CSV UTF-8 » dans Excel, ou en UTF-8 dans LibreOffice, puis importez-le à nouveau.

Comment déplacer tout l’ancien domaine ? Faites pointer l’ancien domaine vers la boutique et ajoutez des redirections de ses chemins : le domaine de l’ancienne adresse est ignoré, les mêmes règles valent donc pour les deux domaines.

8. Mises à jour et assistance

Les mises à jour sont gratuites à vie : téléchargez les nouvelles versions depuis Mon compte → Historique des commandes sur addonspresta.com et installez-les comme un nouveau module. Vos redirections, le journal et les réglages sont conservés.

L’assistance est incluse pendant 12 mois à compter de la commande : écrivez à mail@addonspresta.com ou utilisez le formulaire de contact d’addonspresta.com (du lundi au vendredi, 10 h – 16 h, heure de Paris ; réponse habituelle sous 2 jours ouvrés). Indiquez votre version de PrestaShop, la version du module et les étapes qui mènent au problème.

Retour : Manuels des modules

Retour en haut