Box Builder (Mix & Match): guida completa
Installare, configurare e usare Box Builder su PrestaShop 8 e 9: box a numero di articoli o a peso, slot a passaggi, 5 modelli di prezzo tra cui il prezzo a peso, opzioni regalo, disponibilità, visualizzazione nel catalogo, modifica dal carrello, stock e statistiche.
Presentazione
Box Builder (Mix & Match) (dfboxbuilder) aggiunge una pagina in cui i tuoi clienti compongono la propria box con i prodotti che selezioni. Scelgono gli articoli in una griglia, seguono una barra di avanzamento, vedono aggiornarsi il prezzo della box e il risparmio, poi aggiungono la box al carrello. La box si riempie a numero di articoli o a peso. Ogni box è una riga del carrello con il proprio prezzo; la composizione resta leggibile nel carrello, nell’ordine e in fattura.
Crea tutte le box che ti servono, ognuna con i propri prodotti, regole, modello di prezzo e periodo di vendita. Lo stesso catalogo può alimentare box molto diverse (box aperitivo, box di Natale, scatola di cioccolatini a peso, pacchetto scoperta…).
Compatibilità
- PrestaShop 8.x e 9.x
- PHP da 7.4 a 8.x
- Negozio singolo e multinegozio
- Interfaccia in 5 lingue: FR, EN, ES, DE, IT
- Tema Classic, Hummingbird e temi personalizzati (configuratore in JavaScript nativo, senza jQuery)
- Nessuna dipendenza (né Composer né framework)
Installazione e aggiornamento
- Nel back office apri Moduli > Gestione moduli.
- Clicca su Carica un modulo e seleziona
dfboxbuilder.zip. - Apri la voce Box Builder aggiunta al menu per creare la tua prima box.
Per aggiornare, carica il nuovo ZIP allo stesso modo: gli script di aggiornamento si avviano automaticamente (nuove colonne, nuovi hook, URL semplificati generati dai nomi delle box). Le box esistenti restano a riempimento per numero di articoli.
Al primo salvataggio di una box, il modulo crea un prodotto tecnico che porta la box nel carrello. È nascosto per impostazione predefinita; puoi mostrarlo nelle tue categorie (vedi Visualizzazione nel catalogo). La sua scheda prodotto reindirizza sempre al configuratore. Eliminando una box si elimina anche questo prodotto.
Impostazioni del modulo
Il pannello delle impostazioni, sopra l’elenco delle box, contiene tre opzioni:
- Mostra le box in home page: blocco sull’hook
displayHome. - Colore di accento: colore della barra di avanzamento, delle schede dei passaggi e degli elementi evidenziati. Indica il colore principale del tuo tema (ad esempio
#8a5a2b); lascia vuoto per il blu predefinito. Il colore del testo sopra viene scelto automaticamente per restare leggibile. - Dopo l’aggiunta di una box al carrello: andare alla pagina del carrello (predefinito) o rimanere nel configuratore. Rimanendo, il blocco carrello del tema si aggiorna e apre la sua finestra di conferma; poi il cliente può comporre un’altra box.
Nell’elenco delle box, il menu di ogni riga propone Apri la pagina del configuratore e Duplica. La copia riprende prezzi, tariffe decrescenti, slot, fonti, modelli, vincoli e gruppi; viene creata inattiva. Per una box a peso, le colonne Min e Max mostrano i pesi.
Creare una box
Il modulo di una box è organizzato in sei schede.
Generale
- Nome, descrizione, testo del pulsante: per lingua.
- URL semplificato: per lingua, generato dal nome se lasciato vuoto. Con gli URL semplificati di PrestaShop attivi, la pagina della box ha l’indirizzo
/box/ID-url-semplificato. - Riempire la box per: Numero di articoli (predefinito) o Peso (vedi Box a peso).
- Articoli min / max (riempimento a numero di articoli): limiti della composizione (0 = nessun massimo).
- Peso minimo / massimo (riempimento a peso): nell’unità di peso del negozio; 0 = nessun massimo, lo stesso valore per un peso esatto.
- Consentire lo stesso articolo più volte e unità massime per articolo.
- Nascondere i prodotti esauriti: altrimenti restano visibili ma non si possono aggiungere.
- Attiva “Sorprendimi”, attiva salvataggio e condivisione, attiva.
Disponibilità
- Disponibile dal / fino al: periodo di vendita. Prima della data di inizio, la pagina della box mostra “Questa box sarà disponibile dal …”; dopo la data di fine, la box viene rimossa dai carrelli che la contengono ancora.
- Stock limitato (box): numero massimo di box vendute, sommando tutti i negozi, ordini annullati esclusi (0 = illimitato). Il modulo mostra quante ne sono state vendute e quante restano; la pagina della box mostra “Edizione limitata: ne restano N”.
- Mostra nel catalogo: da nessuna parte (predefinito), categorie e ricerca, solo categorie o solo ricerca, con le categorie in cui inserire la box.
- Gruppi di clienti: nessun gruppo selezionato = tutti. Altrimenti solo i gruppi selezionati vedono e ordinano la box.
- Suggerisci la box nelle schede prodotto: aggiunge “Componi una box con questo prodotto” nella scheda di ogni prodotto contenuto nella box.
Prezzi
Tutti i prezzi si inseriscono IVA esclusa, nella valuta predefinita. La box ha una propria regola fiscale, applicata nel carrello in base all’indirizzo del cliente.
- Prezzo fisso: un prezzo unico, qualunque sia il contenuto.
- Scaglioni di quantità: il prezzo dipende dal numero di articoli (es. da 3 articoli: 25 €, da 6: 45 €). Il cliente vede “Aggiungi ancora 2 articolo/i e la tua box scende a …”.
- Somma dei prodotti con sconto: somma dei prezzi degli articoli meno una percentuale. I prezzi degli articoli vengono allora mostrati nella griglia.
- Prezzo per slot: ogni slot ha un prezzo per articolo (richiede gli slot).
- Prezzo a peso: peso totale degli articoli per un prezzo per unità di peso (al kg se il negozio usa i kg). Le tariffe decrescenti facoltative cambiano questo prezzo a partire da un peso della box, e l’intera box passa alla nuova tariffa: con 30 € al kg e 26 € al kg da 1 kg, una box di 1,05 kg costa 27,30 €. Il cliente vede il prezzo al chilo attuale e “Aggiungi ancora 100 g e il prezzo scende a 26,00 € / kg”. Questo modello funziona anche con le box a numero di articoli.
Mostra il risparmio confronta il prezzo della box con quello degli articoli acquistati singolarmente, ai prezzi attuali del catalogo: “Invece di 34,00 €: risparmi 5,20 € (-15%)”.
Premi al completamento: prodotto in omaggio e/o spedizione gratuita, concessi da una regola carrello con codice segreto, monouso, valida solo finché la box è nel carrello. L’etichetta del premio è mostrata nel configuratore.
Opzioni regalo:
- Messaggio regalo con lunghezza massima (da 1 a 500 caratteri). Il messaggio compare nell’ordine nel back office e in fattura.
- Confezione regalo con il suo prezzo IVA esclusa (0 = gratuita), aggiunto al prezzo della box.
Composizione
I prodotti selezionabili provengono da prodotti aggiunti uno per uno (ricerca per nome, riferimento o ID) o da categorie intere. Ogni combinazione di un prodotto diventa un articolo selezionabile, con il proprio stock, prezzo e peso.
Usa gli slot dà una struttura alla box, ad esempio “2 salati + 1 dolce”. Ogni slot ha un nome per lingua, un minimo, un massimo, un prezzo per articolo (modello per slot) e fonti proprie. Nel negozio gli slot diventano passaggi numerati.
Modelli
Box precomposte che il cliente applica con un clic e poi modifica. I prodotti di un modello devono essere selezionabili anche nella box.
Vincoli
Coppie di prodotti che non possono stare nella stessa box. Il configuratore impedisce la combinazione e il server la rifiuta.
Box a peso
Per una scatola di cioccolatini, un assortimento di tè o una box di prodotti sfusi, il cliente riempie la box fino a un peso invece di contare gli articoli.
- Scheda Generale: Riempire la box per = Peso, poi un peso minimo e/o massimo. Esempio: 1 e 1,2 per una box da 1 a 1,2 kg; 1 e 1 per esattamente 1 kg. Almeno uno dei due è obbligatorio.
- Scheda Prezzi: funzionano tutti i modelli di prezzo. Prezzo a peso vende la box al chilo, con tariffe decrescenti se serve; un prezzo fisso va bene per una box venduta a 35 € qualunque sia l’assortimento.
- Controlla il peso dei prodotti: scheda prodotto, scheda Spedizione, e impatto sul peso di ogni combinazione.
- Peso di un articolo: peso del prodotto + impatto della combinazione, lo stesso valore che PrestaShop usa per la spedizione.
- Prodotti senza peso: non sono proposti in una box a peso né in una box con prezzo a peso, e il blocco delle schede prodotto non suggerisce la box nella loro pagina. Il modulo della box mostra quanti prodotti selezionabili sono interessati.
- Configuratore: peso su ogni scheda, nel riepilogo e nell’anteprima rapida; contatore e barra di avanzamento in g / kg (“800 g / 1,2 kg”, minimo segnato); un articolo che supererebbe il massimo viene disattivato con “Supera il peso rimanente”; finché il minimo non è raggiunto, il cliente vede “Aggiungi ancora 200 g per completare la tua box”.
- Regole sugli articoli: in modalità peso, gli articoli min / max della box non si applicano; slot, duplicati, unità massime per articolo e incompatibilità restano attivi.
- Sorprendimi riempie la box nell’intervallo di peso.
- Carrello, ordine e fattura: il peso totale è indicato con la composizione.
- Visualizzazione dei pesi: in grammi sotto 1 kg, in chili oltre, con il separatore decimale della lingua del visitatore.
Nel negozio
Il configuratore
- Passaggi: con gli slot, schede numerate mostrano l’avanzamento (“Salato 2/3”). Quando un passaggio è pieno, il configuratore passa al successivo; un pulsante “Avanti” compare appena un passaggio è completo.
- Griglia: oltre 8 prodotti compaiono un campo di ricerca (accenti ignorati), un filtro per categoria e l’ordinamento per nome o prezzo. Un clic sull’immagine o sul nome apre l’anteprima rapida (immagine, descrizione, link alla scheda, pulsante Aggiungi). Gli articoli scelti hanno un pulsante “-“.
- Riepilogo: contatore con la regola (min. 5, max. 6, o in peso per una box a peso), barra di avanzamento con il minimo segnato, anteprima visiva della box (una casella per articolo), prezzo, risparmio, premio da sbloccare e opzioni regalo. Ciò che manca è indicato in blu (“Aggiungi ancora 2 articolo/i…”); il rosso è riservato ai blocchi reali.
- Mobile: griglia a due colonne, modelli e passaggi a scorrimento orizzontale, barra fissa con numero di articoli (o peso) e prezzo, che diventa “Aggiungi al carrello” quando la box è valida.
- Sorprendimi riempie la box a caso nel rispetto delle regole; Salva e condividi genera un link che ricarica la composizione.
Il prezzo è sempre ricalcolato dal server a partire dal catalogo; una composizione inviata dal browser viene ricontrollata (prodotti, combinazioni, slot, peso, stock) prima di essere aggiunta al carrello.
Modificare una box dal carrello
Nel carrello e nel checkout, la composizione della box è seguita da un link Modifica questa box. Riapre il configuratore con composizione e opzioni regalo; il pulsante diventa “Aggiorna la mia box”. Alla conferma, la box viene sostituita nello stesso punto con la stessa quantità. Nel tema Classic, composizione e link si trovano nella finestra di personalizzazione della riga del carrello.
Visualizzazione e acquisizione
- Pagina della box: link “Apri la pagina del configuratore” nel modulo e nell’elenco. Indirizzo
/box/ID-url-semplificatocon gli URL semplificati, tag canonical, selettore di lingua verso l’URL della lingua scelta. - Home page: blocco con le box disponibili (impostazione del modulo).
- Widget: il blocco può essere agganciato a qualsiasi hook di visualizzazione (Aspetto > Posizioni) o inserito in un template:
{widget name='dfboxbuilder'},{widget name='dfboxbuilder' id_dfbox=3}o{widget name='dfboxbuilder' title='Le nostre box'}. - Schede prodotto: blocco “Componi una box con questo prodotto” (fino a 3 box), che apre il configuratore con il prodotto già aggiunto.
- Catalogo: con “Mostra nel catalogo”, la box compare nelle categorie scelte e/o nella ricerca. Il prezzo mostrato è il prezzo “da” (composizione valida più economica, con IVA e sconto di gruppo; per una box a peso, al peso minimo o alla tariffa decrescente più conveniente); una box a prezzo fisso mostra il suo prezzo. Il link porta al configuratore e non c’è il pulsante di aggiunta al carrello.
Il filtro prezzo della navigazione a faccette e l’ordinamento per prezzo usano il prezzo salvato del prodotto tecnico, che è 0: una box visibile compare per prima nell’ordinamento per prezzo crescente.
Nei blocchi compaiono solo le box attive, nel periodo di vendita, non esaurite e consentite al gruppo del visitatore. Disattivando una box si disattiva anche il suo prodotto tecnico, che sparisce dagli elenchi.
Carrello, ordini e stock
- Prezzo per riga: il prezzo della box è salvato sulla sua riga del carrello; due box con composizioni diverse mantengono ciascuna il proprio prezzo. Gli sconti per gruppo di clienti si applicano; le regole di prezzo del catalogo e gli sconti per quantità non si applicano alle box.
- Stock dei componenti: controllato all’aggiunta su tutto il carrello (altre box e prodotti acquistati da soli). Se il cliente aumenta la quantità di una box oltre lo stock, viene riportata al massimo possibile nella pagina del carrello, con un messaggio.
- Ordini: lo stock di ogni componente viene scalato alla convalida dell’ordine, restituito se l’ordine passa ad annullato o errore di pagamento, e scalato di nuovo se viene riattivato. Un ordine creato direttamente in errore non scala lo stock.
- Box non disponibili: una box eliminata, disattivata, terminata, non ancora iniziata o riservata a un altro gruppo viene rimossa dal carrello nelle pagine carrello e ordine, anche dopo “Ordina di nuovo”.
- Back office e fattura: composizione (per slot), confezione, messaggio regalo e, per una box a peso, il peso totale compaiono nell’ordine e in fattura.
Statistiche
Il pulsante delle statistiche nell’elenco apre una dashboard con selettore del periodo (7, 30, 90 o 365 giorni):
- box ordinate, fatturato IVA esclusa, media di articoli per box, conversione (ordini / visite);
- per box: visite al configuratore, aggiunte al carrello, ordini, box, tasso di aggiunta, conversione, fatturato e prezzo medio;
- articoli più scelti e combinazioni più ordinate.
Visite e aggiunte sono conteggiate dalla versione 1.2.0, robot esclusi; gli ordini annullati sono esclusi.
Tracciamento Google Analytics 4
Dopo l’aggiunta di una box, il configuratore invia un evento add_to_cart a window.dataLayer (se è presente Google Tag Manager o gtag.js) con currency, value e l’articolo dfbox-ID. Viene inoltre emesso un evento dfbox:added su document con gli stessi dati, per altri strumenti.
FAQ e risoluzione dei problemi
I pulsanti non rispondono o la pagina resta vuota
Svuota la cache di PrestaShop (Parametri avanzati > Prestazioni) e, durante i test, disattiva l’unione dei file JS/CSS. Verifica che la box sia attiva, associata al negozio e con almeno una fonte di prodotti.
La griglia è vuota
Le fonti devono contenere prodotti attivi e ordinabili nel negozio corrente. Se è attivo l’occultamento dei prodotti esauriti, i prodotti senza stock non compaiono. In una box a peso o con prezzo a peso non compaiono nemmeno i prodotti senza peso.
Un prodotto non compare in una box a peso
Non ha un peso. Inseriscilo nella scheda prodotto, scheda Spedizione, o nell’impatto sul peso delle sue combinazioni. L’avviso in cima al modulo della box indica quanti prodotti selezionabili sono interessati.
Una box visibile in una categoria mostra 0,00 €
Aggiorna il modulo alla versione 1.2.1 o successiva: gli elenchi mostrano allora il prezzo “da”.
La box non compare per un cliente
Controlla date di vendita, stock limitato e gruppi di clienti nella scheda Disponibilità.
Il link “Modifica questa box” non compare
È mostrato solo nel carrello e nel checkout, per una box ancora disponibile. Nel tema Classic, apri la finestra di personalizzazione della riga.
Lo stock dei componenti non diminuisce
Viene scalato alla convalida dell’ordine, non all’aggiunta al carrello, e solo se la gestione delle scorte è attiva. Un ordine annullato restituisce lo stock.