Toute la documentation

PrestaShop Product SEO Subtitles — Documentation

Ajoute des sous-titres SEO dédiés après le titre principal sur les pages produit, catégorie, CMS, fabricant et fournisseur. Au lieu de modifier le nom de votre produit ou de votre catégorie, vous pouvez ajouter une deuxième ligne, par exemple un bénéfice, une expression de longue traîne, une précision de taille, un matériau, une marque ou un message de campagne.

Sous-titres SEO produit

Chaque page importante de votre boutique possède un titre principal, mais ce seul titre ne peut souvent pas contenir toutes les expressions que vos clients recherchent. SEO Subtitles vous donne un enregistrement de sous-titre séparé, qui peut être affiché directement après le H1 de la page, avec un véritable élément HTML comme h2, h3, p, span ou div.

Le module ne se limite pas à un champ produit codé en dur. Il gère les règles de sous-titres dans une section dédiée du Back Office, où chaque sous-titre peut avoir son propre texte, sa sélection de cible, sa balise HTML, sa classe CSS, sa priorité et son statut actif.

Types de pages/d’entités pris en charge dans le code du module :

product
category
cms
manufacturer
supplier

Compatibilité : PrestaShop 1.6 à 9.0 (latest), PHP 7.1+. Nous continuons à prendre en charge les prochaines versions de PrestaShop.

Configuration de PrestaShop Product SEO Subtitles dans le back-office PrestaShop

Fonctionnement

Après l’installation, le module ajoute un nouveau menu SEO Subtitles dans le Back Office. Depuis ce menu, vous pouvez créer des enregistrements de sous-titres et décider où ils doivent apparaître.

Un enregistrement de sous-titre contient :

Subtitle Text
Name
Target Entities
HTML Tag
CSS Class
Priority
Active

Le sous-titre est rendu via le hook du module :

{hook h='displayMprSubtitle'}

Pour les listes de produits ou les emplacements personnalisés dans le thème, le hook peut également recevoir un ID produit et des options d’affichage :

{hook h='displayMprSubtitle' id_product=$product.id}
{hook h='displayMprSubtitle' id_product=$product.id tag='h3'}
{hook h='displayMprSubtitle' tag='h3' css_class='category-subtitle'}

La sortie côté boutique est un véritable élément HTML avec les classes CSS du module :

<h2 class="mpr-subtitle mpr-subtitle-product mpr-seo-subtitle">
  Walk-in shower tray with anti-slip stone resin surface
</h2>

Si aucun sous-titre actif correspondant n’existe, rien n’est affiché et la page conserve sa mise en page normale.

Installation

  1. Dans votre Back Office, allez dans Modules → Module Manager
  2. Cliquez sur Upload a module et sélectionnez le fichier ZIP
  3. Installez le module
  4. Ouvrez SEO Subtitles dans le menu du Back Office
  5. Utilisez Templates pour analyser votre thème et ajouter le hook de sous-titre là où c’est nécessaire
  6. Créez votre premier sous-titre dans Subtitles

Configuration

Paramètres par défaut

Le module stocke ses principaux paramètres dans sa table de configuration avec ces clés :

default_tag = h2
default_class = mpr-seo-subtitle
display_mode = single

L’écran de configuration contient :

Default HTML Tag
Default CSS Class
Display Mode

Balise HTML

Vous pouvez choisir la balise utilisée pour un sous-titre. Les valeurs autorisées sont :

h2
h3
h4
h5
h6
p
span
div

Pour la plupart des pages produit et catégorie, h2 est le meilleur point de départ, car le titre principal de la page est généralement déjà le h1.

Exemple de sous-titre utilisant la balise de titre par défaut :

Ultra-slim shower tray, stone resin finish, easy-clean surface

Exemple où un titre plus petit convient mieux :

HTML Tag: h3
Subtitle Text: Compatible with low-profile walk-in shower installation

Mode d’affichage

Le module peut afficher soit un seul sous-titre, soit plusieurs sous-titres correspondants.

single = show only the highest-priority matching subtitle
all = show all matching subtitles, sorted by priority

La priorité est triée de la plus élevée à la plus faible :

Priority 100 → shown before priority 10
Priority 10  → default priority

Classe CSS

Chaque sous-titre reçoit toujours les classes de base du module :

mpr-subtitle
mpr-subtitle-product
mpr-subtitle-category
mpr-subtitle-cms
mpr-subtitle-manufacturer
mpr-subtitle-supplier

Votre classe personnalisée est ajoutée après ces classes. Exemple :

CSS Class: homepage-product-subtitle

Résultat sur une page produit :

<h2 class="mpr-subtitle mpr-subtitle-product homepage-product-subtitle">
  Made-to-measure shower screen in clear safety glass
</h2>

Template Manager

Le module inclut un Template Manager qui analyse les templates de votre thème actif, détecte les emplacements de titres et peut insérer le hook de sous-titre après le titre sélectionné.

Les hooks injectés sont entourés de marqueurs afin de pouvoir être suivis et supprimés plus tard :

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

Le gestionnaire vérifie les fichiers de templates du thème dans le répertoire themes de la boutique et fonctionne uniquement avec les fichiers .tpl. S’il trouve dans le même fichier un hook displayMprSubtitle existant non marqué, il le signale au lieu d’ajouter un doublon.

Smart Tags

Le texte des sous-titres prend en charge les placeholders. Ils sont utiles lorsqu’une règle de sous-titre doit s’adapter automatiquement à chaque produit.

Placeholders produit courants :

{name}
{reference}
{ean13}
{price}
{manufacturer}
{category}
{feature:Feature name}
{attribute:Attribute group name}

Exemples :

{name} from {manufacturer} — available from {price}

{category} product with reference {reference}

{feature:Material} shower tray with {attribute:Color} finish

Pour les pages catégorie, CMS, fabricant et fournisseur, {name} correspond au nom de l’entité actuelle :

{name} — selected products and practical buying information

Ciblage des sous-titres

Lorsque vous créez un sous-titre, utilisez Target Entities pour décider où il apparaît. Le module prend en charge le ciblage d’entités spécifiques ainsi que des règles de sélection plus larges.

Un sous-titre produit unique peut être utilisé pour un seul produit :

Target: specific product
Subtitle Text: Low-profile shower tray with stone resin surface
HTML Tag: h2
Priority: 10
Active: Yes

Une règle produit plus large peut s’appliquer aux produits par catégorie, fabricant ou fournisseur lorsque les données du sélecteur utilisent ces conditions. Le résolveur prend également en charge les exclusions, ce qui permet à une règle de s’appliquer largement tout en ignorant certains produits sélectionnés.

Méthodes de ciblage produit prises en charge dans le résolveur :

all
specific
by_category
by_manufacturer
by_supplier

Exclusions prises en charge :

specific
by_category

Exemples pratiques

Sous-titre produit

Product name:
Shower Tray 90x90

Subtitle:
Ultra-slim stone resin tray with easy-clean anti-slip surface

Sous-titre de catégorie

Category name:
Walk-in Shower Screens

Subtitle:
Frameless glass panels for modern wetroom and walk-in shower layouts

Sous-titre de page CMS

CMS page:
Delivery Information

Subtitle:
Shipping times, carrier options and delivery notes for bathroom products

Sous-titre produit dynamique

{name} by {manufacturer} — {feature:Material}, available from {price}

Conseils

  • Utilisez le sous-titre pour ajouter des informations qui ne s’intègrent pas naturellement dans le titre de la page : matériau, taille, type d’installation, finition, compatibilité ou expression de recherche longue traîne.
  • Évitez de répéter mot pour mot le nom du produit ou de la catégorie. Le sous-titre doit ajouter un contexte utile.
  • Gardez les sous-titres produit assez concis pour rester lisibles sur les écrans mobiles.
  • Utilisez les placeholders pour les modèles répétables sur de nombreux produits.
  • Utilisez la priorité lorsque plusieurs règles de sous-titres peuvent correspondre à la même page.
  • Commencez par vos pages produit et catégorie les plus importantes, puis étendez progressivement vers des règles plus larges.

Questions fréquentes

Le sous-titre va-t-il modifier le nom de mon produit ?
Non. Le sous-titre est affiché séparément. Il ne renomme pas le produit, la catégorie, la page CMS, le fabricant ni le fournisseur.

Le sous-titre modifie-t-il mon meta title ?
Non. Le module affiche le contenu du sous-titre sur la page. Il ne réécrit pas le meta title de la page.

Puis-je laisser les sous-titres vides pour certaines pages ?
Oui. Si aucun sous-titre actif ne correspond à une page, le module ne renvoie aucune sortie.

Puis-je utiliser des sous-titres différents selon les langues ?
Oui. Le texte du sous-titre est multilingue, vous pouvez donc saisir un texte différent pour chaque langue de votre boutique.

Puis-je afficher plusieurs sous-titres sur la même page ?
Oui. Réglez le mode d’affichage sur all. Avec le mode par défaut single, seul le sous-titre correspondant ayant la priorité la plus élevée est affiché.

Cela fonctionnera-t-il avec mon thème actuel ?
Le module utilise un hook Smarty et inclut un Template Manager pour placer ce hook après le titre de la page. Les thèmes PrestaShop standards devraient fonctionner normalement. Les thèmes personnalisés peuvent nécessiter le Template Manager ou un placement manuel du hook.

Quel hook le module utilise-t-il ?
Le hook principal est :

{hook h='displayMprSubtitle'}

Il existe également un alias de compatibilité pour les thèmes utilisant :

{hook h='displayProductSubtitle'}
Retour en haut