Gestore dei sottotitoli: configurazione e aiuto

Avvio rapido

  1. Installa lo ZIP in Moduli > "Module Manager" e apri "Improve" > Sottotitoli SEO.
  2. Controlla "Default HTML Tag", "Default CSS Class" e "Display Mode" in Impostazioni > Configurazione.
  3. Aggiungi un sottotitolo in Sottotitoli, compila Testo sottotitolo per le tue lingue e scegli esplicitamente Entità di destinazione.
  4. Imposta Tag HTML, Priorità e Attivo, poi salva.
  5. Apri Template, scansiona il tema attivo, controlla File e Riga e inietta l'hook, oppure posiziona displayMprSubtitle manualmente.
  6. Apri una pagina selezionata e verifica che il sottotitolo appaia nella posizione scelta in ogni lingua.

Richiede PrestaShop 1.6.1 o successivo e PHP 7.1 o successivo.

Il posizionamento richiede il rendering degli hook Smarty; l'iniezione nei template richiede accesso in scrittura al file del tema scelto.

Manuale di configurazione

Installa e apri il modulo

Carica lo ZIP in Moduli > "Module Manager" > "Upload a module". Installalo e fai clic su "Configure". Apri "Improve" > Sottotitoli SEO. Usa Sottotitoli per le regole di contenuto, Template per il posizionamento e Impostazioni > Configurazione per i valori predefiniti.

Richiede PrestaShop 1.6.1 o successivo e PHP 7.1 o successivo.

Il posizionamento nel negozio usa template Smarty e displayMprSubtitle. L'iniezione automatica richiede che il processo PHP possa scrivere nel file .tpl del tema selezionato.

Imposta i valori di visualizzazione predefiniti

Apri Impostazioni > Configurazione.

Impostazione Predefinito Cosa configurare
"Default HTML Tag" h2 Valore sostitutivo quando un sottotitolo non ha un proprio tag. Scegli un tag adatto alla struttura dei titoli.
"Default CSS Class" mpr-seo-subtitle Classe personalizzata sostitutiva quando un sottotitolo non ha una propria classe.
"Display Mode" "Single subtitle", salvato come single Mostra solo la corrispondenza con priorità più alta. Scegli "Multiple subtitles", salvato come all, per mostrare tutte le corrispondenze.

Salva le modifiche. Le classi base mpr-subtitle e mpr-subtitle-{type} vengono aggiunte indipendentemente dalla classe personalizzata.

Crea il primo sottotitolo

Apri Sottotitoli e aggiungi una regola.

Campo Predefinito per nuove regole Come usarlo
Testo sottotitolo Vuoto Inserisci il testo visibile in ogni lingua richiesta. Il campo consente fino a 512 caratteri per lingua.
Nome Vuoto Etichetta interna facoltativa della regola.
Entità di destinazione La selezione non modificata parte vuota Scegli esplicitamente l'ambito prodotto, categoria o CMS. Un ambito con tutte le entità di un tipo può applicarsi ampiamente.
Tag HTML h2 Scegli h2, h3, h4, h5, h6, p, span o div per questo sottotitolo.
Classe CSS Vuoto Classe facoltativa al posto di quella personalizzata predefinita.
Priorità 10 I valori più alti compaiono per primi.
Attivo Sì Disattiva una regola senza eliminarne il contenuto.

Il selettore supporta gruppi come prodotti specifici, tutti i prodotti, prodotti in categorie, di produttori e di fornitori. Le condizioni di esclusione possono rimuovere singoli prodotti o corrispondenze di categoria.

I sottotitoli supportano anche le pagine di dettaglio di produttori e fornitori. L'editor principale delle regole è configurato per la selezione di prodotti, categorie e CMS. Controlla i comandi disponibili nel selettore prima di pianificare regole per produttori o fornitori.

Usa i segnaposto

Per i prodotti puoi usare {name}, {category}, {manufacturer}, {price} e {reference}. I segnaposto di caratteristiche e attributi usano il nome della caratteristica o del gruppo nella lingua corrente:

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

I valori degli attributi provengono dalla combinazione predefinita del prodotto. Non seguono automaticamente ogni cambio di combinazione lato client. Dati mancanti possono produrre valori vuoti, quindi controlla la frase completa.

Per le entità supportate diverse dai prodotti, {name} usa il nome dell'entità corrente o il titolo CMS. Per esempio:

{name} - buying information

Posiziona l'hook del sottotitolo

Apri Template e scansiona il tema attivo. Controlla pagina rilevata, File e Riga prima dell'iniezione. Conserva una copia dei file del tema modificati.

Il controllo Tag della scheda di scansione imposta una sovrascrittura facoltativa del rendering. Il valore predefinito è il tag del sottotitolo/predefinito. Inline è su Off per impostazione predefinita e controlla se l'inserimento si trova sulla stessa riga del template del titolo. Il profilo della pagina è attivo per impostazione predefinita; disattivare Abilitato impedisce l'output del sottotitolo per quel profilo rilevato.

Il meccanismo di posizionamento salva tag del titolo, tag di rendering, parametri hook e preferenza inline. I valori normali sono h1 per la ricerca del titolo, sovrascrittura di rendering vuota, parametri hook vuoti e inline disattivato. Questi nomi salvati non sono tutti etichette visibili separate nella scheda di scansione.

L'iniezione scrive un marcatore rimovibile:

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

Puoi posizionare l'hook autonomamente dopo il titolo pertinente:

{hook h='displayMprSubtitle'}

Per una scheda prodotto, passa l'ID prodotto e un tag facoltativo:

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

Puoi anche fornire una classe personalizzata:

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

Il tag di rendering di un profilo attivo ha precedenza sul parametro tag dell'hook. Il parametro della classe dell'hook può sostituire la classe personalizzata preparata. Template molto personalizzati o titoli generati da JavaScript possono richiedere il posizionamento manuale.

Verifica rendering e stile

Salva un sottotitolo attivo per un prodotto, poi aprilo nel negozio. Verifica che il testo appaia nella posizione dell'hook. Ripeti in un'altra lingua. Apri una pagina non selezionata e verifica che la regola non vi si applichi.

Se corrispondono più regole, "Single subtitle" restituisce il risultato con priorità più alta. "Multiple subtitles" restituisce i risultati corrispondenti per priorità decrescente. Nessun sottotitolo attivo corrispondente significa nessun output.

Un risultato normale può essere:

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

Puoi applicare gli stili alle classi nel foglio di stile personalizzato del tema:

.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;
}

Il modulo mostra un testo visibile separato. Non rinomina l'entità né cambia meta titolo, meta descrizione o URL.

Risolvi i sottotitoli mancanti

Controlla Attivo, targeting, testo nelle lingue, priorità e "Display Mode". Verifica che il file corretto del tema contenga displayMprSubtitle e che il profilo della pagina rilevato sia attivo. Svuota la cache del tema compilato o delle pagine dopo modifiche al posizionamento. Creazione, aggiornamento, eliminazione, modifiche di stato e operazioni massive sulle regole svuotano la cache dei template hook del modulo.

Se i segnaposto sono vuoti, controlla il campo sorgente e il nome tradotto della caratteristica o del gruppo di attributi. Se un elenco mostra il testo del prodotto sbagliato, passa il suo id_product effettivo all'hook.

Dopo un aggiornamento del tema, controlla lo stato di iniezione tracciato e ripeti la scansione. Il gestore dei template può sfogliare, ispezionare, modificare, iniettare e rimuovere i template del tema supportati. La scrittura richiede accesso a quei file.

Se la presa in carico dei sottotitoli di SEO Revolution è attiva, questo modulo autonomo non restituisce intenzionalmente sottotitoli. Controlla la configurazione di presa in carico prima di diagnosticare renderer duplicati o mancanti.

Disattiva o disinstalla

Disattiva il modulo o singole regole per interrompere temporaneamente la visualizzazione.

La disinstallazione conserva i contenuti dei sottotitoli e i profili. In assenza di SEO Revolution, la disinstallazione autonoma rimuove le iniezioni hook tracciate. Se SEO Revolution è installato, la disinstallazione richiede che la sua presa in carico dei sottotitoli sia attiva, registrata e funzionante; altrimenti il modulo blocca la rimozione con un messaggio esplicativo. Con la presa in carico pronta, conserva le iniezioni per il renderer sostitutivo.

La disinstallazione rimuove menu autonomo, impostazioni e preferenze amministrative. Controlla poi i file dei template, specialmente le chiamate hook inserite manualmente.

Domande

1

Cosa succede ai sottotitoli collegati direttamente a un’entità eliminata?

Gli hook di eliminazione di prodotti, categorie, pagine CMS, produttori e fornitori rimuovono i sottotitoli il cui tipo e ID di entità memorizzati corrispondono direttamente all’elemento eliminato.

Problemi noti

4

Il targeting non modificato applicava i sottotitoli ovunque

RisoltoAggiornato:
Risolto nella versione: 1.2.16
Salvare un nuovo sottotitolo senza scegliere le destinazioni poteva applicarlo a tutti i prodotti anziché lasciare vuota la selezione.

Icone mancanti con le risorse combinate

RisoltoAggiornato:
Risolto nella versione: 1.2.14
Le icone dei sottotitoli o le relative risorse potevano mancare quando era attiva la cache delle risorse combinate di PrestaShop.

Traduzioni mancanti o errate

RisoltoAggiornato:
Risolto nella versione: 1.2.12
Alcune etichette del modulo rimanevano in inglese o mostravano caratteri errati quando era selezionata un’altra lingua del negozio.

I filtri dell’elenco dei sottotitoli non funzionavano correttamente

RisoltoAggiornato:
Risolto nella versione: 1.2.10
Alcune colonne dell’amministrazione dei sottotitoli non potevano essere filtrate correttamente.

Richieste funzionalità

4

Implementato

Impostazioni a schede

Implementato
Gestisci le opzioni del modulo tramite impostazioni raggruppate in schede.

Verifica e riparazione dell'installazione

Implementato
Verifica l'installazione del modulo e ripristina le pagine di amministrazione mancanti o le registrazioni necessarie.

Aggiornamenti dal back office

Implementato
Installa gli aggiornamenti disponibili del modulo direttamente dal back office.

Lingue aggiuntive dell'interfaccia

Implementato
Usa le schermate del modulo tradotte in francese, tedesco, spagnolo, italiano e polacco.

Registro modifiche

v1.2.122026-08-28

  • Addedcomplete FR/DE/ES/IT/PL translations
  • FixedRepair subtitles release surface
  • FixedMigrate module state to MPR config
  • FixedUse schema manager for subtitle SQL
  • FixedAdd standard infrastructure checks, tag quality/monitoring checks
Versioni precedenti

v1.4.02026-04-20

  • Addedself-healing integrity checks for automatic diagnostics and repair
  • Addedadmin menu management via MenuInstaller for streamlined module setup
  • AddedLicense management tab with key management and renewal options
  • Addedcomplete FR/DE/ES/IT/PL translations
  • Improvedadmin list columns with visual badge indicators and multiselect filters
  • Improvedsettings form organization with tabbed layout
  • Fixedadmin list filters — sorting, searching, and filtering now work correctly on all columns

v1.3.02026-01-22

  • AddedPS 9 / Hummingbird theme compatibility
  • Addedconfigurable HTML tag selector (h2, h3, p, span) per shop
  • Improvedsubtitle display in product listing cards with truncation option
  • Fixedsubtitle not appearing in Hummingbird product-card template

v1.2.02025-08-11

  • Addedbulk-edit tool — update multiple product subtitles via spreadsheet import
  • Addedsubtitle field to PS product export/import CSV

v1.1.02025-04-06

  • Addedsubtitle display on listing pages alongside product name
  • Addedper-language subtitle with TinyMCE editor
  • Fixedsubtitle not saving when product has combination-specific fields

v1.0.02025-03-22

  • Initialrelease: product subtitle as H2 for SEO-friendly product pages
  • InitialSubtitle field added to product edit page in back office
  • InitialHook-based rendering below H1 product name on detail page
  • InitialCompatible with PS 1.7.x and PS 8.x

Demo

Prova il modulo completo prima di acquistare

Acquista la licenza in seguito e mantieni le tue impostazioni.

  • La tua demo di 30 giorni Provalo sul tuo negozio per 30 giorni dalla prima installazione.
  • Negozio demo pronto Esplora un negozio demo pronto nel tuo browser.
  • Senza registrazione Nessun account, e-mail o dominio del negozio richiesto.
Avvia il negozio demo

Scaricando, accetti le condizioni della demo e l’informativa sulla privacy.

Aprendo questa demo accetti i termini della demo e la politica sulla privacy.

Caricamento...
Torna su