# 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… - Pagina: - Lingua: it - Aggiornato il: 2026-09-15 - Altre lingue: [fr](https://www.datafirefly.com/documentation/dffitmentfinder/index.md), [en](https://www.datafirefly.com/en/documentation/dffitmentfinder/index.md), [es](https://www.datafirefly.com/es/documentation/dffitmentfinder/index.md), [de](https://www.datafirefly.com/de/documentation/dffitmentfinder/index.md), [pl](https://www.datafirefly.com/pl/documentation/dffitmentfinder/index.md), [pt](https://www.datafirefly.com/pt/documentation/dffitmentfinder/index.md), [nl](https://www.datafirefly.com/nl/documentation/dffitmentfinder/index.md) - Indice: 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. Compatibile con PrestaShop da 8.0 a 9.x, PHP da 7.4 a 8.3, sia in negozio singolo sia in multinegozio. ## 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. ## Posizioni, icona e layout (v1.1.0) Dalla versione 1.1.0, gli interruttori «Mostra nell'intestazione» e «Mostra nella home page» sono sostituiti da un blocco **Mostra il selettore su**: sette caselle che coprono le posizioni più comuni del tema (intestazione, barra sotto l'intestazione, home page, parte superiore del contenuto, colonne sinistra e destra, sopra il footer). Il campo **Hook personalizzati** accetta inoltre i tuoi hook display, separati da virgole: vengono registrati automaticamente al salvataggio. Il widget `{widget name='dffitmentfinder'}` continua a funzionare, indipendentemente da queste impostazioni. - **Icona veicolo**: sei modelli inclusi (auto, garage, stampante, telefono, chiave, chip), nessuna icona, oppure la tua immagine PNG, JPG o SVG caricata dalla configurazione. L'icona compare sul pulsante di salvataggio, sul badge del veicolo corrente, nella pagina garage e nel verificatore della pagina prodotto. - **Layout desktop**: orizzontale (campi su una riga) o verticale (campi impilati). Su mobile il selettore è sempre impilato verticalmente. ## Filtro globale per veicolo (v1.2.0) L'impostazione **Filtra le pagine categoria in base al veicolo selezionato**, attiva per impostazione predefinita, estende la selezione a tutto il negozio: finché un veicolo è attivo, le pagine di categorie, marche e fornitori mostrano solo i prodotti compatibili, con l'ordinamento e la paginazione nativi del tema. Sopra l'elenco compare una barra con il veicolo attivo e due azioni: - **Mostra tutti i prodotti**: mette in pausa il filtro per 30 giorni (o fino alla riattivazione). La barra resta visibile e propone quindi di riattivare il filtro. - **Cambia veicolo**: rimanda al selettore. Se la Navigazione a faccette (ps_facetedsearch) è attiva, il filtro veicolo prende temporaneamente il controllo di queste pagine finché un veicolo è selezionato: paginazione, contatori e ordinamenti restano esatti. I filtri a faccette tornano non appena il cliente mette in pausa il filtro o cancella il veicolo.