# Assistente alla Scelta Prodotto — Documentazione > Il modulo Assistente alla Scelta Prodotto (dffinder) trasforma un catalogo complesso in un percorso d'acquisto guidato. Costruisci un albero di domande nel back office; il visitatore risponde passo dopo passo… - Pagina: - Lingua: it - Aggiornato il: 2026-07-15 - Altre lingue: [fr](https://www.datafirefly.com/documentation/product-finder/index.md), [en](https://www.datafirefly.com/en/documentation/product-finder/index.md), [es](https://www.datafirefly.com/es/documentation/product-finder/index.md), [de](https://www.datafirefly.com/de/documentation/product-finder/index.md), [pl](https://www.datafirefly.com/pl/documentation/asystent-wyboru-produktu-prestashop/index.md), [nl](https://www.datafirefly.com/nl/documentation/product-finder/index.md), [pt](https://www.datafirefly.com/pt/documentation/product-finder/index.md) - Indice: Il modulo **Assistente alla Scelta Prodotto** (`dffinder`) trasforma un catalogo complesso in un percorso d'acquisto guidato. Costruisci un albero di domande nel back office; il visitatore risponde passo dopo passo e arriva a una selezione di prodotti filtrata, proprio come farebbe un venditore in negozio. ## Panoramica Il modulo si rivolge ai cataloghi in cui il cliente esita: materassi, biciclette, informatica, cosmetici, ricambi. Ogni risposta del questionario è collegata a uno o più criteri del tuo catalogo (attributi, caratteristiche, categorie, produttori, fasce di prezzo), e il modulo traduce le scelte del visitatore in una ricerca prodotti nativa. - Builder dell'albero di domande drag-and-drop, senza codice. - Domande a scelta singola o multipla, titoli ed etichette multilingua. - Contatore di prodotti corrispondenti in tempo reale a ogni passo. - Pagina dei risultati nativa (ordinamento e paginazione del tema) tramite `ProductSearchProviderInterface`. - Visualizzazione come widget in home, tag widget o pagina dedicata. - Compatibile con PrestaShop 8.0 fino a 9.x, multinegozio e multilingua. ## Installazione 1. Vai su _Moduli > Gestore dei moduli > Carica un modulo_. 2. Seleziona l'archivio `dffinder-1.0.0.zip` e conferma l'installazione. 3. Il modulo crea le sue tabelle, una scheda di amministrazione **DF Product Finder** e le rotte riscritte `product-finder` e `product-finder/results`. Dopo l'installazione, se gli URL `product-finder` non rispondono, rigenera i link: _Parametri avanzati > Prestazioni > Svuota la cache_, e verifica che gli URL semplificati siano attivi in _Traffico & SEO_. ## Crea il tuo primo finder Apri _Moduli > DF Product Finder_ e clicca su **Aggiungi un finder**. Dagli un nome interno e un testo di introduzione mostrato in cima al questionario. Il builder è organizzato in colonne: le domande a sinistra, le risposte di ogni domanda e le mappature di ogni risposta. ### Aggiungere domande Clicca su **Aggiungi una domanda**. Per ogni domanda, imposta: - il **titolo** (es. « Per quale uso? ») e un **testo di aiuto** facoltativo; - il **tipo di visualizzazione**: scelta singola (una sola risposta, con avanzamento automatico) o scelta multipla (più risposte selezionabili); - l'ordine, trascinando la domanda nella posizione desiderata. ### Aggiungere risposte Sotto ogni domanda, aggiungi le risposte proposte al visitatore (es. « Sport », « Città », « Bambino »). Ogni risposta ha un'etichetta multilingua e si può riordinare per trascinamento all'interno della sua domanda. ### Mappare le risposte al catalogo È il cuore del modulo: ogni risposta punta a uno o più criteri di prodotto. I tipi di mappatura disponibili sono: - **Attributo** — un valore di attributo di combinazione (taglia, colore…), confrontato con le combinazioni prodotto; - **Caratteristica** — un valore di caratteristica prodotto; - **Categoria** — l'appartenenza a una categoria; - **Produttore** — il marchio del prodotto; - **Prezzo** — una fascia `min`/`max` sul prezzo base del negozio. I campi attributo, caratteristica, categoria e produttore dispongono del completamento automatico: digita qualche lettera per trovare il valore. Una stessa risposta può combinare più mappature (per esempio una categoria _e_ una fascia di prezzo). Le fasce di prezzo filtrano sul **prezzo base tasse escluse** del prodotto per il negozio corrente (`product_shop.price`). Le tasse e i prezzi specifici (promozioni, prezzi per gruppo) non vengono applicati in questo filtro. Quando il tuo albero è pronto, clicca su **Salva**. Il salvataggio è idempotente: l'intero albero viene ricostruito a ogni salvataggio, il che garantisce uno stato coerente. ## Capire il motore di matching Il modulo combina le scelte del visitatore con due semplici regole: - **OR** tra le risposte di una stessa domanda: selezionare « Sport » e « Città » amplia la selezione ai prodotti che corrispondono all'una o all'altra. - **AND** tra le domande: i criteri di ogni domanda completata si sommano per restringere la selezione. A ogni passo, il modulo ricalcola via AJAX il numero di prodotti corrispondenti e lo mostra al visitatore, evitando di arrivare a una selezione vuota. ## Mostrare il finder ### Widget in home Attiva la visualizzazione in home page dalla configurazione del modulo. Il widget mostra una card di invito all'azione che porta al questionario. ### Tag widget Per inserire il finder ovunque in un template del tuo tema, usa il tag Smarty: ``` {widget name='dffinder' id_finder=1} ``` Sostituisci `id_finder` con l'identificatore del finder desiderato (visibile nella lista del back office). ### URL dedicati Il questionario è accessibile anche direttamente tramite URL puliti, comodi per le tue campagne: - `tuo-negozio/product-finder` — il questionario; - `tuo-negozio/product-finder/results?answers=1,4,9` — la pagina dei risultati. ## La pagina dei risultati Al termine del questionario, il visitatore viene indirizzato a una pagina dei risultati che estende il controller di listing nativo di PrestaShop. In concreto, ottieni senza configurazione aggiuntiva: - il template della lista prodotti del tuo tema; - l'ordinamento per data, prezzo o nome; - la paginazione standard. Un link **Ricomincia** permette al visitatore di riavviare il questionario dall'inizio. ## Multinegozio e multilingua Il modulo è legato al contesto negozio: ogni finder appartiene al o ai negozi che scegli. Tutti i testi (nome, introduzione, titoli delle domande, etichette delle risposte) sono inseribili per lingua grazie al selettore della lingua di modifica in cima al builder. ## Risoluzione dei problemi **Il contatore mostra sempre zero.** Verifica che le mappature puntino a valori realmente usati dai tuoi prodotti (attributo/caratteristica correttamente assegnato ai prodotti) e che i prodotti siano attivi e associati al negozio corrente. **La fascia di prezzo non filtra come previsto.** Ricorda che il filtro si applica al prezzo base tasse escluse, senza prezzi specifici. Un prodotto in promozione viene comunque filtrato sul suo prezzo di listino. **Buona pratica.** Inizia con una domanda generale (uso, profilo) poi affina (budget, taglia). Limita ogni domanda a poche risposte chiare per mantenere un percorso fluido.