# dfbundlevisual — Spesso comprati insieme > Panoramica dfbundlevisual mostra sulla scheda prodotto un blocco « Spesso comprati insieme » in stile Amazon: schede prodotto selezionabili separate da segni « + », un prezzo totale ricalcolato in… - Pagina: - Lingua: it - Aggiornato il: 2026-07-16 - Altre lingue: [fr](https://www.datafirefly.com/documentation/dfbundlevisual/index.md), [en](https://www.datafirefly.com/en/documentation/dfbundlevisual/index.md), [es](https://www.datafirefly.com/es/documentation/dfbundlevisual/index.md), [de](https://www.datafirefly.com/de/documentation/dfbundlevisual/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfbundlevisual/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfbundlevisual/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfbundlevisual/index.md) - Indice: ## Panoramica dfbundlevisual mostra sulla scheda prodotto un blocco « Spesso comprati insieme » in stile Amazon: schede prodotto selezionabili separate da segni « + », un prezzo totale ricalcolato in tempo reale e un unico pulsante per aggiungere la selezione al carrello. Uno sconto bundle (percentuale o importo fisso IVA inclusa) viene applicato automaticamente quando il bundle completo è nel carrello. Senza bundle manuale, il modulo può suggerire i prodotti realmente acquistati insieme in base allo storico degli ordini. ## Installazione 1. Nel back-office, apri **Moduli > Gestione moduli > Carica un modulo**. 2. Carica il file `dfbundlevisual.zip` e clicca su **Installa**. 3. Il modulo crea le sue tabelle, la scheda **Catalogo > Bundle visivi** e si registra sugli hook necessari. Compatibile con PrestaShop 8.0 a 9.x, negozio singolo e multinegozio. Nessuna dipendenza: né Composer, né framework, né jQuery. ## Configurazione Apri la pagina di configurazione del modulo (**Moduli > Gestione moduli > dfbundlevisual > Configura**): - **Attiva il modulo**: interruttore generale del blocco front. - **Hook di visualizzazione**: `displayFooterProduct` (piè di scheda prodotto, consigliato) o `displayProductAdditionalInfo` (sotto il pulsante di acquisto, a seconda del tema). - **Titolo del blocco**: personalizzabile per lingua. Predefinito in italiano: « Spesso comprati insieme ». - **Attiva suggerimenti automatici**: mostra suggerimenti per co-acquisto quando non esiste un bundle manuale per il prodotto visualizzato. - **Max suggerimenti automatici**: numero di prodotti complementari proposti (2 per impostazione predefinita). - **Co-acquisti minimi**: numero minimo di ordini contenenti entrambi i prodotti perché appaia un suggerimento (2 per impostazione predefinita). - **Finestra storico ordini (giorni)**: periodo analizzato per la co-occorrenza (365 per impostazione predefinita). ## Creare un bundle 1. Apri **Catalogo > Bundle visivi** e clicca su **Aggiungi**. 2. **Nome del bundle**: nome interno, utilizzato anche come etichetta dello sconto nel carrello. 3. **Prodotto principale**: cerca per nome, riferimento o ID. Il blocco sarà mostrato sulla scheda di questo prodotto. 4. **Prodotti del bundle**: aggiungi uno o più prodotti complementari tramite la ricerca con autocompletamento. 5. **Tipo e valore dello sconto**: nessuno sconto, percentuale (max 100) o importo fisso IVA inclusa. 6. Attiva il bundle e salva. Un bundle per prodotto principale e per negozio: il blocco resta leggibile con un messaggio commerciale unico. In multinegozio, ogni negozio può avere il proprio bundle per lo stesso prodotto. ## Funzionamento dello sconto Lo sconto viene applicato tramite una **regola carrello dinamica** creata al volo per ogni carrello (codice `DFBV-{id_bundle}-{id_carrello}`) e **limitata ai soli prodotti del bundle**: - Viene creata solo se il bundle completo è presente nel carrello — verifica effettuata lato server. - Uno sconto percentuale si applica solo ai prodotti del bundle, mai al resto del carrello. - Se il cliente rimuove un prodotto del bundle, lo sconto viene eliminato automaticamente. - Alla convalida dell'ordine, la regola viene disattivata per non essere riutilizzata. - Alla disinstallazione del modulo, tutte le regole generate vengono eliminate. Lo sconto percentuale si somma agli eventuali prezzi specifici: il calcolo parte dal prezzo mostrato al cliente. Verifica i tuoi margini se combini promozioni di catalogo e sconto bundle. ## Suggerimenti automatici Quando non esiste un bundle manuale attivo per il prodotto visualizzato e l'opzione è attivata, il modulo analizza la co-occorrenza dei prodotti negli **ordini validi** nella finestra configurata e mostra le combinazioni più frequenti che rispettano la soglia di co-acquisti. I prodotti esauriti sono esclusi. Il risultato è memorizzato in cache per preservare le prestazioni. Nessuno sconto viene applicato ai suggerimenti automatici: gli sconti sono riservati ai bundle manuali. ## Statistiche L'elenco **Catalogo > Bundle visivi** mostra per ogni bundle le sue **visualizzazioni** (visualizzazioni del blocco) e le sue **conversioni** (aggiunte complete al carrello). I suggerimenti automatici sono conteggiati globalmente. Usa questi numeri per ottimizzare composizioni e sconti. ## Risoluzione dei problemi - **Il blocco non appare**: verifica che il modulo sia attivato, che esista un bundle attivo per il prodotto (o che i suggerimenti automatici siano attivati con uno storico sufficiente) e che l'hook scelto sia presente nel tuo tema. - **Lo sconto non compare**: viene creato solo quando tutti i prodotti del bundle sono nel carrello. Verifica anche che il tipo di sconto non sia « Nessuno sconto ». - **Nessun suggerimento automatico**: abbassa la soglia minima di co-acquisti o allarga la finestra dello storico; servono ordini validi contenenti i prodotti insieme. - **Prodotti con combinazioni**: all'aggiunta al carrello viene utilizzata la combinazione predefinita, con controllo dello stock.