# Pulsanti +/- Quantità — Guida completa

> 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…

- Pagina: <https://www.datafirefly.com/it/documentation/dfqtybuttons/>
- Lingua: it
- Aggiornato il: 2026-06-27
- Altre lingue: [fr](https://www.datafirefly.com/documentation/dfqtybuttons/index.md), [en](https://www.datafirefly.com/en/documentation/dfqtybuttons/index.md), [es](https://www.datafirefly.com/es/documentation/dfqtybuttons/index.md), [de](https://www.datafirefly.com/de/documentation/dfqtybuttons/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfqtybuttons/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfqtybuttons/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfqtybuttons/index.md)
- Indice: <https://www.datafirefly.com/it/documentation/llms.txt>

## 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

1. Nel back office, apri **Moduli > Gestore dei moduli**.
2. Fai clic su **Carica un modulo** e rilascia l'archivio ZIP del modulo.
3. 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.
