Modulo di Consegna per Articoli Pesanti — Guida all’installazione e configurazione
Installare e configurare il modulo di consegna per articoli pesanti: attivazione, costruttore di campi, campi condizionali, notifica e monitoraggio degli ordini.
Il modulo Modulo di Consegna per Articoli Pesanti e Voluminosi mostra, allo step del corriere del checkout, un questionario sulle condizioni di accesso (piano, ascensore, scale, passaggi stretti, ostacoli) per i prodotti pesanti o voluminosi: mobili, elettrodomestici, TV di grandi dimensioni, arredi professionali o medicali. I campi sono interamente configurabili nel back office, senza scrivere una sola riga di codice.
Questo modulo è sviluppato per PrestaShop 8.0 a 9.x, funziona in multinegozio ed è completamente multilingua. Non usa alcuna dipendenza esterna: JavaScript vanilla, niente jQuery, niente Composer.
Installazione
- Nel back office, aprite Moduli > Gestore moduli e cliccate su Carica un modulo.
- Selezionate il file
dfdeliveryform.zipe avviate l’installazione. - Al termine dell’installazione, cliccate su Configura per aprire le impostazioni.
All’installazione, il modulo crea automaticamente le sue tabelle, registra i suoi hook e preinstalla un set di 17 campi pronti all’uso (orari di presenza, accesso camion pesante, distanza di parcheggio, piano, ascensore, scale, passaggi stretti, ostacoli, conferma di esattezza). Teneteli, adattateli o ripartite da zero.
Impostazioni generali
La pagina di configurazione ha due zone: le impostazioni (in alto) e il costruttore di campi (in basso).
- Attiva il modulo — mostra o nasconde il modulo nel negozio.
- Blocca il checkout finché non è completato — se attivo, il cliente non può confermare lo step di consegna prima di aver inviato il modulo. Se disattivato, il modulo resta facoltativo.
- Modalità di attivazione — determina quando il modulo viene mostrato (vedi la sezione seguente).
- Email di notifica — indirizzo che riceve il modulo compilato alla convalida dell’ordine. Lasciate vuoto per usare l’email del negozio.
- Titolo del modulo e Testo introduttivo — personalizzabili per lingua.
Modalità di attivazione
Il modulo deve apparire solo per gli ordini che lo richiedono. Sono disponibili quattro modalità:
- Tutti gli ordini — il modulo viene sempre mostrato.
- Soglia di peso del prodotto — il modulo appare non appena un prodotto del carrello raggiunge il peso definito (30 kg di default). Ideale per elettrodomestici e mobili. Il peso usato è il peso unitario del prodotto indicato nella sua scheda.
- Prodotti specifici — inserite un elenco di ID prodotti separati da virgole (es.
12,45,102). - Categorie specifiche — inserite un elenco di ID categorie separati da virgole. Qualsiasi prodotto appartenente a una di queste categorie attiva il modulo.
Il modulo mostra al cliente quali prodotti del carrello sono interessati, così capisce perché gli vengono poste queste domande.
Costruttore di campi
Il costruttore, situato sotto le impostazioni, elenca tutti i campi del modulo. Per ogni campo potete riordinarlo (frecce su/giù), attivarlo/disattivarlo, modificarlo o eliminarlo.
Aggiungere o modificare un campo
Cliccate su Aggiungi un campo o sull’icona matita di un campo esistente. L’editor offre:
- Tipo — 7 tipi disponibili: titolo di sezione, testo, numero, testo lungo, interruttore, Sì/No, elenco a discesa.
- Etichetta e testo di aiuto — inseriti per lingua. L’etichetta nella lingua predefinita è obbligatoria; le lingue lasciate vuote riprendono tale etichetta.
- Opzioni (solo tipo elenco a discesa) — un’opzione per riga, in modo indipendente per ogni lingua.
- Mostra solo se — condizione di visualizzazione (vedi sotto).
- Obbligatorio e Attivo.
Il codice tecnico di un campo viene generato automaticamente dall’etichetta al momento della creazione e resta stabile in seguito, anche se rinominate l’etichetta.
Tipi di campi
- Titolo di sezione — separatore visivo, senza inserimento.
- Testo — campo di inserimento su una riga.
- Numero — inserimento numerico (distanza, larghezza, numero di gradini…).
- Testo lungo — area di testo multiriga per le descrizioni.
- Interruttore — interruttore sì/no stilizzato, ideale per una conferma.
- Sì / No — due pillole esclusive, spesso usate come padre di un campo condizionale.
- Elenco a discesa — scelta tra opzioni definite per lingua.
Campi condizionali
Un campo può essere mostrato solo in base alla risposta a un campo padre di tipo Sì/No o interruttore.
- Nell’editor del campo figlio, aprite l’elenco Mostra solo se e scegliete il campo padre.
- Selezionate il valore atteso: = Sì / spuntato o = No / non spuntato.
Esempio: il campo «Larghezza della porta dell’ascensore» appare solo se la domanda «Ascensore / montacarichi» è attivata; il campo «Numero di gradini» appare solo se «Scale» è attivato. Un campo nascosto dalla sua condizione non è mai obbligatorio, anche se contrassegnato come obbligatorio.
Lato cliente
Allo step del corriere, il cliente vede una scheda che mostra lo stato del modulo (Da completare / Completato) e un pulsante per aprirlo. Il modulo si apre in una finestra moderna: schede di scelta, interruttori, pillole Sì/No, validazione in tempo reale dei campi obbligatori.
- Le risposte sono salvate per carrello: un cliente che ritorna trova le sue risposte precompilate.
- In modalità bloccante, il pulsante di conferma dello step di consegna riapre automaticamente il modulo finché non è completato.
Monitoraggio delle risposte
Le risposte del cliente sono consultabili in tre punti:
- Email di notifica — alla convalida dell’ordine, viene inviata un’email HTML con il riepilogo di tutte le risposte all’indirizzo configurato (team logistico, corriere o magazzino). Sono inclusi i template FR ed EN.
- Scheda ordine — un pannello dedicato mostra il riepilogo domanda/risposta nell’ordine, nel back office.
- Database — le risposte vengono memorizzate, collegate al carrello e poi all’ordine convalidato.
Disinstallazione
La disinstallazione dal Gestore moduli rimuove in modo pulito le tabelle del modulo (campi, risposte) e la sua configurazione.
Domande frequenti
Il modulo non viene mostrato
Verificate che il modulo sia attivato, che la modalità di attivazione corrisponda al carrello di prova (per esempio, che un prodotto raggiunga realmente la soglia di peso) e che almeno un campo sia attivo.
Posso tradurre le diciture?
Sì. Ogni etichetta, testo di aiuto e opzione di elenco si inserisce per lingua direttamente nel costruttore di campi. Il titolo e l’introduzione del modulo sono anch’essi multilingua.
Il modulo è compatibile con PrestaShop 9 e multinegozio?
Sì, il modulo è sviluppato per PrestaShop 8.0 a 9.x e funziona in contesto multinegozio.