DF Glossary — Glossario SEO per PrestaShop 8 e 9

Panoramica

DF Glossary trasforma il vostro vocabolario di settore in un asset SEO. Inserite i termini una sola volta — con una definizione breve e una lunga — e il modulo fa tre cose automaticamente: inietta un link con tooltip su ogni occorrenza del termine nelle descrizioni di prodotto, categoria e pagine CMS; pubblica una pagina di definizione indicizzabile per termine; e collega ogni definizione ai prodotti che le associate.

Il risultato è una rete di link interni bidirezionale che si costruisce senza sforzo editoriale: le vostre schede rafforzano le definizioni, le definizioni rafforzano i prodotti, e le definizioni si rafforzano tra loro.

Installazione

Requisiti

• PrestaShop 8.0, 8.1, 8.2 o 9.x
• PHP da 7.4 a 8.3
• MySQL 5.7 / MariaDB 10.3 o superiore
• URL semplificati attivi (Parametri del negozio, Traffico e SEO) — indispensabile per le pagine del glossario

Procedura

1. Nel back office, andate su Moduli → Gestore moduli → Carica un modulo.
2. Caricate il file dfglossary-1.0.0.zip.
3. L’installazione crea quattro tabelle SQL, una scheda di back office e le chiavi di configurazione predefinite.
4. Nel menu compare una nuova scheda Catalogo → Glossario SEO. È lì che gestite i vostri termini.
5. Cliccate su Configura dal gestore moduli per accedere alle impostazioni globali.

Configurazione del modulo

Il pannello di configurazione si divide in tre sezioni.

Attivazione e modalità di iniezione

• Attivare l’iniezione — interruttore principale. Disattivato, il modulo smette di arricchire i contenuti, ma le pagine del glossario restano online e indicizzate.
• Modalità — tre valori possibili:
  • Link + tooltip (default): il termine diventa un link verso la sua pagina di definizione e mostra il tooltip al passaggio del mouse. È la modalità che unisce beneficio SEO e beneficio di conversione.
  • Solo link: il termine diventa un link, senza tooltip. Sceglietela se vi interessa solo il linking interno.
  • Solo tooltip: il termine mostra la definizione al passaggio del mouse, senza diventare un link. Sceglietela se volete la pedagogia senza aggiungere link in uscita alle schede prodotto.

Limiti (protezioni anti sovraottimizzazione)

• Occorrenze massime per termine — 1 di default. Anche se una parola compare otto volte in una descrizione, solo la prima occorrenza diventa un link. Consigliamo vivamente di mantenere questo valore: un solo link per concetto basta a trasmettere il segnale semantico, e i successivi diluiscono il PageRank interno senza aggiungere nulla.
• Link massimi per contenuto — 10 di default, sommando tutti i termini. Oltre, il motore si ferma, quali che siano i termini rimasti.

Contenuti interessati

Quattro interruttori indipendenti determinano dove si applica l’iniezione:

• Descrizioni prodotto — la descrizione lunga.
• Includere la descrizione breve — opzione separata. Attenzione: la descrizione breve compare spesso in cima alla scheda e nei listati; inserirvi link può risultare eccessivo.
• Descrizioni categoria — descrizione e descrizione aggiuntiva.
• Pagine CMS e categorie CMS — contenuto delle pagine CMS.

Base URL

Il campo Base URL definisce il segmento sotto cui vengono pubblicate le pagine del glossario. Valore predefinito: glossario, che dà /glossario per l’indice e /glossario/tela-spalmata per una scheda di termine. Il campo è validato come riscrittura di link: solo lettere, cifre e trattini.

Gestire i termini

Andate su Catalogo → Glossario SEO. L’elenco mostra tutti i termini con il loro slug, lo stato del collegamento automatico e lo stato di pubblicazione. Potete cercare, ordinare, filtrare, attivare o disattivare con un clic, ed eliminare in massa.

Creare un termine

Cliccate su Aggiungi un termine. Il modulo è interamente multilingua: ogni campo di testo si inserisce lingua per lingua.

• Termine — la dicitura esatta cercata nei contenuti. La corrispondenza ignora maiuscole e minuscole e rispetta i confini di parola.
• Slug — l’identificativo nell’URL. Lasciatelo vuoto perché venga generato automaticamente dal nome.
• Sinonimi — elenco separato da virgole. Plurali, abbreviazioni e varianti ortografiche attivano lo stesso link e lo stesso tooltip.
• Definizione breve — è il testo del tooltip. Si consiglia testo semplice. Viene troncata a 180 caratteri nella bolla, ma è mostrata per intero in cima alla pagina di definizione.
• Definizione lunga — editor ricco. È il corpo della pagina di definizione, e il contenuto che si posizionerà su Google.
• Meta title / Meta description — opzionali. In loro assenza, il modulo ripiega automaticamente sul nome del termine e sulla definizione breve.
• Prodotti associati — elenco di ID prodotto separati da virgole. Le loro miniature compariranno sulla pagina del termine.
• Collegamento automatico — interruttore individuale. Disattivato, il termine conserva la sua pagina di definizione indicizzata ma non viene mai iniettato nei contenuti.
• Attivo — disattivato, il termine scompare dal glossario e la sua pagina restituisce un 404 pulito.

Buone pratiche editoriali

• Puntate a 20-50 termini. Il volume non è la variabile importante: un termine merita il suo posto se compare davvero nelle vostre descrizioni e risponde a una domanda che i clienti si pongono.
• Scrivete definizioni lunghe da 150 a 400 parole. Abbastanza per costituire un contenuto autonomo agli occhi di Google, abbastanza brevi da produrre rapidamente.
• Associate da 2 a 6 prodotti per termine, non di più. Una pagina di definizione che punta a venti prodotti diluisce la propria autorità.
• Curate i sinonimi. È la leva che moltiplica la copertura: un catalogo redatto per anni da più persone raramente esprime uno stesso concetto in un solo modo.
• Non traducete i sinonimi parola per parola. Ogni lingua ha le proprie varianti; inseritele in modo indipendente.

Come funziona l’iniezione

L’arricchimento avviene lato server, al momento del rendering della pagina, tramite gli hook di filtraggio dei contenuti di PrestaShop. Le vostre descrizioni non vengono mai modificate nel database: se disattivate il modulo, i contenuti tornano immediatamente allo stato originale.

Il motore di sostituzione

Il contenuto viene diviso in segmenti tag e segmenti testo. Solo i segmenti testo sono candidati alla sostituzione. Queste zone vengono sistematicamente ignorate:

• link esistenti (nessun rischio di creare un link annidato),
• titoli h1, h2 e h3,
• blocchi script, style, code, pre, svg, noscript,
• campi di modulo: textarea, select, option, button,
• iframe.

Sui segmenti consentiti, la ricerca usa confini di parola Unicode: è impossibile trasformare un frammento situato all’interno di una parola o di un identificatore. La corrispondenza ignora maiuscole e minuscole e tollera spazi multipli o a capo. Infine, ogni link iniettato viene sostituito temporaneamente da un token univoco durante l’elaborazione — un termine non può quindi mai essere ricollegato all’interno di un link che il modulo stesso ha appena creato.

Ordine di priorità delle varianti

Tutte le varianti di un termine (nome principale e sinonimi) vengono unite e ordinate per lunghezza decrescente. L’espressione più lunga vince sempre. Concretamente, se tela spalmata in PVC e tela spalmata figurano entrambe tra i sinonimi, sarà la prima a essere collegata quando compare per intero.

Le pagine del glossario

Pagina indice

Accessibile su /glossario, elenca tutti i termini attivi, raggruppati per lettera, con navigazione alfabetica e un estratto per termine. Emette un JSON-LD di tipo DefinedTermSet.

Pagina di definizione

Accessibile su /glossario/{slug}, ogni scheda contiene:

• un titolo H1 e la definizione breve in evidenza,
• la definizione lunga in formato ricco, in cui gli altri termini del glossario vengono a loro volta collegati automaticamente (il termine corrente è escluso, nessun auto-link),
• le miniature dei prodotti associati,
• una nuvola di termini correlati,
• meta title e meta description dedicati, URL canonico, breadcrumb,
• un JSON-LD di tipo DefinedTerm.

Se uno slug non esiste o il termine è disattivato, la pagina restituisce un 404 pulito.

Multilingua e multi-negozio

Tutti i campi di testo del glossario sono multilingua: nome, sinonimi, definizioni, slug, meta title e meta description possono differire in ciascuna lingua. Il matching avviene sempre nella lingua del contesto corrente: una descrizione italiana non verrà mai arricchita con termini inglesi.

Sul fronte multi-negozio, i termini sono collegati ai negozi tramite la tabella di associazione standard di PrestaShop. Potete quindi avere un glossario tecnico denso su un negozio B2B e uno divulgativo su un negozio B2C, nella stessa installazione.

Comportamento su mobile

Su uno schermo touch non esiste l’hover. Il modulo carica un mini script che gestisce il tap: il primo tap su un termine mostra il tooltip e blocca la navigazione, il secondo apre la pagina di definizione. Gli altri tooltip aperti si chiudono automaticamente, e un tap fuori dal termine chiude la bolla.

Prestazioni

Il dizionario dei termini viene caricato una sola volta per richiesta e messo in cache statica: anche una pagina categoria che mostra trenta prodotti genera una sola query SQL per il glossario. La sostituzione in sé è una manipolazione di stringhe in PHP, nell’ordine del millisecondo. Non viene caricato JavaScript bloccante, non viene effettuata alcuna chiamata di rete, e il risultato è pienamente compatibile con la cache full-page.

Risoluzione dei problemi

Nessun link compare nelle schede prodotto

• Verificate che l’interruttore principale Attivare l’iniezione sia su Sì.
• Verificate che Descrizioni prodotto sia attivo nei contenuti interessati.
• Verificate che il termine sia attivo e che il suo collegamento automatico sia attivo.
• Verificate che il termine sia compilato nella lingua della scheda consultata: un termine inserito solo in francese non verrà mai iniettato in una descrizione italiana.
• Svuotate la cache di PrestaShop (Parametri avanzati → Prestazioni).

Il termine compare nel testo ma non è collegato

Tre cause possibili. O il termine si trova già dentro un link, un titolo h1-h3 o una zona protetta: è il comportamento previsto. Oppure il limite di occorrenze per termine (1 di default) è già stato raggiunto per quel contenuto: le occorrenze successive restano testo semplice, è normale. Oppure è stato raggiunto il limite globale di 10 link per contenuto.

Le pagine del glossario restituiscono un 404

• Verificate che gli URL semplificati siano attivi.
• Rigenerate il file .htaccess (Parametri del negozio → Traffico e SEO → Genera il file .htaccess).
• Verificate che il termine sia attivo e che il suo slug sia compilato nella lingua consultata.

I tooltip non compaiono

Verificate che la modalità non sia impostata su Solo link. Se la modalità è corretta, svuotate la cache e verificate che il foglio di stile del modulo venga caricato (viene aggiunto automaticamente su tutte le pagine del front).

Disinstallazione

La disinstallazione rimuove le quattro tabelle SQL del modulo, la scheda del back office e tutte le chiavi di configurazione. I vostri termini vengono quindi persi definitivamente: esportateli se pensate di reinstallare più avanti. Al contrario, nessuna descrizione di prodotto, categoria o CMS è mai stata modificata nel database: i contenuti tornano semplicemente allo stato originale, senza alcuna pulizia da eseguire.

Limiti noti

• L’unicità degli slug non è forzata per lingua. Se due termini condividono lo stesso slug nella stessa lingua, vince il primo trovato. Controllate gli slug al momento dell’inserimento.
• Le zone protette (link, titoli h1-h3, codice, campi di modulo) non vengono mai arricchite. È una scelta progettuale, non un limite aggirabile.