Pulsanti +/- Quantità — Guida completa
Installare, configurare e personalizzare i pulsanti + e − di quantità nella scheda prodotto PrestaShop 8 e 9: stile, colori, compatibilità con il tema Classic e funzionamento senza override.
Panoramica
Il modulo Pulsanti +/- Quantità aggiunge veri pulsanti + e − su ciascun lato del campo quantità, nella scheda prodotto. Sostituisce l’uso del piccolo campo numerico nativo di PrestaShop — scomodo sia da tastiera sia con il dito su mobile — con due ampi pulsanti facili da toccare.
Il modulo non modifica alcun file del tema: aggiunge un foglio di stile e uno script leggeri, solo nella scheda prodotto, che racchiudono il campo quantità esistente. È compatibile con PrestaShop 1.7, 8 e 9, con il tema Classic e con la maggior parte dei temi personalizzati.
Installazione
- Nel back office, apri Moduli > Gestore dei moduli.
- Fai clic su Carica un modulo e rilascia l’archivio ZIP del modulo.
- Al termine dell’installazione, fai clic su Configura (facoltativo: il modulo funziona con le impostazioni predefinite subito dopo l’installazione).
Non viene creata alcuna tabella SQL e non viene modificato alcun file del tema. Il modulo registra semplicemente l’hook che carica le sue risorse nella scheda prodotto.
Configurazione
La pagina di configurazione raccoglie quattro impostazioni. Tutte sono facoltative: per impostazione predefinita i pulsanti sono attivi, in stile quadrato, con le frecce native nascoste.
Attivare i pulsanti
L’interruttore Attivare i pulsanti controlla la visualizzazione globale. Disattivalo per nascondere temporaneamente i pulsanti senza disinstallare il modulo: la scheda prodotto torna allora al campo quantità originale.
Stile dei pulsanti
Scegli l’aspetto dei pulsanti:
- Quadrato: i pulsanti + e − hanno angoli leggermente arrotondati alle estremità del gruppo (stile predefinito).
- Arrotondato: i pulsanti assumono una forma a pillola, con estremità completamente arrotondate.
Colore di sfondo e colore delle icone
Due selettori di colore permettono di regolare:
- il colore di sfondo dei pulsanti (grigio chiaro per impostazione predefinita);
- il colore delle icone + e − (grigio scuro per impostazione predefinita).
L’effetto al passaggio del mouse viene derivato automaticamente dal colore di sfondo, quindi non c’è una terza impostazione da gestire. I colori vengono applicati tramite variabili CSS, il che garantisce un’integrazione pulita nella maggior parte dei temi.
Nascondere le frecce native del campo numerico
Quando questa opzione è attivata (consigliato), le piccole frecce verticali del campo numerico del browser vengono nascoste, lasciando solo i pulsanti + e − del modulo. Disattivala se preferisci mantenere visibili le frecce native.
Lato cliente
Nella scheda prodotto, il cliente vede un pulsante − a sinistra del campo quantità e un pulsante + a destra. Ogni clic incrementa o riduce la quantità di un passo, quindi aggiorna il prezzo, le eventuali combinazioni e il pulsante di aggiunta al carrello, esattamente come un inserimento manuale. La quantità resta naturalmente modificabile direttamente da tastiera nel campo.
Funzionamento e compatibilità
Nessun override del template
Il modulo non sovrascrive alcun file del tema. Individua il campo quantità standard della scheda prodotto e lo racchiude tramite iniezione JavaScript per aggiungere i pulsanti. Questo approccio lo rende compatibile con un’ampia gamma di temi e lo protegge dagli aggiornamenti di PrestaShop, poiché nessun template viene sovrascritto.
Tema Classic e bootstrap-touchspin
Il tema Classic arricchisce già il campo quantità con bootstrap-touchspin, che aggiunge due piccole frecce verticali. Il modulo neutralizza in modo pulito quelle frecce all’interno del proprio gruppo di pulsanti, lasciando solo i + e − ben leggibili, senza duplicati né spostamenti di layout.
Sincronizzazione con il carrello
A ogni clic, il modulo applica il nuovo valore e poi attiva gli eventi attesi da PrestaShop, sia nativi sia jQuery. Il prezzo totale, le combinazioni e il pulsante di aggiunta al carrello reagiscono normalmente. Dopo un cambio di combinazione, che ricostruisce il blocco quantità, i pulsanti vengono reiniettati automaticamente.
Rispetto dello stock e dei vincoli
I pulsanti leggono la quantità minima, la quantità massima e il passo definiti sul campo. Il cliente non può scendere sotto il minimo richiesto (spesso 1) né superare lo stock disponibile quando è limitato. Il comportamento resta coerente con le regole del negozio.
Risoluzione dei problemi
I pulsanti non compaiono nella scheda prodotto
Verifica che il modulo sia attivato e che l’opzione Attivare i pulsanti sia su Sì. Svuota quindi la cache di PrestaShop (Parametri avanzati > Prestazioni) e ricarica la scheda prodotto. Se il tuo tema usa un campo quantità fortemente personalizzato, il modulo potrebbe non rilevarlo; contatta il supporto indicando il tuo tema.
Le frecce native del tema Classic restano visibili
Assicurati di usare la versione 1.1.0 o successiva, che neutralizza le frecce bootstrap-touchspin, quindi svuota la cache. Verifica inoltre che nessun override CSS del tuo tema mostri nuovamente quelle frecce.
La quantità cambia ma il prezzo non si aggiorna
Questo comportamento deriva di solito da un tema che non usa gli eventi standard di PrestaShop. Il modulo attiva gli eventi nativi e jQuery; se il tema ascolta un meccanismo diverso, contatta il supporto indicando il tema utilizzato.
Disinstallazione
La disinstallazione del modulo rimuove le sue risorse dalla scheda prodotto ed elimina la sua configurazione. Il campo quantità torna al suo aspetto originale. Nessun dato prodotto o ordine viene interessato.
FAQ
Il modulo modifica il mio tema?
No. Non sovrascrive alcun file del tema: aggiunge un foglio di stile e uno script solo nella scheda prodotto, che racchiudono il campo quantità esistente.
Posso cambiare il colore dei pulsanti?
Sì. La configurazione permette di impostare il colore di sfondo e il colore delle icone + e −, oltre allo stile quadrato o arrotondato. L’effetto al passaggio del mouse viene derivato automaticamente dal colore di sfondo.
Il modulo è compatibile con PrestaShop 9?
Sì, il modulo è compatibile con PrestaShop 1.7, 8.x e 9.x, sia in negozio singolo sia in multistore.