Mancia / Tip al Checkout — Guida completa
Installare, configurare e usare la mancia facoltativa (percentuale, importo fisso o libero) nel carrello e al checkout per PrestaShop 8 e 9.
Panoramica
Il modulo Mancia / Tip al Checkout (dftip) aggiunge nella pagina del carrello del tuo negozio un blocco «Aggiungi una mancia» che permette al cliente di lasciare una mancia facoltativa: una percentuale, un importo fisso o un importo libero. La mancia viene poi integrata in modo nativo nell’ordine, senza override del core di PrestaShop. Ideale per artigiani, creatori e ristorazione.
La mancia è portata da una riga d’ordine dedicata il cui prezzo è fissato per il carrello corrente tramite uno specific_price limitato al carrello. Fluisce quindi in modo pulito nel totale pagato, nell’IVA, nella fattura e nelle eventuali note di credito — esattamente il meccanismo che PrestaShop usa per i prezzi personalizzati durante la modifica di un ordine.
Compatibilità
- PrestaShop 8.0 a 9.x
- PHP 7.4 a 8.3
- Negozio singolo e multistore
- 5 lingue: FR, EN, ES, DE, IT
- Tema Classic e temi personalizzati
- Senza dipendenze (né Composer né framework)
Installazione
- Nel back-office, apri Moduli > Gestore dei moduli.
- Clicca su Carica un modulo e seleziona il file
dftip.zip. - Una volta installato, clicca su Configura.
All’installazione, il modulo registra i suoi hook, crea un prodotto virtuale nascosto «Mancia» (fuori dal catalogo e dalla ricerca, senza spedizione) destinato a portare l’importo della mancia, e applica le impostazioni predefinite: mancia in percentuale 5, 10, 15 %, importo libero consentito, senza IVA.
Configurazione
Tutte le impostazioni si trovano nella pagina di configurazione del modulo.
- Attivare il modulo: mostra o nasconde il blocco della mancia.
- Titolo e sottotitolo: testi del blocco, personalizzabili e traducibili in ogni lingua.
- Tipo di mancia: Percentuale, Importo fisso o Entrambi.
- Percentuali proposte: elenco separato da virgole, per esempio
5,10,15. - Importi fissi proposti: elenco separato da virgole nella valuta predefinita, per esempio
1,2,5. - Base di calcolo della percentuale: totale prodotti IVA inclusa o IVA esclusa.
- Consentire un importo libero: aggiunge un campo di inserimento libero.
- Importo libero minimo / massimo: limiti applicati all’importo libero.
- Imposta applicata alla mancia: Nessuna imposta per impostazione predefinita; puoi selezionare un gruppo di imposte se il tuo caso lo richiede.
- Mostrare il blocco nella pagina del carrello: attiva il selettore nella pagina del carrello.
Il titolo e il sottotitolo sono campi multilingua: scegli ogni lingua nel selettore del campo per adattare il testo. Valori predefiniti sono forniti nelle cinque lingue all’installazione.
Funzionamento
Come viene aggiunta la mancia
Quando il cliente sceglie una mancia, il modulo memorizza la sua scelta (tipo e valore) per il carrello corrente, aggiunge la riga «Mancia» al carrello e ne fissa il prezzo esatto tramite uno specific_price limitato a quel carrello. L’operazione avviene via Ajax, senza ricaricare, e il totale si aggiorna immediatamente.
Percentuale ricalcolata automaticamente
Per una mancia in percentuale, l’importo segue il contenuto del carrello: se il cliente aggiunge o rimuove un prodotto, il modulo ricalcola l’importo e risincronizza la riga prima del pagamento. La base (totale prodotti IVA inclusa o esclusa) è definita nella configurazione ed esclude sempre la riga della mancia stessa e le spese di spedizione.
Integrazione nativa nell’ordine
Poiché la mancia è una riga di carrello reale, è inclusa nell’importo effettivamente pagato e catturata nell’ordine alla convalida. Appare in modo pulito nella fattura, nella contabilità e nelle eventuali note di credito, senza override del core.
IVA della mancia
Poiché una mancia volontaria è generalmente fuori dal campo di applicazione dell’IVA, la riga è fornita senza imposta per impostazione predefinita. Se associ un gruppo di imposte alla mancia, l’importo inserito o calcolato è trattato come base imponibile esclusa.
Il prodotto «Mancia» creato dal modulo non deve essere eliminato né reso visibile nel catalogo: serve solo a portare l’importo della mancia. È nascosto dalla ricerca e dagli elenchi e resta senza spedizione.
Rimuovere la mancia
Il cliente può rimuovere la sua mancia in qualsiasi momento tramite l’opzione «Nessuna mancia». Se rimuove manualmente la riga «Mancia» dal carrello, il modulo cancella anche la scelta memorizzata per non riaggiungerla.
FAQ e risoluzione dei problemi
Il blocco della mancia non appare nella pagina del carrello
Verifica che il modulo sia attivato e che l’opzione «Mostrare il blocco nella pagina del carrello» sia selezionata. Poi svuota la cache di PrestaShop (Parametri avanzati > Prestazioni) e, durante i test, disattiva la combinazione/compressione (CCC). Il blocco appare quando il carrello contiene almeno un articolo.
La mancia in percentuale non si aggiorna quando cambio il carrello
Il ricalcolo avviene al salvataggio del carrello e al caricamento della pagina del carrello o del checkout. Se modifichi il carrello tramite un’azione Ajax del tema, ricarica la pagina: l’importo verrà risincronizzato prima del pagamento.
La mancia appare sulla fattura?
Sì. La mancia è una riga d’ordine a tutti gli effetti: appare nel dettaglio dell’ordine e sulla fattura, ed è considerata nelle note di credito.
Posso applicare l’IVA alla mancia?
Sì, selezionando un gruppo di imposte nella configurazione. Per impostazione predefinita la mancia è senza imposta, in linea con la natura di una mancia volontaria.
È compatibile con PrestaShop 9 e multistore?
Sì. Il modulo è compatibile con PrestaShop 8 e 9, in negozio singolo come in multistore, e multilingua, senza dipendenza da Composer né framework.