Arrotondamento Solidale e Donazione al Checkout — Guida completa
Installare, configurare e utilizzare l'arrotondamento solidale e la microdonazione al checkout (tre modalità, donazione senza IVA, monitoraggio delle donazioni) per PrestaShop 8 e 9.
Presentazione
Il modulo Arrotondamento Solidale e Donazione al Checkout (dfsolidarityround) consente ai tuoi clienti di sostenere un’associazione in pochi secondi, direttamente nel carrello: arrotondando il loro ordine all’euro superiore, scegliendo un importo di donazione predefinito o inserendo un importo libero. La donazione si integra in modo pulito nel totale — IVA, valuta e multinegozio gestiti dal cuore di PrestaShop, fino alla fattura.
La donazione non è una semplice visualizzazione: è sostenuta da un prodotto virtuale dedicato e da un prezzo specifico limitato al carrello del cliente. L’importo compare quindi naturalmente nei totali, nell’ordine e nella fattura.
Compatibilità
- PrestaShop da 8.0 a 9.x
- Mononegozio e multinegozio
- PHP da 7.4 a 8.3
- Tema Classic e temi personalizzati
- Interfaccia fornita in francese, inglese, spagnolo, tedesco e italiano
- Nessuna dipendenza (né Composer né framework)
Installazione
- Nel back-office, apri Moduli > Gestione moduli.
- Clicca su Carica un modulo e seleziona il file
dfsolidarityround.zip. - Una volta installato, clicca su Configura.
All’installazione, il modulo crea la sua tabella di cronologia, registra i suoi hook (risorse front, blocco nel carrello e al checkout, convalida dell’ordine), aggiunge la scheda di back-office Donazioni solidali e genera un prodotto virtuale nascosto «Donazione solidale»: non visibile nel negozio, senza IVA, senza spese di spedizione. È lui a sostenere l’importo della donazione nel carrello. Non eliminarlo manualmente.
Configurazione
Modalità di donazione
Sono disponibili tre modalità che si attivano in modo indipendente. Puoi proporne una sola, oppure tutte e tre insieme.
- Arrotondamento all’euro superiore: propone al cliente di portare il suo ordine all’importo tondo superiore. Il passo di arrotondamento è configurabile (
1,00per l’euro superiore,0,50per il mezzo euro, ecc.). - Importi fissi: mostra pulsanti pronti da cliccare. L’elenco degli importi è configurabile (per esempio
1;2;5). - Importo libero: permette al cliente di inserire la somma che preferisce, delimitata da una donazione minima e una donazione massima.
In modalità arrotondamento, se il totale del carrello è già un importo tondo, il modulo propone una donazione di un passo completo affinché l’adesione del cliente abbia sempre senso.
Personalizzazione dell’associazione
- Titolo del blocco: intestazione mostrata in cima al blocco (campo multilingua).
- Nome dell’associazione: nome della causa sostenuta (campo multilingua).
- Descrizione: breve testo di accompagnamento (campo multilingua).
- Logo dell’associazione: immagine mostrata nel blocco (PNG, JPG, GIF, WEBP o SVG).
Posizioni di visualizzazione
- Mostra nella pagina Carrello: mostra il blocco in fondo alla pagina del carrello (posizione principale e affidabile).
- Mostra nel processo di checkout: mostra il blocco nel riepilogo dell’ordine, se il tuo tema espone la posizione corrispondente.
Funzionamento lato cliente
Arrotondamento all’euro superiore
Il cliente vede un pulsante del tipo «Arrotonda e dona 0,73 €». L’importo proposto è la differenza tra il suo totale e l’importo tondo superiore, secondo il passo configurato.
Importi fissi
Il cliente clicca su uno degli importi proposti (1 €, 2 €, 5 €…). La donazione corrispondente viene aggiunta immediatamente.
Importo libero
Il cliente inserisce l’importo che preferisce e conferma. Il valore viene controllato rispetto al minimo e al massimo definiti.
Una volta aggiunta la donazione, il blocco mostra un ringraziamento e un link «Rimuovi la donazione». Il cliente mantiene il controllo: può cambiare importo o rimuovere la sua donazione in qualsiasi momento prima del pagamento.
Come la donazione viene aggiunta al carrello
A ogni scelta, il modulo crea un prezzo specifico (SpecificPrice) limitato al carrello corrente (id_cart) e lo applica al prodotto virtuale «Donazione solidale». Questo prodotto viene aggiunto al carrello quando l’importo è maggiore di zero, rimosso altrimenti. PrestaShop applica quindi la valuta e il contesto multinegozio, e la donazione compare come una riga chiara nei totali, nell’ordine e nella fattura.
Ricalcolo automatico dell’arrotondamento
In modalità arrotondamento, l’importo della donazione viene ricalcolato a ogni visualizzazione del blocco. Così, se il cliente modifica il carrello dopo aver scelto l’arrotondamento, la donazione resta coerente con il nuovo totale fino al pagamento.
Donazione senza IVA
Il prodotto «Donazione solidale» viene creato senza alcuna regola fiscale: l’importo mostrato e raccolto corrisponde esattamente al gesto del cliente, senza sorprese di IVA.
Monitoraggio delle donazioni nel back-office
Una scheda Donazioni solidali viene aggiunta sotto Ordini (controller AdminDfDonations). Elenca ogni donazione con:
- l’importo della donazione;
- la modalità utilizzata (arrotondamento, importo fisso o importo libero);
- il cliente e l’ordine associato;
- la data della donazione.
Un banner di sintesi mostra il totale raccolto e il numero di donazioni. La donazione viene congelata nella cronologia alla convalida dell’ordine (actionValidateOrder).
Versamento all’associazione
Il modulo non versa automaticamente le donazioni all’associazione: è voluto. Raccoglie le donazioni all’interno dei tuoi ordini e ti fornisce il totale e la cronologia. Mantieni il controllo su quando e come versare i fondi alla tua associazione partner, secondo il tuo processo.
Compatibilità con PrestaShop 9
Il modulo è progettato e testato da PrestaShop 8.0 a 9.x:
- il controller di back-office usa
ModuleAdminController, compatibile con 8 e 9; - il codice evita i metodi rimossi in PrestaShop 9 (token AJAX e formattazione del prezzo portabili);
- il controller AJAX restituisce JSON direttamente, senza override di firma incompatibile.
FAQ e risoluzione dei problemi
Il blocco non compare nel processo di checkout
Il blocco viene mostrato in modo affidabile in fondo alla pagina del carrello. Nel riepilogo dell’ordine, la visualizzazione dipende dal tema, che deve esporre la posizione corrispondente. In ogni caso, la donazione scelta nella pagina del carrello viene conservata fino al pagamento.
Il totale non viene aggiornato dopo il clic
Il blocco attiva un aggiornamento del carrello dopo l’aggiunta o la rimozione della donazione. Svuota la cache di PrestaShop e ricarica la pagina. Verifica anche che il prodotto «Donazione solidale» non sia stato eliminato manualmente.
Il negozio diventa bianco dopo l’installazione
Assicurati di usare l’ultima versione del modulo e svuota la cache. Il prodotto di donazione è volutamente non visibile nel negozio; non renderlo visibile e non eliminarlo manualmente.
La donazione di arrotondamento mi sembra errata
Verifica il passo di arrotondamento configurato. In modalità arrotondamento, la donazione viene ricalcolata a ogni visualizzazione del blocco, a partire dal totale senza la donazione; se il carrello cambia, l’importo viene regolato automaticamente.
Come tradurre il blocco in un’altra lingua?
Il titolo, il nome dell’associazione e la descrizione sono campi multilingua: seleziona ogni lingua nella configurazione per tradurli. Le etichette dell’interfaccia si traducono tramite Parametri avanzati > Traduzioni > Traduzioni dei moduli installati, scegliendo dfsolidarityround.
È compatibile con PrestaShop 9?
Sì. Il modulo è progettato e testato da PrestaShop 8.0 a 9.x, sia in mononegozio sia in multinegozio.
Disinstallazione
La disinstallazione elimina il prodotto «Donazione solidale», la scheda di back-office e la tabella di cronologia delle donazioni. Se desideri conservare la cronologia, disattiva il modulo senza disinstallarlo.