Fooi in de checkout: volledige gids
De optionele fooi (percentage, vast bedrag of vrij bedrag) in winkelwagen en checkout installeren, configureren en gebruiken voor PrestaShop 8 en 9.
Overzicht
De module Fooi in de checkout (dftip) voegt op de winkelwagenpagina van uw shop een blok “Een fooi toevoegen” toe waarmee de klant een optionele fooi kan geven: een percentage, een vast bedrag of een vrij bedrag. De fooi wordt vervolgens native in de bestelling opgenomen, zonder override van de PrestaShop-core. Ideaal voor ambachtslieden, makers en horeca.
De fooi wordt gedragen door een aparte bestelregel waarvan de prijs voor de huidige winkelwagen wordt vastgelegd via een specific_price beperkt tot die winkelwagen. Hij loopt dus netjes mee in het betaalde totaal, de btw, de factuur en eventuele creditnota’s: exact het mechanisme dat PrestaShop gebruikt voor aangepaste prijzen bij het bewerken van een bestelling.
Compatibiliteit
- PrestaShop 8.0 tot 9.x
- PHP 7.4 tot 8.3
- Single-shop en multistore
- 5 talen: FR, EN, ES, DE, IT
- Classic-thema en aangepaste thema’s
- Geen enkele afhankelijkheid (geen Composer, geen framework)
Installatie
- Open in de back-office Modules > Modulebeheer.
- Klik op Een module installeren en selecteer het bestand
dftip.zip. - Klik na de installatie op Configureren.
Bij de installatie registreert de module haar hooks, maakt ze een verborgen virtueel product “Fooi” aan (buiten de catalogus en de zoekfunctie, zonder verzendkosten) dat het fooibedrag draagt, en past ze de standaardinstellingen toe: fooi in percentage 5, 10, 15 %, vrij bedrag toegestaan, zonder btw.
Configuratie
Alle instellingen staan op de configuratiepagina van de module.
- Module activeren: toont of verbergt het fooiblok.
- Titel en ondertitel: teksten van het blok, aanpasbaar en vertaalbaar per taal.
- Type fooi: Percentage, Vast bedrag of Beide.
- Voorgestelde percentages: kommagescheiden lijst, bijvoorbeeld
5,10,15. - Voorgestelde vaste bedragen: kommagescheiden lijst in de standaardvaluta, bijvoorbeeld
1,2,5. - Berekeningsbasis van het percentage: producttotaal incl. btw of excl. btw.
- Vrij bedrag toestaan: voegt een vrij invoerveld toe.
- Minimum / maximum vrij bedrag: grenzen toegepast op het vrije bedrag.
- Btw op de fooi: standaard Geen belasting; u kunt een belastinggroep selecteren als uw situatie dat vereist.
- Blok tonen op de winkelwagenpagina: activeert de weergave van de kiezer op de winkelwagenpagina.
De titel en ondertitel zijn meertalige velden: selecteer elke taal in de veldkiezer om de tekst aan te passen. Standaardwaarden worden bij de installatie in de vijf talen meegeleverd.
Werking
Hoe de fooi wordt toegevoegd
Wanneer de klant een fooi kiest, onthoudt de module de keuze (type en waarde) voor de huidige winkelwagen, voegt ze de regel “Fooi” aan de winkelwagen toe en legt ze de exacte prijs vast met een specific_price beperkt tot die winkelwagen. De operatie verloopt via AJAX, zonder herladen, en het totaal wordt onmiddellijk bijgewerkt.
Percentage automatisch herberekend
Bij een fooi in percentage volgt het bedrag de inhoud van de winkelwagen: voegt de klant een product toe of haalt hij er een weg, dan herberekent de module het bedrag en synchroniseert ze de regel vóór de betaling. De berekeningsbasis (producttotaal incl. of excl. btw) wordt in de configuratie bepaald en sluit altijd de fooiregel zelf en de verzendkosten uit.
Native integratie in de bestelling
Omdat de fooi een echte winkelwagenregel is, zit hij in het daadwerkelijk betaalde totaal en wordt hij bij de validatie in de bestelling vastgelegd. Hij verschijnt netjes op de factuur, in de boekhouding en in eventuele creditnota’s, zonder enige core-override.
Btw op de fooi
Omdat een vrijwillige fooi doorgaans buiten het btw-toepassingsgebied valt, wordt de regel standaard zonder belasting geleverd. Koppelt u een belastinggroep aan de fooi, dan wordt het ingevoerde of berekende bedrag behandeld als een basis exclusief btw.
Het product “Fooi” dat de module aanmaakt, mag niet worden verwijderd of zichtbaar gemaakt in de catalogus: het dient uitsluitend om het fooibedrag te dragen. Het is verborgen in de zoekfunctie en de lijsten en blijft zonder verzendkosten.
De fooi verwijderen
De klant kan zijn fooi op elk moment verwijderen via de optie “Geen fooi”. Verwijdert hij de regel “Fooi” handmatig uit de winkelwagen, dan wist de module ook de onthouden keuze om ze niet opnieuw toe te voegen.
FAQ en probleemoplossing
Het fooiblok verschijnt niet op de winkelwagenpagina
Controleer of de module actief is en of de optie “Blok tonen op de winkelwagenpagina” is aangevinkt. Leeg vervolgens de PrestaShop-cache (Geavanceerde instellingen > Prestaties) en schakel tijdens uw tests de combinatie/compressie (CCC) uit. Het blok verschijnt wanneer de winkelwagen minstens één artikel bevat.
De fooi in percentage wordt niet bijgewerkt als ik de winkelwagen wijzig
De herberekening gebeurt bij het opslaan van de winkelwagen en bij het laden van de winkelwagenpagina of de checkout. Wijzigt u de winkelwagen via een AJAX-actie van het thema, herlaad dan de pagina: het bedrag wordt vóór de betaling opnieuw gesynchroniseerd.
Verschijnt de fooi op de factuur?
Ja. De fooi is een volwaardige bestelregel: hij staat in het besteldetail en op de factuur, en wordt meegenomen in creditnota’s.
Kan ik btw op de fooi toepassen?
Ja, door in de configuratie een belastinggroep te selecteren. Standaard is de fooi zonder belasting, in lijn met de aard van een vrijwillige fooi.
Is dit compatibel met PrestaShop 9 en multistore?
Ja. De module is compatibel met PrestaShop 8 en 9, in single-shop en multistore, en meertalig, zonder Composer-afhankelijkheid of framework.