Gestionnaire Smart d'URL simplifiées SEO : installation et aide

Téléversez et installez le ZIP mprfriendlyurl depuis l'écran de téléversement des modules du back-office. Cliquez sur "Configure" pour ouvrir "Friendly URLs" > "Settings" > Configuration.

L'installation remplace les règles de routage des produits, catégories, pages CMS, catégories CMS, fabricants et fournisseurs par {rewrite}, sauf si SEO Revolution est actif. Notez votre structure d'URL actuelle et sauvegardez la base de données avant l'installation. Testez d'abord les URL importantes sur une copie de votre boutique.

Dans Paramètres généraux, laissez Module activé activé. Déléguer à SEO Revolution est activé par défaut. Si SEO Revolution est actif, ce module ne traite pas les URL. Choisissez le module responsable des URL avant de modifier les modèles.

Ouvrez "Friendly URLs" > "Settings" > Configuration et choisissez Produits, Catégories, Pages CMS, Fabricants ou Fournisseurs. Enregistrez chaque modification dans le contexte de boutique à configurer. Dans un contexte enfant, Utiliser les paramètres hérités permet de rétablir la configuration héritée.

Conservez {rewrite} pour le premier test. Ne modifiez un modèle que si le nouveau chemin répond à un besoin précis. Les champs suivants sont visibles dans les onglets d'entité :

• Activé. Active la gestion personnalisée des URL pour les produits, catégories, pages CMS, fabricants ou fournisseurs ; valeur par défaut : 1. Réglez ce champ dans l'onglet d'entité correspondant.
• Modèle d'URL. Définit le modèle de chemin utilisé pour le type d'entité ; valeur par défaut : {rewrite}. Réglez-le dans chaque onglet d'entité.
• Suffixe URL. Permet de laisser les URL générées sans suffixe ou d’ajouter .html ou une barre oblique finale ; valeur par défaut : "".
• Include parent categories. Ajoute le chemin de catégorie du produit au début lorsque les URL des produits sont créées avec un contexte de catégorie ; valeur par défaut : 0. Onglet produit uniquement.
• Variant URLs. Définit le style d'URL des déclinaisons : none, path ou anchor ; valeur par défaut : none. Onglet produit uniquement.
• Gestion des collisions. Définit comment rendre uniques les URL générées en double : id, increment, sku ou ean13 selon les possibilités ; valeur par défaut : id.
• Rediriger lors d’un changement d’URL. Crée une redirection lorsque l'URL d'une entité change ; valeur par défaut : 301.
• Redirection à la suppression. Définit le comportement lors de la visite d'une ancienne URL d'entité supprimée ; valeur par défaut : parent.
• Redirection à la désactivation. Définit le comportement lors de la visite d'une ancienne URL d'entité désactivée ; valeur par défaut : parent.
• Forcer les minuscules. Convertit les URL générées en minuscules ; valeur par défaut : 1.
• Supprimer les accents. Remplace les caractères accentués dans les URL générées ; valeur par défaut : 1.
• Supprimer les caractères spéciaux. Supprime les caractères non pris en charge dans les URL générées ; valeur par défaut : 1.

L'onglet produit propose aussi Include parent categories et Variant URLs. Les suffixes de collision SKU et EAN13 sont des options propres aux produits. Les autres onglets d'entité proposent des suffixes par ID ou incrément. Pour les changements d'URL, choisissez 301, 302 ou aucune redirection. Pour les éléments supprimés ou désactivés, choisissez la catégorie parente, l'accueil, 410 ou aucune redirection. Testez les redirections liées au cycle de vie pour chaque type d'entité utilisé.

Valeurs de modèle enregistrées

Les éléments suivants sont des clés de configuration utilisées à l'exécution, pas des champs supplémentaires du back-office. Ne cherchez pas de commandes distinctes portant ces noms :

• "Category separator". Sépare les segments des chemins de catégorie générés ; valeur par défaut : /. Enregistré dans la configuration des modèles.
• "Max category depth". Limite la profondeur des chemins de catégorie lors de leur création ; valeur par défaut : 0.
• "Replace spaces". Remplace les espaces dans les URL générées ; valeur par défaut : -.
• "Product redirect target". Définit la destination de secours des produits utilisée par les redirections liées au cycle de vie ; valeur par défaut : default_category.
• "Include CMS category". Autorise les chemins complets des catégories CMS dans les données d'URL CMS lorsque cette option est activée ; valeur par défaut : 0.
• "Disable attribute URLs". Force les URL des déclinaisons à utiliser l'URL de base du produit ; valeur par défaut : 0.

Utilisez le formulaire visible pour la configuration courante. Conservez le séparateur de catégorie /, la profondeur illimitée 0, le remplacement des espaces -, la destination de secours des produits default_category, l'inclusion des catégories CMS 0 et les URL de base forcées pour les attributs 0, sauf si votre intégration modifie délibérément les données de modèle enregistrées.

• Module activé. Active ou désactive la gestion des URL par ce module ; valeur par défaut : 1. Réglez-le dans l'onglet Paramètres généraux.
• Déléguer à SEO Revolution. Laisse MPR SEO Revolution gérer les URL lorsque ce module est installé et actif ; valeur par défaut : 1.
• Type de redirection par défaut. Définit le code de redirection de secours des redirections sans réglage propre à l'entité ; valeur par défaut : 301.
• Action URL introuvable. Définit le comportement des URL simplifiées non résolues : afficher une erreur 404, rediriger vers l'accueil ou vers la recherche ; valeur par défaut : 404.
• Journaliser les redirections. Conserve l'historique des redirections et les compteurs de visites dans la base de données ; valeur par défaut : 1.
• Cache d'URL. Enregistre les URL résolues dans la base de données pour accélérer leur recherche ; valeur par défaut : 1. Réglez-le dans l'onglet Performances.
• Durée du cache. Définit la durée de vie du cache d'URL en secondes ; valeur par défaut : 86400.

Utilisez Action URL introuvable = Afficher la page 404 (par défaut) pour tester les chemins inconnus. Laissez le cache d'URL activé en fonctionnement normal. Ne modifiez Durée du cache que si vos besoins de rafraîchissement diffèrent de 86400 secondes.

Saisissez un modèle dans le champ Modèle d'URL approprié. Exemples :

Products: {category}/{rewrite}
Products: {brand}/{rewrite}
Products: {reference}/{rewrite}
Categories: {parents}/{rewrite}
CMS Pages: {category}/{rewrite}
Manufacturers: brands/{rewrite}
Suppliers: suppliers/{rewrite}

Le traitement des produits prend en charge ces variables :

{id} {rewrite} {name} {reference} {ean13} {upc} {isbn} {mpn}
{category} {category_id} {categories} {brand} {manufacturer} {brand_id}
{supplier} {supplier_id} {attributes} {attribute:color} {attribute:size}
{id_product_attribute} {price} {meta_title} {meta_keywords} {tags}

Les noms d'attributs doivent exister dans votre catalogue. Un produit utilisant {category}/{rewrite} et Variant URLs en mode chemin peut avoir des chemins comme /shower-trays/quadrant-tray/size-m/color-black. L'ordre réel et les valeurs dépendent des données de ses déclinaisons.

Pour ajouter une redirection manuelle, ouvrez "Friendly URLs" > Redirections. Sélectionnez les entités sources ou saisissez des URL sources personnalisées. Choisissez une entité de destination ou une destination personnalisée. Définissez Type de redirection, Langue et Verrouillé, puis enregistrez. Par exemple, redirigez old-sale vers sale avec le type 301. Les types de redirection manuelle comprennent 301, 302 et 307. Verrouillez une redirection si la régénération des modèles ne doit pas la remplacer.

Ouvrez "Friendly URLs" > "Duplicates". Vérifiez les collisions de link_rewrite des produits, catégories et pages CMS pour la langue et la boutique voulues avant toute modification en masse.

Ouvrez "Regenerate". Sélectionnez les lignes, cliquez sur Aperçu et vérifiez les slugs proposés. Modifiez directement les valeurs proposées si nécessaire. Ne cliquez sur Approve & Save qu'après vérification de l'aperçu. Les lignes approuvées et enregistrées manuellement sont verrouillées. Déverrouillez une ligne avant de l'inclure dans une régénération ultérieure. Les lignes verrouillées sont ignorées.

Consultez "Redirect History" après un changement d'URL. Les enregistrements comprennent les anciennes et nouvelles URL, le type, le motif, le nombre de visites, la dernière visite, la langue et la boutique. L'historique ne peut rediriger que les URL enregistrées par le module.

1. Ouvrez "Friendly URLs" > "Settings" > "Integrity". Examinez les contrôles de routage, hooks, doublons, cache, redirections et multiboutique.
2. Confirmez que la réécriture des URL simplifiées est activée dans votre boutique. Sous Apache, vérifiez le fichier .htaccess généré et la prise en charge de la réécriture. Ne remplacez pas le fichier complet par un exemple partiel.
3. Ouvrez les liens des produits, catégories, pages CMS, marques et fournisseurs depuis la boutique. Répétez l'opération dans chaque langue et boutique actives.
4. Testez une déclinaison avec le mode Variant URLs choisi.
5. Modifiez l'URL d'une entité de test. Demandez son ancienne URL et vérifiez le statut de réponse, la destination et l'entrée dans l'historique.
6. Demandez un chemin inconnu et vérifiez Action URL introuvable.

Si les liens simplifiés échouent, vérifiez Module activé, le transfert à SEO Revolution, la réécriture, les slugs en double et les résultats de "Integrity". Si une ligne est ignorée lors de la régénération, vérifiez son verrouillage. Les fabricants et fournisseurs tirent leurs données d'URL de leurs noms plutôt que de champs natifs link_rewrite comme les produits.

Conservez une structure d'URL stable après la migration. Examinez les redirections avant de modifier à nouveau les suffixes ou les chemins de catégorie. Actualisez votre sitemap après avoir vérifié les URL définitives.

Désinstallez depuis l'écran des modules du back-office. Le module supprime son menu et sa configuration. Il restaure les règles de routage enregistrées, ou ses règles natives de secours, lorsque SEO Revolution n'est pas actif. Il conserve les tables d'URL partagées. Désactiver Module activé ne déclenche pas la restauration des routes effectuée lors de la désinstallation.

Sauvegardez d'abord les redirections et les données d'URL. Après la désinstallation, vérifiez les liens natifs de la boutique, les anciennes URL entrantes et le sitemap. Si SEO Revolution est actif, vérifiez sa configuration de routage car ce module ne restaure pas les routes dans ce cas.

Nécessite PrestaShop 1.6.1.0 ou une version ultérieure et PHP 7.1 ou une version ultérieure.