URLs propres Pro module pour PrestaShop

Principales caractéristiques et avantages

• Adresses sans ID selon vos modèles — c’est vous qui décidez de l’apparence de l’adresse pour chaque type de contenu, par ex. product/nom-du-produit ou — après activation des modèles sans préfixe — même nom-du-produit.html directement à la racine de la boutique.
• Zéro perte SEO lors du changement d’adresses — des redirections permanentes 301/308 depuis les adresses natives et depuis toute forme d’adresse précédente transfèrent vers les nouvelles URL le positionnement acquis dans les moteurs de recherche, au lieu de créer des doublons et des erreurs 404.
• Déploiement sûr et réversible — rien ne change dans la boutique tant que vous n’activez pas vous-même le moteur ; auparavant, vous construisez et vérifiez tout en arrière-plan, et le retour en arrière se fait de manière tout aussi progressive que le déploiement.
• Compatibilité avec les autres modules sans les modifier — la surcharge de la classe Link fait que chaque module récupérant les adresses via l’API standard de PrestaShop (flux Google/Facebook, sitemaps, modules exécutés via cron et depuis le panneau) reçoit automatiquement les adresses canoniques.
• Gestion automatique des conflits de noms — lorsque deux éléments portent le même nom, le moteur attribue lui-même un suffixe lisible ou un chemin parent, ou — si vous le configurez ainsi — attend votre décision ; rien n’est publié à l’aveugle.
• Protection des pages existantes — le module détecte et réserve automatiquement les adresses déjà utilisées par PrestaShop lui-même ainsi que par d’autres modules (panier, contact, plan du site), de sorte qu’une adresse propre de produit ne reprenne jamais une page existante.
• Un panneau compréhensible même pour un débutant — tableau de bord avec guide pas à pas, description pour chaque option, descriptions d’état sur chaque onglet ainsi que messages de diagnostic indiquant clairement quoi cliquer et où, y compris des boutons de réparation en un clic.
• Architecture fail-closed — en cas de quelconque erreur (registre endommagé, panne du cache, conflit avec une autre modification), la boutique revient immédiatement aux adresses natives au lieu d’afficher des erreurs aux clients.

Fonctionnalités en détail

Modèles et construction des adresses

• Un modèle d’adresse distinct pour chaque type de contenu (produits, catégories, pages CMS, catégories CMS, fabricants, fournisseurs, pièces jointes) dans chaque langue et chaque boutique.
• Jetons dans les modèles : nom convivial, chemin complet de catégorie, catégorie parente, fabricant, fournisseur, référence, préfixe de langue et autres — selon le type de contenu.
• Politique globale des chemins : minuscules, caractères ASCII uniquement, barre oblique finale, limites de longueur du segment et du chemin complet, contrôle des slugs composés uniquement de chiffres — avec possibilité de surcharge par modèle.
• Modèles sans préfixe fixe (adresses directement à la racine) pour PrestaShop 8.1.2 et versions ultérieures, toujours vérifiés par un contrôle préalable.
• Politique des adresses des déclinaisons de produit : une seule adresse canonique commune à toutes les variantes (avec suppression de l’ancre de déclinaison après le signe #) ou conservation du paramètre fonctionnel de variante.

Déploiement progressif et diagnostic

• Cinq modes du moteur : désactivé, observation uniquement, mode parallèle (les anciennes adresses redirigent déjà, la boutique affiche encore les liens natifs), actif, ainsi que le mode d’urgence « actif avec repli natif ».
• Contrôle préalable (preflight) bloquant l’activation jusqu’à ce que toutes les conditions soient remplies : registre complet, validation récente, collisions résolues, tâches terminées, schéma de base correct, hooks enregistrés, absence de conflits de modèles.
• Messages de diagnostic indiquant la cause exacte et l’emplacement de la correction, avec des boutons qui mettent en file d’attente en un clic les reconstructions ou validations manquantes pour les périmètres exacts concernés par le problème.
• Tableau de couverture montrant, pour chaque langue et type de contenu, combien d’éléments disposent déjà d’une adresse propre, ainsi qu’un rapport d’intégrité du registre.
• Transitions protégées entre les modes — depuis le mode actif, il est impossible de passer accidentellement au mode désactivé en contournant la vérification.

Redirections, alias et protection SEO

• Redirections permanentes automatiques des adresses natives avec ID vers les adresses canoniques (301 ou 308 au choix), en excluant les pages de listing avec paramètres de tri et de filtres.
• Historique des adresses : chaque modification de l’adresse canonique laisse derrière elle une redirection fonctionnelle, de sorte que les favoris, publicités et résultats de recherche ne mènent jamais nulle part.
• Alias manuels et importés avec comme cible un objet de la boutique, n’importe quelle URL (avec politique de sécurité des hôtes : boutique actuelle uniquement, liste de domaines HTTPS autorisés ou tout HTTPS) ou une réponse 410/404.
• Codes de réponse pour les alias : 301, 302, 307, 308 ainsi que 404 et 410 ; les objets supprimés renvoient au choix 410 Gone (retrait plus rapide de l’index) ou 404.
• Les redirections conservent les paramètres de campagne (utm_source, utm_medium, utm_campaign, utm_term, utm_content), les identifiants de clic publicitaire (gclid, fbclid, msclkid) ainsi qu’une liste définie de paramètres fonctionnels.
• Normalisation des requêtes : les variantes d’adresse différant par la casse ou la barre oblique finale sont redirigées vers une seule forme canonique, sans doublons de contenu.
• Statistiques optionnelles d’utilisation des redirections avec échantillonnage — vous voyez si quelqu’un utilise encore les anciens liens.

Compatibilité et intégrations

• Surcharge (override) de la classe Link : tous les modules utilisant l’API standard des adresses de PrestaShop — y compris les générateurs de flux produits et de sitemaps exécutés depuis le panneau ou via cron — reçoivent les adresses canoniques sans aucune modification de leur code, avec retour automatique à l’adresse native lorsqu’une adresse propre n’est pas disponible.
• API publique pour les développeurs : récupération unitaire et en lot des adresses canoniques (avec préchargement du registre pour les générateurs de sitemaps) ainsi que des hooks permettant à d’autres modules de réserver leurs propres chemins et de réagir aux changements de routes.
• Prise en charge complète du multiboutique (configuration, modèles et registre par boutique) ainsi que de plusieurs langues ; dans les anciennes versions de PrestaShop où le cœur l’exige, le module veille à l’identité des modèles entre les langues.
• Compatibilité : PrestaShop 1.7.x–9.x, syntaxe PHP 7.0–8.5 (dans les limites des exigences du cœur utilisé), MySQL 5.6+/MariaDB 10.x, Apache et Nginx, boutiques en sous-répertoire — sans Composer ni bibliothèques externes.

Automatisation, tâches et performances

• Mise à jour automatique : l’ajout, le changement de nom ou la suppression d’un produit, d’une catégorie ou d’une page actualise lui-même l’adresse et met en file d’attente les reconstructions nécessaires, y compris les dépendances (un changement de catégorie actualise les produits, un changement de produit — les pièces jointes).
• Système de tâches en arrière-plan : analyse, aperçu (sans enregistrement), reconstruction, validation, préchauffage du cache, import, export et nettoyage — exécutés par lots configurables, avec pause, reprise, annulation et vidage de toute la file d’attente en un seul bouton.
• Cron en un seul lien : une adresse prête à copier avec jeton secret (section Cron dans le panneau, avec instructions et ligne pour crontab) traite automatiquement la file d’attente ; les appels qui se chevauchent sont bloqués ; une interface CLI est également disponible.
• Cache fichier fragmenté des routes (taille de fragment et durée de validité configurables) avec repli vers la base de données — la résolution des adresses ne surcharge pas la base à chaque affichage.
• Journal d’audit des changements d’adresses avec rétention configurable ainsi que nettoyage automatique des tâches terminées et des entrées expirées.
• Import d’alias depuis un fichier CSV avec aperçu séparé et validation avant enregistrement (jusqu’à 500 lignes par fichier, enregistrement atomique) ainsi qu’export des paramètres, routes, alias, réservations, collisions et diagnostics vers JSON/CSV — sans secrets ni données clients.

Panneau d’administration et sécurité

• Panneau clair avec tableau de bord (métriques du registre), guide repliable « Comment commencer — étape par étape » mémorisant son état, description de l’état de la configuration sur chaque onglet et descriptions pour chaque option.
• Listes des chemins, alias, collisions et tâches avec le filtrage standard de PrestaShop : langue et type d’objet sous forme de listes déroulantes, ID, chemin et slug comme champs texte, avec pagination native.
• Autorisations conformes aux profils employés de PrestaShop (affichage, modification, suppression) appliquées dans le panneau et dans chaque action AJAX.
• Sécurités : jetons et signatures des requêtes d’administration, vérification de l’origine des requêtes, comparaisons de clés résistantes aux attaques temporelles, clé opérationnelle secrète du cron par boutique, normalisation stricte des chemins rejetant les caractères de contrôle et le double encodage.
• Fiabilité : installation transactionnelle avec retour automatique en arrière et restauration de la configuration précédente en cas d’erreur, blocage de la désinstallation lorsque le routage est actif, marqueurs de panne persistants imposant un mode sûr après une erreur critique, ainsi que nettoyage complet des tables et de la configuration lors de la désinstallation.

Exigences

• PrestaShop 1.7.0–9.x avec les URL conviviales activées (Paramètres de la boutique → Trafic et SEO).
• PHP 7.0–8.5 (version prise en charge par le cœur PrestaShop utilisé), MySQL 5.6+ ou MariaDB 10.x.
• Aucune dépendance supplémentaire : le module n’utilise ni Composer ni bibliothèques externes.