Pack prodotti e bundle: documentazione

Installazione

Il modulo si installa come qualsiasi modulo PrestaShop, dal back office o via FTP.

1. Da Moduli e Gestore moduli, clicca su Carica un modulo e trascina il file dfpackpro.zip.
2. Via FTP, decomprimi l’archivio nella cartella /modules/ del tuo negozio e installa DataFirefly – Packs & Bundles dal gestore moduli.
3. Svuota la cache in Parametri avanzati e Prestazioni.

L’installazione crea sei tabelle con prefisso ps_dfpackpro, registra gli hook necessari e aggiunge la scheda Packs & Bundles (DF) nel menu Catalogo.

Impostazioni generali

Il pulsante Configura della scheda modulo apre le impostazioni applicate a tutti i pack.

• Posizione del blocco sulla scheda prodotto: sotto il blocco d’acquisto, a fondo scheda, o entrambi. Il blocco elenca i pack che contengono il prodotto consultato.
• Blocco pack attivo: disattiva la visualizzazione cross-sell senza disinstallare. Le pagine dei pack restano raggiungibili.
• Numero massimo di pack mostrati: 3 di default.
• Ordinamento dei pack: posizione, data di creazione o casuale.
• Mostra i prezzi unitari: dettaglia il prezzo di ogni componente sulla pagina del pack.
• Mostra il risparmio: badge e importo risparmiato, sul blocco della scheda e sulla pagina del pack.
• Mostra la disponibilità: stato di stock del pack, calcolato dagli stock dei componenti.
• Modalità carrello rigorosa: se il cliente rimuove un componente, tutto il pack e il suo sconto vengono rimossi. Disattivata, la rimozione è accettata e lo sconto conservato sul resto.
• Dopo l’aggiunta al carrello: reindirizzamento al carrello o conferma sul posto.
• Colore d’accento: colore di badge, pulsanti e bordi dei blocchi del modulo.

Creare un pack

Apri Catalogo e Packs & Bundles (DF), e clicca su Nuovo pack.

Informazioni del pack

• Nome: campo tradotto, mostrato sul blocco della scheda prodotto, sulla pagina del pack e sul badge del carrello.
• Alias URL: generato automaticamente dal nome se lasciato vuoto. Compone l’indirizzo della pagina del pack.
• Descrizione: testo ricco tradotto, mostrato sulla pagina del pack.
• Badge: testo breve tradotto, mostrato sulle card del blocco cross-sell. Lascialo vuoto per mostrare la percentuale di risparmio.
• Modalità di prezzo: le quattro modalità descritte sotto. Il modulo nasconde i campi inutili secondo la modalità scelta.
• Eredita le promozioni esistenti: attivata, gli sconti a catalogo in corso sono il prezzo di partenza del calcolo del pack.
• Date di validità: lasciale vuote per un pack permanente. Fuori periodo, il pack sparisce dal front.
• Attivo: equivalente all’interruttore di attivazione della lista.

Componenti

Il pannello Componenti gestisce il contenuto del pack.

• Ricerca prodotti: digita almeno due caratteri. La ricerca copre nome, riferimento e ID. Clicca su un risultato per aggiungerlo.
• Combinazione: per un prodotto con combinazioni, il selettore elenca le varianti con il loro prezzo. La variante scelta diventa quella di default.
• Scelta della combinazione da parte del cliente: attivata, il cliente seleziona la sua variante sulla pagina del pack e nel blocco della scheda. Disattivata, la variante è imposta.
• Quantità: numero di unità del componente nel pack. Un pack può contenere un solo prodotto in quantità, per una vendita a lotti.
• Quantità modificabile: il cliente può regolare la quantità di questo componente sulla pagina del pack.
• Opzionale: il cliente può deselezionare questo componente, il prezzo si ricalcola.
• Sconto per prodotto: in percentuale o importo, visibile solo in modalità Sconto per prodotto. Uno sconto del 100 % rende il componente in omaggio.
• Ordine: frecce su e giù per ordinare la visualizzazione.

Il simulatore di prezzo sotto la tabella ricalcola in tempo reale il prezzo totale, il prezzo del pack e il risparmio a ogni modifica.

Le quattro modalità di prezzo

Senza sconto

Il pack vende i componenti al loro prezzo corrente. Utile per un pack di pura comodità o per valorizzare solo la composizione.

Sconto globale in percentuale

La percentuale si applica al prezzo di ogni componente. Un pack al -15 % sconta ogni riga del 15 %.

Sconto per prodotto

Ogni componente porta il proprio sconto, in percentuale o importo. È la modalità delle offerte tipo macchina più consumabile in omaggio: la macchina allo 0 %, il consumabile al 100 %.

Prezzo fisso

Annunci il prezzo del pack, IVA inclusa nella valuta di default. La differenza tra la somma dei prezzi correnti e il prezzo annunciato è ripartita proporzionalmente su ogni riga, al netto delle imposte. Ogni prodotto conserva la sua aliquota IVA.

Esempio: un pack a 49 € composto da un prodotto A a 40 € e un prodotto B a 30 €. La somma corrente fa 70 €, lo sconto 21 €. A sopporta 12 € di sconto, B 9 €, in proporzione al loro peso sul totale. La fattura resta esatta anche se A è al 22 % di IVA e B al 10 %.

Il blocco sulle schede prodotto

Ogni prodotto che appartiene a un pack mostra un blocco « questo prodotto è disponibile anche in pack ». Ogni card presenta le miniature dei componenti, il nome del pack, il totale barrato, il prezzo del pack, il badge di risparmio e lo stato di stock.

• Vedi il pack apre la pagina del pack.
• Aggiungi aggiunge direttamente il pack al carrello nella sua configurazione di default. Il pulsante diventa Configura quando il pack contiene scelte da fare: combinazione libera, componente opzionale o quantità modificabile.

La posizione del blocco, il numero di card e il loro ordinamento si regolano nella configurazione del modulo.

La pagina del pack

Ogni pack ha la sua pagina all’indirizzo /pack/12-mio-alias, con l’identificativo del pack e l’alias della lingua corrente. La pagina elenca i componenti con i selettori di combinazione, le caselle dei prodotti opzionali e i campi quantità quando aperti.

Ogni modifica ricalcola in Ajax il prezzo totale, il prezzo del pack, il risparmio e la disponibilità, senza ricaricare la pagina. Il pulsante di aggiunta invia la selezione corrente al carrello.

La disponibilità è calcolata dagli stock reali: il pack è vendibile se ogni componente richiesto è disponibile nella quantità richiesta, tenendo conto dei permessi di ordine senza stock di ogni prodotto.

Il carrello

All’aggiunta di un pack, ogni componente diventa una vera riga del carrello, fatturata al suo prezzo pack tramite un prezzo specifico limitato a quel carrello. Nessun prodotto fantasma viene creato.

Badge del pack

Ogni riga che appartiene a un pack mostra un badge con il nome del pack, un link alla sua pagina e un pulsante Rimuovi l’intero pack. La rimozione elimina tutte le righe del pack e i loro sconti in un’azione.

Quantità aggiuntive

Il prezzo del pack copre solo le quantità del pack. Se il cliente aumenta la quantità di una riga, il modulo applica un prezzo unitario medio ponderato: quantità pack al prezzo pack, eccedenza al prezzo normale.

Esempio: pack di 2 unità a 8 € con prezzo normale di 10 €. Il cliente porta la riga a 5 unità. Il prezzo unitario diventa (2 x 8 + 3 x 10) / 5 = 9,20 €, un totale di 46 €. Lo sconto resta limitato alle 2 unità del pack.

Modalità rigorosa

Attivata, l’eliminazione di un componente rimuove tutto il pack e il suo sconto. Questo impedisce di conservare lo sconto restituendo parte del kit. Disattivata, la rimozione è accettata e lo sconto conservato sulle righe restanti.

Ordini e contabilità

Ogni prodotto del pack arriva sulla propria riga d’ordine, al suo prezzo pack. Fatture, documenti di trasporto, note di credito e resi parziali funzionano in modo nativo, articolo per articolo. Le esportazioni contabili ed ERP vedono solo riferimenti reali del tuo catalogo.

Il dettaglio di ogni ordine nel back office mostra un riepilogo dei pack ordinati. La lista dei pack mostra un contatore vendite per pack.

Multinegozio e multilingue

Ogni pack è associato ai negozi del contesto di creazione e può essere gestito negozio per negozio. I campi Nome, Alias URL, Descrizione e Badge sono tradotti nelle lingue installate. Il front segue la lingua del cliente, incluso l’alias della pagina del pack.

Adattare la visualizzazione al tuo tema

Tre template sono sovrascrivibili. Copiali da /modules/dfpackpro/views/templates/ a /themes/tuo-tema/modules/dfpackpro/views/templates/ conservando le sottocartelle.

• hook/product_packs.tpl: il blocco cross-sell delle schede prodotto
• front/pack.tpl: la pagina del pack
• hook/cart_line_badge.tpl: il badge del pack nel carrello

Il CSS è isolato sotto il prefisso dfpackpro e il colore d’accento è portato dalla variabile CSS --dfpackpro-accent. Per una regolazione puntuale, punta alle classi dal foglio di stile del tuo tema invece di modificare views/css/front.css, che verrebbe sovrascritto all’aggiornamento.

Risoluzione dei problemi

Il blocco non appare sulla scheda prodotto

1. Verifica che il pack sia attivo e che la data odierna rientri nel periodo di validità.
2. Verifica che il prodotto consultato faccia davvero parte dei componenti del pack.
3. Controlla l’impostazione Blocco pack attivo e la posizione scelta nella configurazione.
4. Svuota la cache Smarty e la cache del tuo server.

Il pack risulta non disponibile

La disponibilità è il minimo degli stock dei componenti richiesti divisi per la loro quantità nel pack. Un solo componente esaurito senza permesso di ordine senza stock basta a rendere il pack non disponibile. I componenti opzionali deselezionati non contano.

Il badge del carrello appare nel posto sbagliato

Il tema renderizza il badge nella colonna delle azioni, poi JavaScript lo sposta nel blocco informazioni del prodotto. Su un tema molto personalizzato senza i contenitori standard, il badge resta nella posizione originale. Sovrascrivi cart_line_badge.tpl per integrarlo nella tua struttura.

Il prezzo del pack si applica a troppe unità

Questo caso è coperto dal prezzo medio ponderato: controlla il prezzo unitario mostrato sulla riga, deve situarsi tra il prezzo del pack e il prezzo normale non appena la quantità supera quella del pack. In caso contrario, svuota la cache e modifica la quantità per innescare un ricalcolo.

La pagina del pack restituisce un 404

Verifica che il pack sia attivo e nel suo periodo di validità. Dopo un cambio di alias, il vecchio indirizzo reindirizza con un 301 al nuovo finché l’identificativo del pack è corretto.

Disinstallazione

La disinstallazione rimuove le sei tabelle del modulo, le sue chiavi di configurazione e la scheda del menu Catalogo. Gli ordini passati conservano le loro righe e i loro prezzi, il tuo storico contabile non viene alterato.