Smart Breadcrumbs: configurazione e aiuto
Avvio rapido
- Carica lo ZIP del modulo in Moduli > Gestione moduli, installa Smart Breadcrumbs e fai clic su Configura.
- In modalità multinegozio, seleziona il singolo negozio da configurare. Apri License e controlla lo stato.
- In Configuration, lascia attivi Enable Smart Breadcrumbs e Enable navigation dropdowns. Controlla BreadcrumbList ownership prima di salvare.
- Fai clic su Salva o Salva e rimani.
- Apri Integrity, fai clic su Check breadcrumb integration e attendi il completamento del controllo. Esamina gli eventuali problemi segnalati relativi alle pagine o al tema.
- Apri una pagina prodotto pubblica e una pagina categoria. Segui un link a un elemento superiore e apri un menu a discesa disponibile usando il pulsante con la freccia.
- Modifica l'aspetto e le etichette. Attiva i prodotti alternativi o i gruppi personalizzati solo se ti servono.
Manuale di configurazione
Installare e aprire il modulo
Installa lo ZIP tramite la gestione moduli del negozio. Configura apre Configuration. Il modulo offre anche le pagine Dropdown Groups, Definable Trails, Integrity, License, Support e Update.
Seleziona un solo negozio prima di salvare le impostazioni o gestire gruppi e percorsi. Queste modifiche appartengono a quel negozio. I dipendenti devono avere i permessi corrispondenti di visualizzazione, aggiunta, modifica o eliminazione.
La sostituzione del percorso di navigazione nel front office richiede una licenza idonea e il superamento del controllo dell'integrazione del percorso. Se l'integrazione non è disponibile, il modulo mantiene l'output del percorso di navigazione nativo del tema.
Controllare l'integrazione con il tema
Apri Integrity nel negozio selezionato e fai clic su Check breadcrumb integration. Tieni aperta la pagina mentre prosegue il controllo dell'installazione. La pagina mostra gli URL interessati, la lingua, il dispositivo e il risultato, incluse le richieste pubbliche dopo la pubblicazione.
Il modulo include profili di integrazione per Classic e i suoi temi child su PrestaShop da 1.7 a 9, Hummingbird e i suoi temi child su PrestaShop da 8.1 a 9 e default-bootstrap su PrestaShop 1.6.1 o successivo nella serie 1.6. I template del tema devono corrispondere a uno di questi profili; il solo nome del tema non basta.
Ripeti il controllo dopo aver cambiato tema o quando Integrity segnala un'integrazione modificata. Se segnala che i controlli pubblici non sono terminati, ripeti Check breadcrumb integration.
Il controllo Breadcrumb links in structured data indica quale modulo fornisce la navigazione e quale fornisce lo schema. Avvisa anche se lo schema viene eseguito prima della navigazione o se un modulo noto che scrive gli URL viene eseguito dopo. Questo controllo segnala l'ordine; non riordina gli hook.
Scegliere l'aspetto
| Impostazione | Valore predefinito | Comportamento |
|---|---|---|
| Design preset | Minimal | Scegli Minimal, Boxed, Pill o Underline. |
| Separator | Chevron | Scegli chevron, barra obliqua, freccia, punto, barra verticale, trattino, simbolo maggiore di, punto elenco o nessuno. |
| Dropdown indicator | Chevron | Scegli chevron, caret, più / meno o puntini per il pulsante del pannello. |
| Current item | Tronca | Scegli mostra, tronca o nascondi. Nascondi rimuove l'ultimo elemento quando il percorso ne contiene più di uno, incluso il relativo menu a discesa. Un percorso con un solo elemento resta visibile. |
| Current-item character limit | 72 | Contrassegna l'etichetta attuale per il troncamento visivo quando supera questa soglia. Accetta da 20 a 255. La larghezza visibile dipende poi dall'area di visualizzazione; non si tratta di un taglio letterale dopo quel numero di caratteri. |
| Mobile horizontal scrolling and fades | Sì | Usa lo scorrimento orizzontale con sfumature ai bordi. Disattivandolo si seleziona il layout con ritorno a capo. |
| Respect reduced-motion preference | Sì | Elimina transizioni e animazioni del percorso quando il visitatore richiede un movimento ridotto. |
I visitatori possono aprire un pannello con il suo pulsante, usare i tasti freccia per spostarsi tra i link e premere Esc per chiuderlo. Anche un clic all'esterno chiude il pannello. La ricerca nei menu a discesa richiede JavaScript; i link alternativi iniziali vengono generati insieme alla pagina.
Creare gruppi personalizzati per i menu a discesa
Attiva prima Enable curated dropdown groups in Configuration. Per i gruppi di prodotti, attiva anche Show other products on the product crumb. Apri Dropdown Groups e aggiungi un gruppo.
| Campo | Valore iniziale | Cosa inserire |
|---|---|---|
| Apply to all categories (global) | Sì | Usa il gruppo come soluzione di ripiego all'interno di questo negozio. Disattivalo per scegliere una categoria. |
| Context category | Nessuna | Seleziona la categoria di contesto del menu a discesa. I selettori di prodotti usano il proprio contesto di categoria; i menu delle categorie dello stesso livello usano la categoria superiore come contesto. |
| Dropdown | Selettore di prodotti (prodotti) | Scegli selettore di prodotti (prodotti) o menu a discesa delle categorie (categorie). |
| Match | Corrispondenza per parola chiave nel nome dell'elemento | Scegli uno dei metodi di corrispondenza seguenti. |
| Keyword | Vuoto | Indica il frammento del nome per la corrispondenza per parola chiave. Non deve essere vuoto in questa modalità. |
| Selected items | Vuoto | Scegli prodotti o categorie per la selezione manuale o l'esclusione. Trascina le relative etichette per impostare l'ordine manuale. |
| Heading | Vuoto | Titolo facoltativo per ogni lingua. Una traduzione vuota usa un altro titolo non vuoto, se presente. |
| Position | Posizione successiva nel contesto | Le posizioni inferiori vengono elaborate per prime. |
| Active | Sì | Attiva questo gruppo. |
Le opzioni di Match funzionano così:
- Match by keyword in the item name raggruppa le alternative il cui nome contiene Keyword, senza distinzione tra maiuscole e minuscole.
- Pick specific items raggruppa le alternative selezionate nell'ordine salvato.
- Hide these items rimuove le alternative selezionate da questo menu a discesa e dai suoi risultati di ricerca. Non nasconde le relative pagine del negozio.
- Everything else / remaining items fornisce titolo e posizione per le alternative non assegnate a un altro gruppo. È consentito un solo gruppo attivo di elementi rimanenti per contesto e tipo di elemento.
I gruppi attivi specifici di una categoria sostituiscono l'insieme globale di gruppi per quel contesto e tipo di elemento. Non vengono combinati con l'insieme globale. Si applicano prima le esclusioni; poi gli altri gruppi si assegnano gli elementi corrispondenti in ordine di posizione. Un elemento appare in un solo gruppo. Gli elementi non assegnati ricevono comunque una sezione per gli elementi rimanenti se non ne hai definita una.
Fai clic su Salva o Salva e rimani. L'elenco supporta modifica, eliminazione, attivazione o disattivazione di Active e le azioni collettive Abilita selezione e Disabilita selezione. I gruppi di categorie influiscono sulle alternative dello stesso livello, inclusa la parte corrispondente dell'opzione categorie dello stesso livello e sottocategorie, anziché sugli elenchi di sole sottocategorie.
Definire un percorso prodotto personalizzato
Apri Definable Trails e aggiungi una definizione. Queste regole personalizzano gli elementi superiori delle pagine prodotto. Non modificano le assegnazioni dei prodotti alle categorie.
- Inserisci Name, un nome interno di massimo 255 caratteri. Priority parte da 0 e Active da Sì.
- Scegli Match products by. Il valore predefinito è Exact product. Seleziona il prodotto, la categoria o la pagina di filtro di destinazione secondo il caso.
- Scegli Build method. Il valore predefinito è Replace existing ancestors.
- Sotto Ordered ancestors, fai clic su Add ancestor per ogni nodo necessario. Home e Current product sono estremità fisse. Usa Move up, Move down o Remove per modificare l'ordine.
- Seleziona un Sample product e fai clic su Preview with sample product. Controlla il percorso risultante e gli eventuali problemi segnalati prima di salvare.
- Fai clic su Salva o Salva e rimani, quindi apri la pagina prodotto interessata.
| Opzione di Match products by | Comportamento |
|---|---|
| Exact product | Corrisponde a un singolo prodotto selezionato. |
| Filter SEO page membership | Corrisponde all'appartenenza confermata di un prodotto a una pagina SEO di Filter Revolution selezionata. |
| Assigned category | Corrisponde a una categoria assegnata al prodotto, inclusa quella predefinita. |
| Default category | Corrisponde alla categoria predefinita del prodotto. |
Include subcategories inizialmente non è selezionato e si applica ai due criteri di categoria. Include i prodotti la cui categoria corrispondente si trova sotto la categoria selezionata.
Con Replace existing ancestors, il risultato è Home, i tuoi nodi ordinati e infine Current product. Un elenco di nodi vuoto lascia Home e Current product. Con Insert after a category crumb, seleziona Insert after category e fornisci almeno un nodo. Quella categoria deve già comparire nel percorso originale del prodotto.
Le fonti disponibili per gli elementi superiori sono:
| Fonte | Cosa scegliere |
|---|---|
| Category | Una categoria disponibile per questo negozio e visitatore. Aggiunge la categoria selezionata come un solo nodo. |
| CMS page | Una pagina CMS attiva disponibile in questo negozio e in questa lingua. |
| Filter SEO page | Una specifica pagina SEO di Filter Revolution disponibile. |
| Matched Filter SEO page | La pagina selezionata da Filter SEO page membership. Questa fonte richiede quel criterio di corrispondenza. |
| Custom link | Un'etichetta e un URL assoluto HTTP o HTTPS di questo negozio per ogni lingua modificabile. Gli URL non devono contenere un frammento. |
Per i nodi di entità, Label override (optional) può sostituire l'etichetta normale in ogni lingua. Senza sostituzione viene usata l'etichetta della fonte. I link personalizzati richiedono sia l'etichetta tradotta sia l'URL. Destinazioni ripetute o non valide impediscono l'applicazione della definizione.
I valori inferiori di Priority vengono considerati per primi. A parità di priorità, l'ordine è Exact product, Filter SEO page membership, Assigned category e poi Default category, seguito dall'ID della definizione. Vince la prima definizione corrispondente che produce un percorso valido. Se nessuna è applicabile, rimane il percorso originale. Se l'appartenenza al filtro fornita non può essere stabilita in modo sicuro, viene preservato anche in questo caso il percorso originale.
Sono consentite al massimo 100 definizioni attive di percorsi prodotto per negozio e 128 nodi per definizione. Usa l'interruttore Active dell'elenco o Abilita selezione e Disabilita selezione per gestire le definizioni. Elimina singolarmente quelle non più necessarie.
Modificare l'elemento superiore immediato del prodotto può rimuovere il suo menu a discesa con i prodotti alternativi. Il menu viene mantenuto solo se il percorso personalizzato conserva la stessa categoria superiore immediata del percorso originale.
Usare le integrazioni con altri moduli
Filter Revolution può fornire la navigazione delle categorie filtrate, la scelta ricercabile delle pagine SEO dei filtri, l'appartenenza dei prodotti per la corrispondenza dei percorsi e i nodi superiori delle pagine di filtro. L'integrazione deve fornire dati validi per il negozio e la lingua attuali. Se l'editor dei percorsi mostra Filter Revolution breadcrumb integration is unavailable., le opzioni dipendenti dai filtri non possono essere usate finché l'integrazione non è disponibile.
La navigazione delle radici dei contenuti riconosce le sezioni di Blog Revolution, MPR FAQ, Support Revolution o Knowledge Base, la documentazione di Product Tabs, Issues Revolution, Feature Request, la roadmap di Digital Revolution, le recensioni di Comments e Customer Showcase quando sono disponibili le rispettive rotte pubbliche.
Cross-link content sections collega le sezioni di risorse disponibili ad altre sezioni di risorse, e le recensioni alla vetrina clienti all'interno del loro gruppo di contenuti separato. Non crea queste sezioni e non attiva una rotta pubblica disabilitata. La navigazione dei ticket di assistenza appartiene all'area account.
Per un'integrazione personalizzata, uno sviluppatore può usare filterMprBreadcrumbTrail per modificare o restituire un percorso di navigazione. L'hook riceve il percorso, il nome del fornitore e il modulo che esegue il rendering. Le integrazioni che modificano una fonte del percorso possono notificare actionMprBreadcrumbSourceChanged per invalidare i dati di navigazione.
Gestire la licenza, gli aggiornamenti e l'assistenza
Apri License per controllare lo stato e la scadenza della licenza. Usa Refresh dopo un acquisto o un rinnovo. La partecipazione al front office richiede uno stato attivo, test, demo o prova entro il relativo periodo di validità.
Apri Update e fai clic su Check for updates. Quando viene proposto un aggiornamento, usa Update Now. Per uno ZIP del modulo, usa Manual Update, Add file e poi Upload & Install. Controlla quindi Integrity e ripeti Check breadcrumb integration quando richiesto.
Apri Support per ricevere assistenza sul modulo. Includi l'URL del front office interessato, il negozio e la lingua selezionati, le impostazioni pertinenti e il messaggio mostrato da Integrity o dall'anteprima del percorso.
Disattivare o disinstallare
Per interrompere la funzione condivisa del percorso di navigazione in un negozio, imposta Enable Smart Breadcrumbs su No e salva. Per interrompere la partecipazione di questo modulo, disattiva Smart Breadcrumbs in Gestione moduli. Un altro modulo cooperante idoneo può continuare a fornire la funzione condivisa del percorso di navigazione.
La disinstallazione rimuove il menu del back office e le preferenze di questo modulo. Conserva deliberatamente le impostazioni condivise del percorso, le traduzioni, le chiavi segrete per la ricerca, le sette tabelle del percorso di navigazione e l'infrastruttura condivisa di integrazione con il tema. La reinstallazione può quindi riutilizzare configurazione, gruppi e percorsi esistenti. La disinstallazione non azzera questi dati.
Compatibilità
Dichiara PrestaShop da 1.6.0.0 a 9.99.99 e richiede PHP 7.1 o successivo. La sostituzione del percorso nel front office richiede anche una composizione dei template supportata e il superamento del controllo dell'integrazione.
Domande
15
Cosa succede ai dati strutturati del breadcrumb su una pagina noindex?
Il modulo omette la propria BreadcrumbList quando il percorso non è idoneo allo schema o la policy della pagina rileva noindex, anche in un meta tag robots o in un’intestazione X-Robots-Tag. I dati breadcrumb esistenti di terze parti possono rimanere.
Su quali pagine aggiunge i breadcrumb?
Gli interruttori dei tipi di pagina coprono prodotti, categorie, pagine e categorie CMS, produttori, fornitori, ricerca, account e checkout, oltre ad altri controller del negozio supportati. Integrazioni dedicate risolvono anche i percorsi di Filter Revolution, Blog, FAQ e Knowledge Base quando sono disponibili i moduli corrispondenti e il contesto della pagina.
Come gestisce il modulo i dati strutturati breadcrumb esistenti?
Quando la gestione dello schema è attiva, il modulo può riutilizzare una BreadcrumbList corrispondente in modalità «defer» oppure emettere la propria. Se i dati esistenti non possono essere conciliati in sicurezza, il subentro nella gestione dello schema viene bloccato e l’output esistente viene conservato.
Quali versioni di PrestaShop e PHP dichiara Smart Breadcrumbs?
Il modulo dichiara PrestaShop da 1.6.0.0 a 9.99.99 e richiede PHP 7.1 o successivo. L’integrazione del tema deve superare i controlli di compatibilità integrati.
Cosa sono i Definable Trails?
I Definable Trails personalizzano i livelli superiori delle pagine prodotto corrispondenti. Le regole possono corrispondere a un prodotto, una categoria o una pagina Filter SEO supportata, poi sostituire i livelli superiori o inserire passaggi dopo una categoria scelta del percorso originale. Home e prodotto corrente restano nel percorso. Una definizione inutilizzabile lascia disponibile il percorso normale.
Quali comandi da tastiera e funzioni di accessibilità sono disponibili?
I menu a tendina usano pulsanti nativi con aria-expanded e aria-controls, seguiti da normali elenchi di link. Frecce, Home, Fine ed Esc permettono la navigazione da tastiera; l’elemento corrente usa aria-current. La gestione del movimento ridotto si applica quando è attiva.
Smart Breadcrumbs memorizza in cache le ricerche di navigazione?
Sì. Le ricerche delle categorie superiori usano una cache persistente che distingue negozio, lingua e contesto di accesso. Le alternative dei menu a tendina e i risultati di ricerca vengono letti dalle relative fonti su richiesta.
Come viene costruita la BreadcrumbList?
Lo schema usa la proiezione del percorso visibile, con posizioni sequenziali e URL assoluti degli elementi senza frammenti. Le alternative dei menu a tendina sono escluse e il JSON viene codificato con flag di sicurezza HTML. Lo schema non viene generato quando la sua gestione è disattivata, il percorso non è idoneo o rimangono meno di due elementi visibili.
Smart Breadcrumbs sostituisce il breadcrumb del mio tema?
Il modulo usa un’integrazione condivisa dei template per i layout supportati di Classic, Hummingbird e default-bootstrap di PrestaShop 1.6. La sostituzione richiede che l’integrazione del tema superi i controlli di compatibilità; i layout non supportati o non riconosciuti mantengono il breadcrumb nativo.
Supporta i temi da destra a sinistra?
Gli stili usano il posizionamento logico per le sfumature di scorrimento e invertono separatori direzionali e sfumature quando un elemento antenato è RTL. JavaScript legge la direzione calcolata per posizionare i pannelli a tendina.
Cosa possono mostrare i menu a tendina del breadcrumb?
I menu delle categorie possono mostrare categorie sorelle, sottocategorie o entrambe. Il menu Home facoltativo mostra le categorie di primo livello e i menu prodotto possono elencare altri prodotti attivi e visibili a catalogo nella stessa categoria. Queste ricerche rispettano negozio corrente, lingua e permessi del gruppo cliente.
Posso adattarlo all'aspetto del mio tema?
In Configuration scegli il preset Minimal, Boxed, Pill o Underline, un separatore, un indicatore del menu a tendina e se mostrare, troncare o nascondere l’elemento corrente. Puoi anche impostare il limite di troncamento, lo scorrimento mobile e il rispetto della preferenza di movimento ridotto.
I link dei menu a tendina sono inclusi nei dati strutturati del breadcrumb?
No. Gli elementi dei menu a tendina sono normali link resi nel template del breadcrumb. La BreadcrumbList usa gli elementi ordinati del percorso visibile ed esclude le alternative dei menu a tendina.
Smart Breadcrumbs crea cookie di tracciamento?
No. Il codice del modulo nel front office non scrive cookie propri, dati nella memoria locale o di sessione né identificatori di analisi. Legge il contesto esistente dei gruppi cliente PrestaShop per limitare i link di navigazione.
Supporta più lingue e il multistore?
Le etichette del breadcrumb hanno valori per lingua e le ricerche di navigazione usano negozio e lingua correnti. Configurazione, gruppi di menu personalizzati e definizioni dei percorsi sono specifici per negozio; le etichette dei passaggi e gli URL personalizzati possono avere traduzioni. Controlla le impostazioni e le etichette tradotte nel contesto di ogni negozio.
Problemi noti
18
Attivazione da riga di comando non riuscita
Controlli della licenza non disponibili su alcune pagine del back office
Integrazione breadcrumb non riuscita su PrestaShop 1.6
Pagine private in errore durante il rendering dei breadcrumb
Link breadcrumb con identità della pagina errata
Breadcrumb ripetuti o aggiornati con metadati incoerenti
Testi del back office tradotti
Metadati breadcrumb esistenti non riconosciuti
Testi breadcrumb non tradotti o danneggiati
Centri di navigazione vuoti proposti nei menu a discesa
Link alle pagine informative con impostazione di sicurezza errata
Metadati breadcrumb persi nella pulizia dei link correlati
Breadcrumb obsoleti dopo gli aggiornamenti dell’elenco
Percorsi non salvabili con un’integrazione non disponibile
La modifica di un percorso cambia la pagina filtro salvata
Menu a discesa fuori dai breadcrumb o disallineati
Modifica dei percorsi personalizzati con perdita di selezioni o traduzioni
Menu a discesa dei breadcrumb con overflow orizzontale
Richieste funzionalità
6
Implementato
Menu a discesa accessibili del percorso
Aspetto del percorso di navigazione
Gruppi di link selezionati nel percorso
Percorsi prodotto personalizzati
Percorsi di navigazione in tutto il negozio
Metadati del percorso per i motori di ricerca
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.
Scaricando, accetti le condizioni della demo e l’informativa sulla privacy.
Aprendo questa demo accetti i termini della demo e la politica sulla privacy.