DF Fitment Finder — Ricerca per veicolo e compatibilità prodotto

DF Fitment Finder aggiunge al vostro negozio PrestaShop una ricerca per compatibilità: il cliente seleziona il suo veicolo (o il suo apparecchio) e il catalogo gli mostra soltanto i prodotti che gli vanno bene. Questa documentazione copre l’installazione, la configurazione, l’alimentazione dell’archivio veicoli e la visualizzazione nel front-office.

Installazione

1. Andate in Moduli > Gestore moduli, poi fate clic su Carica un modulo.
2. Trascinate il file dffitmentfinder.zip e avviate l’installazione.
3. Fate clic su Configura per accedere alle impostazioni.

L’installazione crea tre tabelle (archivio veicoli, corrispondenze prodotti, garage clienti), registra gli hook necessari e aggiunge la scheda Veicoli sotto il menu Catalogo. Non viene installato alcun override del core e non è richiesta alcuna dipendenza da Composer.

Configurazione

Livelli di ricerca

Il selettore si basa su quattro livelli: Marca, Modello, Anno e Motorizzazione. I primi due sono sempre attivi; gli ultimi due si attivano o disattivano in base al vostro catalogo.

• Usare l’anno: da disattivare per un catalogo senza nozione di anno (cartucce per stampanti, cover, pezzi di elettrodomestici).
• Usare la motorizzazione: da disattivare se il livello più fine del vostro archivio è il modello.

La ricerca resta possibile non appena marca e modello sono indicati: il cliente non è mai obbligato ad arrivare al livello più fine.

Etichette dei livelli

Ogni livello porta un’etichetta modificabile per lingua. Per impostazione predefinita: Marca, Modello, Anno, Motorizzazione. Adattatele al vostro settore:

• Ricambi auto: Marca / Modello / Anno / Motorizzazione
• Cartucce per stampanti: Marca / Serie / — / Riferimento
• Cover per telefoni: Marca / Modello
• Elettrodomestici: Produttore / Gamma / Anno / Riferimento

Zone di visualizzazione

• Mostrare nell’intestazione: il selettore appare in alto su tutte le pagine.
• Mostrare in home page: il selettore appare nel contenuto della home page.
• Widget: posizionate il selettore dove volete nel vostro tema con il tag Smarty {widget name='dffitmentfinder'}.

Scheda prodotto

• Verifica di compatibilità: mostra sotto il prezzo un avviso verde (il prodotto va bene per il veicolo corrente), rosso (non va bene) o neutro (nessun veicolo selezionato).
• Tabella delle corrispondenze: mostra in fondo alla scheda l’elenco completo dei veicoli compatibili, raggruppato per marca e richiudibile.

Risultati per pagina

Numero di prodotti mostrati per pagina nella pagina dei risultati. Valore predefinito: 12.

Alimentare l’archivio veicoli

Inserimento manuale

Andate in Catalogo > Veicoli. Il pulsante Aggiungi apre il modulo di un veicolo:

• Marca e Modello: obbligatori.
• Anno di inizio e Anno di fine: facoltativi. Lasciati vuoti, il veicolo è considerato valido per tutti gli anni. Compilati, definiscono un intervallo: un veicolo 2012–2019 appare nel selettore sotto ciascuno degli anni dell’intervallo.
• Motorizzazione: facoltativa, è il livello più fine (ad esempio «1.2 PureTech»).
• Attivo: un veicolo inattivo non appare più nel selettore ma conserva le sue corrispondenze.

Associare prodotti a un veicolo

Una volta salvato il veicolo, un pannello Prodotti compatibili appare in fondo al suo modulo. Digitate almeno due caratteri (nome o riferimento) nel campo di ricerca, fate clic su un risultato e il prodotto viene associato immediatamente. Il campo Nota, facoltativo, permette di precisare la portata della compatibilità: «solo assale anteriore», «cambio manuale», «dal telaio n. 12000»… Questa nota compare nella tabella delle corrispondenze della scheda prodotto.

Importazione CSV

Per archivi voluminosi, l’importazione CSV è la via consigliata. Il file atteso ha sei colonne:

make;model;year_from;year_to;variant;references

Esempio:

Peugeot;208;2012;2019;1.2 PureTech;BRK-P208-F|FLT-P208
Peugeot;208;2012;2019;1.6 BlueHDi;BRK-P208-F
HP;LaserJet Pro M404;;;;TNR-59A|TNR-59X

• Il separatore, punto e virgola o virgola, viene rilevato automaticamente.
• La colonna references contiene i riferimenti prodotto compatibili, separati da una barra verticale.
• Le colonne degli anni e della motorizzazione possono restare vuote.
• Un veicolo già presente nell’archivio non viene duplicato: le sue corrispondenze vengono semplicemente completate.
• Al termine dell’importazione, un rapporto indica quanti veicoli sono stati creati, quante corrispondenze aggiunte e quante righe in errore.

Esportazione CSV

Il pulsante Esporta in CSV, nella pagina di configurazione del modulo, scarica l’intero archivio nello stesso formato. Comodo per rielaborare i dati in un foglio di calcolo e reimportarli.

Il percorso del cliente

Selezione del veicolo

Il cliente sceglie la marca, poi il modello, poi (se i livelli sono attivi) l’anno e la motorizzazione. Ogni menu si riempie a partire dal precedente, senza ricaricare la pagina. Il pulsante Cerca apre la pagina dei risultati, che mostra i prodotti compatibili con le miniature native del vostro tema.

Il veicolo selezionato viene poi memorizzato e richiamato su tutte le pagine, finché il cliente non lo cambia o lo cancella.

Il mio garage

Il pulsante Aggiungi al mio garage salva il veicolo corrente. La pagina Il mio garage, accessibile dall’area cliente, elenca i veicoli salvati e permette di:

• designare un veicolo come veicolo corrente;
• vedere direttamente i prodotti compatibili con un veicolo;
• eliminare un veicolo dal garage.

Il garage funziona anche per i visitatori non registrati: i loro veicoli vengono conservati e associati automaticamente al loro account non appena accedono o si registrano.

Sulla scheda prodotto

Se la verifica di compatibilità è attiva e un veicolo corrente è selezionato, un avviso appare sotto il prezzo: verde se il prodotto è compatibile, rosso altrimenti. In assenza di veicolo selezionato, un messaggio neutro invita il cliente a sceglierne uno.

Se la tabella delle corrispondenze è attiva, la scheda mostra in fondo l’elenco completo dei veicoli compatibili, raggruppato per marca e richiudibile, con l’eventuale nota di ogni corrispondenza.

Domande frequenti

Posso usare il modulo senza nozione di veicolo?

Sì. Disattivate i livelli Anno e Motorizzazione, rinominate le etichette, e il modulo diventa un selettore Marca / Serie adatto a cartucce, cover, pezzi di elettrodomestici o a qualsiasi catalogo in cui la compatibilità condiziona l’acquisto.

Cosa succede a una corrispondenza quando elimino un prodotto?

Viene eliminata automaticamente. L’archivio non conserva righe orfane.

Il selettore rallenta il mio sito?

No. I menu vengono riempiti via AJAX su richiesta, in JavaScript nativo e senza dipendenza da jQuery: solo l’elenco delle marche viene caricato alla prima visualizzazione.

Il modulo è compatibile con il multinegozio?

Sì. Le corrispondenze prodotto e i garage clienti rispettano il contesto negozio.