Solidaire afronding en donatie bij het afrekenen — Complete handleiding
De solidaire afronding en de caritatieve microdonatie bij het afrekenen installeren, configureren en benutten (drie modi, donatie zonder btw, donatieopvolging) voor PrestaShop 8 en 9.
Presentatie
De module Solidaire afronding en donatie bij het afrekenen (dfsolidarityround) laat uw klanten in enkele seconden een goed doel steunen, rechtstreeks in de winkelwagen: door hun bestelling af te ronden naar de hogere euro, door een vooraf gedefinieerd donatiebedrag te kiezen, of door een vrij bedrag in te voeren. De donatie integreert netjes in het totaal: btw, valuta en multistore worden door de kern van PrestaShop afgehandeld, tot en met de factuur.
De donatie is geen simpele weergave: ze wordt gedragen door een speciaal virtueel product en een specifieke prijs beperkt tot de winkelwagen van de klant. Het bedrag komt dus vanzelf terug in de totalen, de bestelling en de factuur.
Compatibiliteit
- PrestaShop 8.0 tot 9.x
- Single- en multistore
- PHP 7.4 tot 8.3
- Classic-thema en aangepaste thema’s
- Interface geleverd in het Frans, Engels, Spaans, Duits en Italiaans
- Geen afhankelijkheden (geen Composer, geen framework)
Installatie
- Open in de backoffice Modules > Modulebeheer.
- Klik op Een module uploaden en selecteer het bestand
dfsolidarityround.zip. - Klik na de installatie op Configureren.
Bij de installatie maakt de module haar historietabel aan, registreert haar hooks (frontresources, blok in de winkelwagen en bij het afrekenen, bestellingsvalidatie), voegt het backoffice-tabblad Solidaire donaties toe en genereert een verborgen virtueel product “Solidaire donatie”: niet zichtbaar in de winkel, zonder btw, zonder verzendkosten. Dat product draagt het donatiebedrag in de winkelwagen. Verwijder het niet handmatig.
Configuratie
Donatiemodi
Drie modi zijn beschikbaar en worden onafhankelijk van elkaar geactiveerd. U kunt er slechts één aanbieden, of alle drie tegelijk.
- Afronden naar de hogere euro: stelt de klant voor om zijn bestelling naar het hogere ronde bedrag te brengen. De afrondingsstap is configureerbaar (
1,00voor de hele euro,0,50voor de halve euro, enz.). - Vaste bedragen: toont knoppen die klaar zijn om aan te klikken. De lijst met bedragen is configureerbaar (bijvoorbeeld
1;2;5). - Vrij bedrag: laat de klant het bedrag van zijn keuze invoeren, begrensd door een minimumdonatie en een maximumdonatie.
Als het winkelwagentotaal in de afrondingsmodus al een rond bedrag is, stelt de module een donatie van een volledige stap voor, zodat de opt-in van de klant altijd zinvol blijft.
Personalisatie van het goede doel
- Bloktitel: opschrift getoond boven het blok (meertalig veld).
- Naam van de organisatie: naam van het gesteunde doel (meertalig veld).
- Beschrijving: korte begeleidende tekst (meertalig veld).
- Logo van de organisatie: beeld getoond in het blok (PNG, JPG, GIF, WEBP of SVG).
Weergaveposities
- Tonen op de winkelwagenpagina: toont het blok onderaan de winkelwagenpagina (de belangrijkste en betrouwbaarste positie).
- Tonen in het bestelproces: toont het blok in de bestelsamenvatting, als uw thema de bijbehorende positie aanbiedt.
Werking aan klantzijde
Afronden naar de hogere euro
De klant ziet een knop van het type “Afronden en 0,73 € doneren”. Het voorgestelde bedrag komt overeen met het verschil tussen zijn totaal en het hogere ronde bedrag, volgens de geconfigureerde stap.
Vaste bedragen
De klant klikt op een van de voorgestelde bedragen (1 €, 2 €, 5 €…). De bijbehorende donatie wordt direct toegevoegd.
Vrij bedrag
De klant voert het bedrag van zijn keuze in en bevestigt. De waarde wordt gecontroleerd ten opzichte van het gedefinieerde minimum en maximum.
Zodra de donatie is toegevoegd, toont het blok een bedankje en een link “Donatie verwijderen”. De klant houdt de controle: hij kan het bedrag wijzigen of zijn donatie op elk moment vóór de betaling intrekken.
Hoe de donatie aan de winkelwagen wordt toegevoegd
Bij elke keuze maakt de module een specifieke prijs (SpecificPrice) aan, beperkt tot de huidige winkelwagen (id_cart), en past die toe op het virtuele product “Solidaire donatie”. Dat product wordt aan de winkelwagen toegevoegd wanneer het bedrag groter is dan nul, en anders verwijderd. PrestaShop past dan de valuta en de multistore-context toe, en de donatie verschijnt als een duidelijke regel in de totalen, de bestelling en de factuur.
Automatische herberekening van de afronding
In de afrondingsmodus wordt het donatiebedrag bij elke weergave van het blok herberekend. Als de klant zijn winkelwagen wijzigt nadat hij de afronding heeft gekozen, blijft de donatie dus consistent met het nieuwe totaal tot aan de betaling.
Donatie zonder btw
Het product “Solidaire donatie” wordt aangemaakt zonder btw-regel: het getoonde en geïnde bedrag komt exact overeen met het gebaar van de klant, zonder btw-verrassing.
Donatieopvolging in de backoffice
Een tabblad Solidaire donaties wordt toegevoegd onder Bestellingen (controller AdminDfDonations). Het toont elke donatie met:
- het bedrag van de donatie;
- de gebruikte modus (afronding, vast bedrag of vrij bedrag);
- de klant en de bijbehorende bestelling;
- de datum van de donatie.
Een samenvattende banner toont het totaal ingezamelde bedrag en het aantal donaties. De donatie wordt vastgelegd in de historie bij de validatie van de bestelling (actionValidateOrder).
Doorstorting aan het goede doel
De module stort de donaties niet automatisch door aan de organisatie: dat is een bewuste keuze. Ze verzamelt de donaties binnen uw bestellingen en levert u het totaal en de historie. U behoudt de controle over het moment en het kanaal van de doorstorting aan uw partnerorganisatie, volgens uw eigen proces.
Compatibiliteit met PrestaShop 9
De module is ontworpen en getest van PrestaShop 8.0 tot 9.x:
- de backoffice-controller gebruikt
ModuleAdminController, compatibel met 8 en 9; - de code vermijdt methoden die in PrestaShop 9 zijn verwijderd (portable AJAX-token en prijsformattering);
- de AJAX-controller geeft rechtstreeks JSON terug, zonder incompatibele signature-override.
FAQ en probleemoplossing
Het blok verschijnt niet in het bestelproces
Het blok wordt betrouwbaar getoond onderaan de winkelwagenpagina. In de bestelsamenvatting hangt de weergave af van het thema, dat de bijbehorende positie moet aanbieden. De op de winkelwagenpagina gekozen donatie blijft hoe dan ook behouden tot aan de betaling.
Het totaal wordt na de klik niet bijgewerkt
Het blok triggert een verversing van de winkelwagen na het toevoegen of verwijderen van de donatie. Leeg de PrestaShop-cache en herlaad de pagina. Controleer ook of het product “Solidaire donatie” niet handmatig is verwijderd.
De winkel wordt wit na installatie
Zorg dat u de laatste versie van de module gebruikt en leeg de cache. Het donatieproduct is bewust niet zichtbaar in de winkel; maak het niet zichtbaar en verwijder het niet handmatig.
De afrondingsdonatie lijkt onjuist
Controleer de geconfigureerde afrondingsstap. In de afrondingsmodus wordt de donatie bij elke weergave van het blok herberekend op basis van het totaal exclusief donatie; als de winkelwagen wijzigt, wordt het bedrag automatisch aangepast.
Hoe vertaal ik het blok naar een andere taal?
De titel, de naam van de organisatie en de beschrijving zijn meertalige velden: selecteer elke taal in de configuratie om ze te vertalen. De interfacelabels vertaalt u via Geavanceerde instellingen > Vertalingen > Vertalingen van geïnstalleerde modules, door dfsolidarityround te kiezen.
Is de module compatibel met PrestaShop 9?
Ja. De module is ontworpen en getest van PrestaShop 8.0 tot 9.x, zowel in single- als in multistore.
Deïnstallatie
De deïnstallatie verwijdert het product “Solidaire donatie”, het backoffice-tabblad en de donatiehistorietabel. Wilt u de historie bewaren, schakel de module dan uit zonder te deïnstalleren.