DataFirefly Pack Variants: documentazione

Cosa fa il modulo

In PrestaShop, un pack nativo obbliga a scegliere una combinazione precisa per ciascuno dei suoi prodotti, dalla scheda Pack del back office. La coppia prodotto e combinazione viene scritta nel database e il cliente non ha modo di cambiarla. Vendere un pack con una t-shirt in quattro taglie obbliga quindi a creare quattro pack.

DataFirefly Pack Variants aggiunge un selettore sulla scheda del pack. Per ogni prodotto reso configurabile, il cliente sceglie la sua combinazione. La selezione viene convalidata lato server, salvata con la riga di carrello, riportata fino alla fattura, e la giacenza scaricata è quella della combinazione realmente scelta.

Installazione

1. Nel back office apri Moduli > Gestore dei moduli, clicca su Carica un modulo e invia lo ZIP.
2. Il modulo crea le sue tabelle e aggiunge una scheda Combinazioni dei pack sotto Catalogo.
3. Apri la configurazione del modulo per impostare il titolo del blocco, la sua posizione e il comportamento dell’elenco nativo.

Il modulo si installa su PrestaShop dalla 8.0 alla 8.x. Non richiede alcuna dipendenza Composer né la sovrascrittura di template del tema.

Configurare un pack

Vai su Catalogo > Combinazioni dei pack. Il campo di ricerca in alto elenca solo i prodotti contrassegnati come pack: digita un nome, un riferimento o un identificativo, poi seleziona il pack. I pack già configurati compaiono subito sotto.

La schermata di modifica mostra ogni prodotto del pack, con la sua quantità, la sua combinazione dichiarata e la sua miniatura. I prodotti senza combinazioni vengono segnalati e non offrono impostazioni.

Le tre modalità

• Combinazione fissa: comportamento nativo, nessuna scelta lato cliente. È la modalità predefinita.
• Il cliente sceglie qualsiasi combinazione: vengono proposte tutte le combinazioni del prodotto.
• Il cliente sceglie tra le combinazioni selezionate: spunti le combinazioni consentite nell’elenco. Ne servono almeno due, altrimenti il salvataggio viene rifiutato.

Limitare la scelta a un gruppo di attributi

Un prodotto con Taglia e Colore genera in fretta decine di combinazioni. La restrizione a un gruppo di attributi risolve il caso più frequente: scegli Taglia e gli altri attributi restano fermi sui valori della combinazione dichiarata nel back office. Il cliente vede solo un elenco di taglie, il colore resta quello che hai definito per il pack.

Importazione in blocco

Se il tuo catalogo conta già decine di pack, il pannello Importazione in blocco della pagina iniziale del modulo applica la stessa regola a tutti. Scegli:

• Pack da elaborare: solo quelli non ancora configurati, oppure tutti i pack sovrascrivendo le impostazioni esistenti.
• Solo pack attivi: per ignorare i pack disattivati.
• Configurazione da applicare: scelta libera su tutti i prodotti, oppure ripristino sulle combinazioni fisse native.
• Restrizione a un gruppo di attributi: Taglia per esempio, applicata ovunque il gruppo esista.
• Prodotti senza quel gruppo: lasciarli fissi oppure proporre tutte le loro combinazioni.

Il pulsante Anteprima conta i pack coinvolti e simula il primo lotto senza scrivere nulla. Il pulsante Avvia l’importazione elabora poi il catalogo a lotti di 25, con barra di avanzamento. La paginazione usa un cursore sull’identificativo prodotto, evitando gli slittamenti quando la scrittura cambia il perimetro in corsa e i timeout sui cataloghi grandi.

Impostazioni generali

Nella configurazione del modulo:

• Titolo del blocco: la dicitura mostrata sopra i selettori, traducibile per lingua.
• Posizione del blocco: sotto le informazioni del prodotto tramite l’hook nativo, oppure appena sopra il pulsante di aggiunta al carrello tramite uno spostamento JavaScript.
• Nascondi l’elenco nativo del pack: attivo per impostazione predefinita. Il modulo mostra da solo tutto il contenuto del pack e mantenere l’elenco nativo mostrerebbe le combinazioni dichiarate, in contraddizione con la scelta del cliente.
• Selettore CSS dell’elenco nativo: .product-pack per Classic e Hummingbird. Da modificare solo se il tuo tema mostra il contenuto del pack altrove.
• Mostra i prezzi dei prodotti: il prezzo unitario di ogni prodotto del pack.
• Nascondi le combinazioni esaurite: se disattivato, restano selezionabili quando il prodotto consente l’ordine in esaurimento.
• Nascondi il campo di personalizzazione nativo: da lasciare attivo, vedi la sezione seguente.

Cosa vede il cliente

Sulla scheda del pack il modulo mostra una card con tutto il contenuto: un menù a tendina per ogni prodotto configurabile, la combinazione dichiarata in chiaro per gli altri. Ogni riga porta la miniatura, la quantità e, se l’opzione è attiva, il prezzo unitario.

Se il cliente conferma senza aver completato una scelta, sotto il blocco compare un messaggio di errore e l’aggiunta al carrello viene bloccata. Le combinazioni esaurite vengono disattivate o nascoste secondo le tue impostazioni.

Carrello, ordine e fattura

La selezione viene salvata nel meccanismo di personalizzazione nativo di PrestaShop. È questo che permette a due pack identici con composizioni diverse di restare due righe di carrello distinte, mentre il core normalmente unisce le righe con lo stesso prodotto. Un cliente che aggiunge due volte esattamente la stessa composizione vede semplicemente la quantità della riga esistente passare a due.

Il riepilogo della scelta compare automaticamente nel carrello, nella conferma d’ordine, nelle e-mail, nello storico cliente, nel dettaglio ordine del back office e nella fattura PDF.

Giacenze

Un pack nativo scarica la giacenza della combinazione scritta nella tabella dei pack, non di quella scelta dal cliente. Alla convalida dell’ordine il modulo corregge: la combinazione dichiarata viene riaccreditata, quella scelta viene addebitata, negozio per negozio.

Questa correzione si applica solo ai pack la cui modalità di gestione delle giacenze scarica i prodotti che li compongono. Un pack impostato per scaricare solo la propria giacenza non è interessato, e la schermata di modifica te ne avvisa.

Risoluzione dei problemi

Il blocco non compare sulla scheda prodotto

Il blocco compare solo se il pack contiene almeno un prodotto davvero configurabile: modalità diversa da fissa, prodotto con combinazioni e almeno due combinazioni candidate dopo il filtro di elenco consentito, gruppo di attributi e giacenza. Verifica anche che l’hook displayProductAdditionalInfo sia registrato nel tuo tema.

L’elenco nativo del pack resta visibile

Il tuo tema non usa .product-pack. Ispeziona la pagina, annota la classe o l’identificativo del contenitore e inseriscilo nell’impostazione del selettore CSS.

Compare una casella di testo vuota sulla scheda

È il campo di personalizzazione del modulo, mostrato da alcuni temi. Attiva l’impostazione prevista per nasconderlo.

La scelta non compare nel carrello

Svuota la cache di PrestaShop e verifica che nessun modulo di terze parti sostituisca il form di aggiunta al carrello. Il modulo intercetta il clic sul pulsante in fase di cattura per passare prima dello script del tema, ma un form ricostruito interamente da un altro modulo può aggirare questo punto di aggancio.

Limiti noti

• L’impatto sul prezzo delle combinazioni viene ignorato. Un pack nativo si vende a un prezzo unico, che una personalizzazione non può modificare. La schermata di modifica segnala i prodotti interessati, così puoi escludere quelle combinazioni dall’elenco consentito.
• La fattura resta una riga unica all’aliquota IVA del pack, con il dettaglio delle scelte nel riepilogo di personalizzazione. Se ogni componente deve essere fatturato separatamente con la propria aliquota, guarda DataFirefly Pack Pro o Pack VAT Pro.
• Questa versione è destinata a PrestaShop dalla 8.0 alla 8.x. Poiché la schermata di gestione dei pack ha cambiato base tecnica in PrestaShop 9, il port arriverà con una versione dedicata.

Compatibilità

• PrestaShop dalla 8.0.0 alla 8.x
• Multinegozio: le impostazioni sono salvate per negozio
• Multilingua: interfaccia del modulo fornita in italiano, inglese, francese, spagnolo, tedesco, olandese, polacco e portoghese
• Testato sul tema Classic