PrestaShop Product SEO Subtitles — Documentazione
Aggiunge sottotitoli SEO dedicati dopo il titolo principale nelle pagine prodotto, categoria, CMS, produttore e fornitore. Invece di modificare il nome del prodotto o della categoria, può aggiungere una seconda riga, ad esempio un vantaggio, una frase long-tail, un dettaglio sulla misura, il materiale, il brand o un messaggio di campagna.
Sottotitoli SEO prodotto
Ogni pagina importante del suo negozio ha un titolo principale, ma spesso quel singolo titolo non può includere tutte le frasi cercate dai clienti. SEO Subtitles offre un record di sottotitolo separato, che può essere mostrato direttamente dopo l’H1 della pagina usando un vero elemento HTML come h2, h3, p, span o div.
Il modulo non è limitato a un unico campo prodotto codificato in modo fisso. Gestisce le regole dei sottotitoli in una sezione dedicata del Back Office, dove ogni sottotitolo può avere il proprio testo, la selezione della destinazione, il tag HTML, la classe CSS, la priorità e lo stato attivo.
Tipi di pagina/entità supportati nel codice del modulo:
product
category
cms
manufacturer
supplier
Compatibilità: da PrestaShop 1.6 a 9.0 (latest), PHP 7.1+. Continuiamo a supportare le prossime versioni di PrestaShop.
Come funziona
Dopo l’installazione, il modulo aggiunge un nuovo menu SEO Subtitles nel Back Office. Da lì può creare record di sottotitoli e decidere dove devono apparire.
Un record di sottotitolo contiene:
Subtitle Text
Name
Target Entities
HTML Tag
CSS Class
Priority
Active
Il sottotitolo viene renderizzato tramite l’hook del modulo:
{hook h='displayMprSubtitle'}
Per gli elenchi prodotto o per posizionamenti personalizzati nel tema, l’hook può anche ricevere un ID prodotto e opzioni di visualizzazione:
{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'}
L’output nello storefront è un vero elemento HTML con le classi CSS del modulo:
<h2 class="mpr-subtitle mpr-subtitle-product mpr-seo-subtitle">
Walk-in shower tray with anti-slip stone resin surface
</h2>
Se non esiste alcun sottotitolo attivo corrispondente, non viene mostrato nulla e la pagina mantiene il suo layout normale.
Installazione
- Nel Back Office, vada su Modules → Module Manager
- Faccia clic su Upload a module e selezioni il file ZIP
- Installi il modulo
- Apra SEO Subtitles nel menu del Back Office
- Usi Templates per analizzare il tema e aggiungere l’hook del sottotitolo dove necessario
- Crei il primo sottotitolo in Subtitles
Configurazione
Impostazioni predefinite
Il modulo salva le impostazioni principali nella propria tabella di configurazione usando queste chiavi:
default_tag = h2
default_class = mpr-seo-subtitle
display_mode = single
La schermata di configurazione include:
Default HTML Tag
Default CSS Class
Display Mode
Tag HTML
Può scegliere il tag usato per un sottotitolo. I valori consentiti sono:
h2
h3
h4
h5
h6
p
span
div
Per la maggior parte delle pagine prodotto e categoria, h2 è il miglior punto di partenza, perché il titolo principale della pagina è di solito già l’h1.
Esempio di sottotitolo con il tag di intestazione predefinito:
Ultra-slim shower tray, stone resin finish, easy-clean surface
Esempio in cui è più adatta un’intestazione più piccola:
HTML Tag: h3
Subtitle Text: Compatible with low-profile walk-in shower installation
Modalità di visualizzazione
Il modulo può mostrare un solo sottotitolo oppure più sottotitoli corrispondenti.
single = show only the highest-priority matching subtitle
all = show all matching subtitles, sorted by priority
La priorità viene ordinata dalla più alta alla più bassa:
Priority 100 → shown before priority 10
Priority 10 → default priority
Classe CSS
Ogni sottotitolo riceve sempre le classi base del modulo:
mpr-subtitle
mpr-subtitle-product
mpr-subtitle-category
mpr-subtitle-cms
mpr-subtitle-manufacturer
mpr-subtitle-supplier
La sua classe personalizzata viene aggiunta dopo queste classi. Esempio:
CSS Class: homepage-product-subtitle
Risultato su una pagina prodotto:
<h2 class="mpr-subtitle mpr-subtitle-product homepage-product-subtitle">
Made-to-measure shower screen in clear safety glass
</h2>
Template Manager
Il modulo include un Template Manager che analizza i template del tema attivo, individua le posizioni dei titoli e può inserire l’hook del sottotitolo dopo il titolo selezionato.
Gli hook inseriti sono racchiusi da marcatori, così possono essere tracciati e rimossi in seguito:
{* MPR_SUBTITLE_INJECT *}{hook h='displayMprSubtitle'}{* /MPR_SUBTITLE_INJECT *}
Il manager controlla i file template del tema nella directory themes del negozio e funziona solo con file .tpl. Se trova nello stesso file un hook displayMprSubtitle esistente e non marcato, lo segnala invece di aggiungere un duplicato.
Smart Tags
Il testo del sottotitolo supporta i placeholder. Sono utili quando una regola di sottotitolo deve adattarsi automaticamente a ogni prodotto.
Placeholder prodotto comuni:
{name}
{reference}
{ean13}
{price}
{manufacturer}
{category}
{feature:Feature name}
{attribute:Attribute group name}
Esempi:
{name} from {manufacturer} — available from {price}
{category} product with reference {reference}
{feature:Material} shower tray with {attribute:Color} finish
Per le pagine categoria, CMS, produttore e fornitore, {name} viene risolto nel nome dell’entità corrente:
{name} — selected products and practical buying information
Targeting dei sottotitoli
Quando crea un sottotitolo, usi Target Entities per decidere dove appare. Il modulo supporta il targeting di entità specifiche e regole di selezione più ampie.
Un singolo sottotitolo prodotto può essere usato per un solo prodotto:
Target: specific product
Subtitle Text: Low-profile shower tray with stone resin surface
HTML Tag: h2
Priority: 10
Active: Yes
Una regola prodotto più ampia può applicarsi ai prodotti per categoria, produttore o fornitore quando i dati del selettore usano tali condizioni. Il resolver supporta anche le esclusioni, quindi una regola può applicarsi in modo ampio saltando prodotti selezionati.
Metodi di targeting prodotto supportati nel resolver:
all
specific
by_category
by_manufacturer
by_supplier
Esclusioni supportate:
specific
by_category
Esempi pratici
Sottotitolo prodotto
Product name:
Shower Tray 90x90
Subtitle:
Ultra-slim stone resin tray with easy-clean anti-slip surface
Sottotitolo categoria
Category name:
Walk-in Shower Screens
Subtitle:
Frameless glass panels for modern wetroom and walk-in shower layouts
Sottotitolo pagina CMS
CMS page:
Delivery Information
Subtitle:
Shipping times, carrier options and delivery notes for bathroom products
Sottotitolo prodotto dinamico
{name} by {manufacturer} — {feature:Material}, available from {price}
Suggerimenti
- Usi il sottotitolo per aggiungere informazioni che non entrano in modo naturale nel titolo della pagina: materiale, misura, tipo di installazione, finitura, compatibilità o una frase di ricerca long-tail.
- Eviti di ripetere parola per parola il nome del prodotto o della categoria. Il sottotitolo deve aggiungere contesto utile.
- Mantenga i sottotitoli prodotto abbastanza concisi da risultare leggibili sugli schermi mobili.
- Usi i placeholder per schemi ripetibili su molti prodotti.
- Usi la priorità quando più regole di sottotitolo possono corrispondere alla stessa pagina.
- Inizi dalle pagine prodotto e categoria più importanti, poi estenda la configurazione a regole più ampie.
Domande frequenti
Il sottotitolo cambierà il nome del mio prodotto?
No. Il sottotitolo viene visualizzato separatamente. Non rinomina il prodotto, la categoria, la pagina CMS, il produttore o il fornitore.
Il sottotitolo modifica il mio meta title?
No. Il modulo renderizza il contenuto del sottotitolo nella pagina. Non riscrive il meta title della pagina.
Posso lasciare vuoti i sottotitoli per alcune pagine?
Sì. Se nessun sottotitolo attivo corrisponde a una pagina, il modulo non restituisce alcun output.
Posso usare sottotitoli diversi in lingue diverse?
Sì. Il testo del sottotitolo è multilingua, quindi può inserire un testo diverso per ogni lingua del negozio.
Posso visualizzare più di un sottotitolo sulla stessa pagina?
Sì. Imposti la modalità di visualizzazione su all. Con la modalità predefinita single, viene mostrato solo il sottotitolo corrispondente con la priorità più alta.
Funzionerà con il mio tema attuale?
Il modulo usa un hook Smarty e include un Template Manager per posizionare quell’hook dopo il titolo della pagina. I temi standard PrestaShop dovrebbero funzionare normalmente. I temi personalizzati potrebbero richiedere il Template Manager o un posizionamento manuale dell’hook.
Quale hook usa il modulo?
L’hook principale è:
{hook h='displayMprSubtitle'}
È disponibile anche un alias di compatibilità per i temi che usano:
{hook h='displayProductSubtitle'}