Cambiare la Combinazione nel Carrello PrestaShop: installazione e configurazione

Presentazione

Il modulo permette al cliente di cambiare la combinazione di un prodotto (taglia, colore o qualsiasi altro attributo) direttamente dalla pagina del carrello, senza rimuovere la riga. La nuova combinazione mantiene quantità, indirizzo di consegna e posizione della riga. Stock e quantità minima vengono verificati dal server prima del cambio.

Installazione

1. In Moduli > Gestione moduli, clicca su Carica un modulo e invia il file dfcartcombination-1.0.0.zip.
2. Il modulo si aggancia agli hook displayCartExtraProductActions e actionFrontControllerSetMedia e crea la tabella ps_dfcartcombination_log per la cronologia.
3. Apri la configurazione del modulo. Tutto è attivo di default, in modalità pulsante con finestra.
4. Aggiungi al carrello un prodotto con almeno due combinazioni e apri la pagina del carrello per verificare la visualizzazione. Se non compare nulla, svuota la cache in Parametri avanzati > Prestazioni.

Impostazioni

• Attiva il modulo: disattivato, nella pagina del carrello non viene caricato nulla.
• Modalità di visualizzazione: Pulsante con finestra di selezione (un link «Modifica» per riga) oppure Menu a tendina nella riga del carrello (un elenco per gruppo di attributi, modifica applicata alla selezione).
• Posiziona sotto gli attributi del prodotto: sposta il selettore sotto gli attributi della riga. Disattivalo per lasciarlo dove il tuo tema chiama l’hook, di solito nella colonna azioni accanto al cestino.
• Mostra il prezzo per combinazione: prezzo della combinazione scelta, prezzo barrato in caso di sconto e differenza rispetto alla riga attuale. Il prezzo segue la visualizzazione con o senza IVA del gruppo del cliente.
• Mostra lo stato dello stock: Disponibile, Solo X rimasti, Disponibile su ordinazione oppure Esaurito. «Solo X rimasti» usa la soglia di quantità residua impostata in PrestaShop. Non viene mostrato nulla se la gestione dello stock è disattivata.
• Mostra l’immagine della combinazione: prima immagine associata alla combinazione, altrimenti l’immagine di copertina del prodotto.
• Combinazioni non disponibili: Mostra disattivate oppure Nascondi. Il valore della riga attuale resta sempre visibile.
• Prodotti esclusi: ID prodotto separati da virgole. Il selettore non compare per questi prodotti e il server rifiuta qualsiasi modifica.
• Colore di accento: colore del pulsante principale e dei valori selezionati.
• Registra la cronologia delle modifiche: alimenta le statistiche mostrate sotto il modulo.

Lato cliente

Modalità finestra

Il pulsante Modifica apre una finestra con l’immagine della combinazione, il nome del prodotto e la quantità della riga. I gruppi di attributi seguono l’ordine del catalogo:

• gruppi di tipo colore: campioni, con la texture dell’attributo se presente;
• gruppi di tipo radio o elenco: pulsanti, oppure un menu a tendina oltre gli 8 valori.

In basso, prezzo, differenza di prezzo e stato dello stock della selezione si aggiornano a ogni clic. Il pulsante Aggiorna carrello resta inattivo finché la selezione è uguale alla riga o non disponibile. La finestra si chiude con Esc, la croce o un clic all’esterno e si usa da tastiera (frecce tra i valori di un gruppo). Su mobile si apre dal basso dello schermo.

Modalità menu a tendina

Ogni gruppo di attributi diventa un elenco nella riga. La modifica viene inviata appena si sceglie un valore. Le righe di attributi già mostrate dal tema (per esempio «Taglia: S») vengono nascoste per evitare doppioni. Un messaggio sotto gli elenchi indica l’aggiornamento in corso o l’eventuale errore.

Combinazione inesistente

Se il valore scelto non esiste con gli altri attributi selezionati (M Blu assente dal catalogo, per esempio), il modulo passa alla combinazione esistente che contiene quel valore e mantiene più attributi attuali, preferendo una combinazione ordinabile.

Controlli prima del cambio

Il browser invia il prodotto, la combinazione attuale e quella scelta. Il server verifica poi:

• il token della sessione;
• che il prodotto sia attivo e ordinabile, e che la modalità catalogo sia disattivata;
• che la combinazione scelta appartenga al prodotto e al negozio;
• che la riga originale sia ancora nel carrello, senza personalizzazione;
• che il prodotto non sia legato a una regola carrello con omaggio del carrello;
• che la quantità finale raggiunga la quantità minima della combinazione;
• che lo stock copra la quantità finale, salvo se la vendita senza disponibilità è consentita per il prodotto.

La nuova combinazione viene aggiunta con il metodo nativo updateQty, poi la vecchia viene rimossa con deleteProduct. Se la rimozione fallisce, l’aggiunta viene annullata. Se la combinazione scelta è già nel carrello, le quantità vengono sommate su una sola riga. Altrimenti la nuova riga riprende la data di aggiunta della vecchia per mantenere il suo posto nel carrello.

Dopo il cambio, il modulo attiva l’evento updateCart di PrestaShop. Il tema ricarica quindi elenco, totali e mini carrello. Se il tema non reagisce entro 3 secondi, la pagina si ricarica.

Righe non interessate

• prodotti senza combinazioni o con una sola combinazione;
• righe con personalizzazione (testo, file);
• prodotti regalati da una regola carrello;
• prodotti esclusi nella configurazione.

Cronologia e statistiche

Sotto il modulo di configurazione, il blocco Cronologia delle modifiche mostra:

• il numero di modifiche e di carrelli interessati in 30 giorni;
• il numero di carrelli modificati diventati ordini, con il tasso;
• i 10 prodotti più modificati;
• le ultime 20 modifiche, con la combinazione di partenza e quella scelta.

Il pulsante Svuota cronologia elimina i dati del negozio corrente. Un prodotto cambiato spesso verso la taglia superiore segnala una guida alle taglie o una scheda da rivedere.

Temi e personalizzazione

Il tema Classic e la maggior parte dei temi derivati chiamano displayCartExtraProductActions in ogni riga del carrello. Se il tuo tema non lo chiama, lo script crea il selettore partendo dai link di rimozione delle righe (data-id-product e data-id-product-attribute). Il file JavaScript viene caricato solo nella pagina del carrello.

Per adattare lo stile, sovrascrivi nel CSS del tema le variabili --dfcc-accent, --dfcc-text e --dfcc-border, oppure le classi .dfcc-edit, .dfcc-modal__dialog e .dfcc-option.

Per gli sviluppatori

Dopo ogni modifica riuscita, il modulo esegue l’hook actionDfCartCombinationChange con i parametri cart, id_product, id_product_attribute_from, id_product_attribute_to e quantity. Un modulo di terze parti può agganciarsi per sincronizzare un CRM o uno strumento di analisi.

Limiti noti

• Le righe personalizzate mantengono la loro combinazione nella versione 1.0.0.
• Il cambio avviene dalla pagina del carrello, non dal riepilogo del checkout né dal mini carrello.
• Un modulo di carrello laterale che non usa l’evento updateCart si aggiorna solo al ricaricamento della pagina.