Breadcrumb Pro — Guida completa

Breadcrumb Pro (dfbreadcrumbpro) sostituisce il breadcrumb di base del tuo tema con una navigazione arricchita: menu a discesa con le categorie sorelle su ogni livello, dati strutturati JSON-LD BreadcrumbList conformi alle linee guida di Google, e percorso intelligente per i prodotti che appartengono a più categorie.

Installazione

1. Vai su Moduli > Gestione moduli > Carica un modulo.
2. Carica l’archivio dfbreadcrumbpro.zip e fai clic su Installa.
3. Il modulo si registra automaticamente sugli hook displayHeader, displayWrapperTop e actionFrontControllerSetMedia. Non è necessaria alcuna azione aggiuntiva.

Compatibilità: PrestaShop da 8.0 a 9.x, PHP da 7.4 a 8.3, multinegozio e multilingua.

Configurazione

Apri Moduli > Gestione moduli, cerca «Breadcrumb Pro» e fai clic su Configura. Sono disponibili le seguenti opzioni:

• Sostituire il breadcrumb del tema (attivo per impostazione predefinita) — nasconde via CSS il breadcrumb renderizzato dal tema (classi .breadcrumb e .breadcrumb-wrapper) per evitare duplicazioni visive.
• Attivare i menu a discesa (attivo per impostazione predefinita) — mostra le categorie sorelle in un menu a discesa su ogni livello.
• Mostrare le sottocategorie sull’ultimo livello (disattivo per impostazione predefinita) — sulle pagine categoria, l’ultimo menu elenca le sottocategorie della categoria corrente invece delle sue sorelle. Se la categoria non ha figlie, il modulo torna automaticamente alle sorelle.
• Strategia di percorso per i prodotti — vedi la sezione dedicata più sotto.
• Attivare il JSON-LD BreadcrumbList (attivo per impostazione predefinita) — inietta i dati strutturati schema.org nell’head della pagina.
• Mostrare il link Home (attivo per impostazione predefinita) — primo elemento del percorso che punta alla home page.
• Separatore — carattere mostrato tra i livelli (predefinito ›, massimo 8 caratteri).
• Numero massimo di elementi per menu — limite delle categorie elencate in ogni menu a discesa (predefinito 15, da 1 a 50).

Strategie di percorso prodotto

Quando un prodotto appartiene a più categorie, il modulo deve scegliere quale percorso mostrare. Sono disponibili tre strategie:

Categoria predefinita

Il percorso usa la categoria predefinita del prodotto (id_category_default), ossia il comportamento classico di PrestaShop. Se quella categoria è disattivata o non associata al negozio corrente, il modulo ricade automaticamente sulla categoria più profonda.

Categoria più profonda

Il percorso usa la categoria attiva più profonda (maggiore level_depth) tra quelle del prodotto. È il percorso più specifico, in genere il più interessante per la SEO poiché massimizza il numero di livelli e parole chiave nel percorso e nel JSON-LD.

Contestuale (consigliata, predefinita)

Il modulo memorizza l’ultima categoria visitata dal cliente in un cookie (dfbcp_last_cat). Su una scheda prodotto, se il prodotto appartiene a quella categoria, il percorso mostra quel cammino: la navigazione riflette il percorso reale del visitatore. In caso contrario, il modulo ricade sulla categoria più profonda.

Menu a discesa

Ogni livello del percorso corrispondente a una categoria mostra un pulsante caret. Comportamento:

• Desktop — apertura al passaggio del mouse sul livello o al clic sul caret.
• Mobile — apertura al tocco sul caret, percorso scorrevole orizzontalmente sugli schermi piccoli.
• Chiusura — clic fuori dal percorso o tasto Esc.
• Accessibilità — attributi aria-haspopup, aria-expanded e aria-current, navigazione da tastiera completa.
• Anti-trabocco — i menu si riposizionano automaticamente per non uscire mai dallo schermo.

Gli elenchi delle categorie sorelle sono messi in cache per richiesta e rispettano la lingua e il negozio correnti. La categoria attiva è evidenziata nel menu.

JSON-LD BreadcrumbList

Il modulo inietta nell’head uno script application/ld+json di tipo BreadcrumbList:

• posizioni numerate a partire da 1;
• nome e URL per ogni livello;
• ultimo elemento (pagina corrente) volutamente senza URL, come raccomandano le linee guida di Google;
• mai emesso se il percorso ha meno di due livelli.

Puoi validare il markup con il test dei risultati arricchiti di Google.

Pagine coperte

• Categorie — percorso completo dalla radice del catalogo.
• Schede prodotto — percorso di categoria secondo la strategia scelta, prodotto come ultimo livello.
• Pagine CMS — albero delle categorie CMS e poi titolo della pagina.
• Marche e fornitori — pagina elenco e poi scheda.
• Altre pagine (contatti, offerte, mappa del sito…) — fallback generico sul titolo meta della pagina.
• Home page — nessun percorso visualizzato.

Multinegozio e multilingua

Tutte le query SQL rispettano le associazioni del negozio corrente (contesto multinegozio) e la lingua del visitatore: nomi delle categorie, URL riscritte ed etichette sono risolti nella lingua corretta. La traduzione francese del back-office è inclusa; le altre lingue si traducono da Internazionale > Traduzioni > Traduzioni dei moduli installati.

Risoluzione dei problemi

Il percorso non viene visualizzato

Verifica che il tuo tema esponga l’hook displayWrapperTop (presente nel tema Classic e nella quasi totalità dei temi del marketplace). In caso contrario, aggancia il modulo a un hook di visualizzazione equivalente da Design > Posizioni.

Compaiono due breadcrumb

L’opzione «Sostituire il breadcrumb del tema» è disattivata, oppure il tuo tema usa classi CSS non standard. Riattiva l’opzione o aggiungi una regola CSS mirata al contenitore del breadcrumb del tuo tema.

Il modo contestuale mostra sempre lo stesso percorso

Una cache full-page probabilmente ignora il cookie dfbcp_last_cat. Passa alla strategia «Categoria più profonda» oppure escludi questo cookie dalla chiave di cache.

Un menu a discesa è vuoto su un livello

La categoria non ha sorelle attive associate al negozio corrente: in quel caso il caret semplicemente non viene mostrato.

Cronologia delle versioni

• 1.0.0 (16/07/2026) — Pubblicazione iniziale: menu a discesa con categorie sorelle, JSON-LD BreadcrumbList, strategie predefinita / più profonda / contestuale, copertura di categorie, prodotti, CMS, marche e fornitori, multinegozio e multilingua.