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 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.

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.

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.

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.