Gestionnaire de sous-titres : installation et aide

Importez le ZIP dans Modules > "Module Manager" > "Upload a module". Installez-le et cliquez sur "Configure". Ouvrez "Improve" > Sous-titres SEO. Utilisez Sous-titres pour les règles de contenu, Modèles pour le placement et Paramètres > Configuration pour les valeurs par défaut.

Nécessite PrestaShop 1.6.1 ou ultérieur et PHP 7.1 ou ultérieur.

Le placement en boutique utilise les templates Smarty et displayMprSubtitle. L'injection automatique nécessite que le processus PHP puisse écrire dans le fichier .tpl du thème sélectionné.

Ouvrez Paramètres > Configuration.

Enregistrez les modifications. Les classes de base mpr-subtitle et mpr-subtitle-{type} sont ajoutées indépendamment de votre classe personnalisée.

Ouvrez Sous-titres et ajoutez une règle.

Le sélecteur prend en charge des groupes tels que produits spécifiques, tous les produits, produits de catégories, de fabricants ou de fournisseurs. Les conditions d'exclusion produit peuvent retirer des produits individuels ou des correspondances de catégorie.

Les sous-titres prennent aussi en charge les pages de détail des fabricants et fournisseurs. L'éditeur principal de règles est configuré autour de la sélection produit, catégorie et CMS. Vérifiez les commandes du sélecteur disponibles avant de prévoir des règles fabricant ou fournisseur.

Pour les produits, vous pouvez utiliser {name}, {category}, {manufacturer}, {price} et {reference}. Les variables de caractéristiques et d'attributs utilisent le nom de la caractéristique ou du groupe dans la langue actuelle :

{name} by {manufacturer} - {feature:Material}, available from {price}
{name} - {attribute:Color}

Les valeurs d'attributs proviennent de la déclinaison par défaut du produit. Elles ne suivent pas automatiquement chaque changement de déclinaison côté client. Des données manquantes peuvent produire des valeurs vides ; vérifiez donc la phrase complète.

Pour les entités prises en charge autres que les produits, {name} utilise le nom de l'entité actuelle ou le titre CMS. Par exemple :

{name} - buying information

Ouvrez Modèles et analysez le thème actif. Vérifiez la page détectée, Fichier et Ligne avant l'injection. Gardez une copie des fichiers du thème modifiés.

La commande Balise de la carte d'analyse définit une surcharge de rendu facultative. Sa valeur par défaut est la balise du sous-titre/par défaut. Inline vaut Désactivé par défaut et contrôle si l'insertion se trouve sur la même ligne de template que le titre. Le profil de page est actif par défaut ; désactiver Activé empêche l'affichage du sous-titre pour ce profil détecté.

Le mécanisme de placement stocke une balise de titre, une balise de rendu, des paramètres de hook et une préférence inline. Leurs valeurs habituelles sont h1 pour rechercher le titre, une surcharge de rendu vide, des paramètres de hook vides et inline désactivé. Ces noms enregistrés ne sont pas tous des libellés de réglage visibles distincts sur la carte d'analyse.

L'injection écrit un marqueur amovible :

{* MPR_SUBTITLE_INJECT *}{hook h='displayMprSubtitle'}{* /MPR_SUBTITLE_INJECT *}

Vous pouvez placer vous-même le hook après le titre concerné :

{hook h='displayMprSubtitle'}

Pour une carte produit, transmettez l'ID produit et éventuellement une balise :

{hook h='displayMprSubtitle' id_product=$product.id tag='h3'}

Vous pouvez aussi fournir une classe personnalisée :

{hook h='displayMprSubtitle' tag='h3' css_class='category-subtitle'}

La balise de rendu d'un profil actif a priorité sur le paramètre tag du hook. Le paramètre de classe du hook peut remplacer la classe personnalisée préparée. Des templates très personnalisés ou des titres générés par JavaScript peuvent nécessiter un placement manuel.

Enregistrez un sous-titre actif pour un produit, puis ouvrez celui-ci en boutique. Confirmez que le texte apparaît à l'emplacement du hook. Recommencez dans une autre langue. Ouvrez une page non ciblée et confirmez que la règle ne s'y applique pas.

Si plusieurs règles correspondent, "Single subtitle" renvoie le résultat de priorité la plus élevée. "Multiple subtitles" renvoie les résultats correspondants par priorité décroissante. Sans sous-titre actif correspondant, aucune sortie n'est produite.

Un résultat ordinaire peut ressembler à ceci :

<h2 class="mpr-subtitle mpr-subtitle-product mpr-seo-subtitle">Product information</h2>

Vous pouvez styliser les classes dans la feuille de style personnalisée du thème :

.mpr-subtitle {
  margin-top: 0;
  margin-bottom: .5rem;
  font-weight: 400;
  color: #666;
  line-height: 1.4;
}
.mpr-subtitle-product.category-subtitle {
  font-size: 1rem;
  color: #444;
}

Le module affiche un texte visible distinct. Il ne renomme pas l'entité et ne modifie ni son meta title, ni sa meta description, ni son URL.

Vérifiez Actif, ciblage, texte par langue, priorité et "Display Mode". Confirmez que le bon fichier du thème contient displayMprSubtitle et que le profil de page détecté est activé. Videz le cache du thème compilé ou des pages après les changements de placement. La création, modification, suppression, les changements de statut et opérations groupées sur les règles vident le cache des templates de hook du module.

Si les variables sont vides, vérifiez le champ source et le nom traduit de la caractéristique ou du groupe d'attributs. Si une liste affiche le texte du mauvais produit, transmettez son véritable id_product au hook.

Après une mise à jour du thème, vérifiez l'état d'injection suivi et relancez l'analyse. Le gestionnaire de templates peut parcourir, inspecter, modifier, injecter et retirer les templates du thème pris en charge. L'écriture exige l'accès à ces fichiers.

Si la reprise des sous-titres par SEO Revolution est activée, ce module autonome ne renvoie volontairement aucun sous-titre. Vérifiez la configuration de reprise avant de rechercher des moteurs de rendu manquants ou dupliqués.

Désactivez le module ou certaines règles pour arrêter temporairement l'affichage.

La désinstallation conserve les sous-titres et les profils. Sans SEO Revolution, la désinstallation autonome retire les injections de hooks suivies. Si SEO Revolution est installé, la désinstallation nécessite sa reprise des sous-titres activée, enregistrée et fonctionnelle ; sinon le module bloque la suppression avec un message explicatif. Si la reprise est prête, il conserve les injections pour le moteur de remplacement.

La désinstallation supprime le menu autonome, les paramètres et les préférences d'administration. Vérifiez ensuite les fichiers de templates, surtout les appels de hook insérés manuellement.