Knop Winkelwagen legen — Complete handleiding
De knop „Winkelwagen legen” met toegankelijke bevestiging en ongedaan maken installeren, instellen en gebruiken in PrestaShop 1.7.8, 8 en 9.
Overzicht
De module Knop Winkelwagen legen (dfclearcart) voegt op de winkelwagenpagina een knop „Winkelwagen legen” toe. De klant leegt de winkelwagen met één klik, zonder de pagina te herladen, en kan het enkele seconden ongedaan maken: producten, combinaties, personalisaties, kortingsbonnen en cadeaus komen precies terug zoals ze waren.
Nieuw in 2.0.0: ondersteuning van PrestaShop 1.7.8, legen zonder herladen, ongedaan maken, toegankelijke bevestiging, keuze van positie en stijl, behouden kortingscodes, anonieme statistieken, 8 talen en betere beveiliging (alleen POST, sessiegebonden token).
Compatibiliteit
- PrestaShop 1.7.8 tot 9.x, PHP 7.1 tot 8.5
- Thema’s Classic, Hummingbird en child-thema’s
- Multistore (instellingen en statistieken per winkel), meerdere valuta
- 8 talen: FR, EN, ES, DE, IT, PT, PL, NL
- JavaScript en stylesheet worden alleen op de winkelwagenpagina geladen
Installatie en update
- Klik in Modules > Modulebeheer op Een module uploaden en sleep het bestand
dfclearcart-2.0.0.ziperin. - Klik op Configureren.
Update vanaf 1.x: upload het zip-bestand 2.0.0 over de oude module. Uw instellingen en aangepaste teksten blijven behouden. Alleen ongewijzigde standaardteksten worden vervangen: het Franse „Vider le panier” dat in een andere taal was gekopieerd, wordt de tekst van die taal, en de oude waarschuwing „Deze actie is onomkeerbaar” wordt het nieuwe bericht, omdat de winkelwagen nu kan worden hersteld. De cache van de gecombineerde CSS/JS-bestanden wordt geleegd.
In de winkel
De knop
De knop verschijnt op de winkelwagenpagina zodra de winkelwagen het gekozen aantal artikelen bevat (cadeaus tellen niet mee). Hij verdwijnt of verschijnt opnieuw wanneer de klant de aantallen wijzigt.

De bevestiging
Als de bevestiging is ingeschakeld, toont een dialoogvenster het aantal artikelen en het totaal. Het is toegankelijk: rol alertdialog, gekoppelde titel en tekst, focus eerst op „Annuleren”, focusval (Tab en Shift+Tab), Esc-toets, klik op de achtergrond en focus terug naar de knop bij het sluiten.

Legen en ongedaan maken
De winkelwagen wordt via AJAX geleegd. De module vraagt het thema de winkelwagen te verversen zoals na een gewone verwijdering: regels, totalen, teller in de header en mini-winkelwagen worden bijgewerkt. Een paneel meldt „Uw winkelwagen is geleegd”, met een aftelling, de knop Ongedaan maken en de knop Verder winkelen. Het resultaat wordt ook aan schermlezers gemeld.

Ongedaan maken herstelt de winkelwagen exact: aantallen, combinaties, leveradressen, tekst- en bestandspersonalisaties, kortingsbonnen en cadeaus, gekozen vervoerder, cadeauverpakking en bericht. Is een product intussen niet meer beschikbaar, dan wordt de rest hersteld en krijgt de klant een melding. Ongedaan maken kan maar één keer.
Op mobiel
Op mobiel opent de bevestiging onderaan het scherm met grote knoppen, en het paneel voor ongedaan maken gebruikt de volle breedte.

Configuratie
De configuratiepagina bundelt de instellingen, een live voorbeeld (winkelwagen, bevestiging, na het legen) en de statistieken.

Gedrag
- Knop tonen: toont of verbergt de knop.
- Om bevestiging vragen: opent het dialoogvenster vóór het legen.
- „Ongedaan maken” aanbieden: 3 tot 60 seconden (standaard 10).
- Tonen vanaf: minimum aantal artikelen in de winkelwagen.
- Kortingscodes behouden: PrestaShop verwijdert kortingsbonnen uit een lege winkelwagen; met deze optie worden de door de klant ingevoerde codes bij de volgende toevoeging automatisch opnieuw toegepast als ze nog geldig zijn.
Weergave
Kies de positie (onder de producten, naast de titel van de winkelwagen, in het besteloverzicht), de stijl (knop met rand, discrete link, alleen pictogram) en de accentkleur. Het contrast van de kleur op wit wordt live berekend; mik op minstens 4,5:1 (WCAG AA).


Na het legen
De klant blijft in de winkelwagen, die het resultaatpaneel toont, of wordt doorgestuurd naar de startpagina of naar een gekozen categorie. Met ongedaan maken gebeurt de doorverwijzing na afloop van de termijn of zodra de klant op „Verder winkelen” klikt.
Teksten
De tekst van de knop, de titel, de tekst en de knop van de bevestiging en het bericht na het legen worden per taal ingesteld. De link „Standaardteksten van deze taal gebruiken” zet de meegeleverde teksten voor de 8 talen terug.
Google Analytics 4
In de automatische modus stuurt de module de gebeurtenis remove_from_cart naar de dataLayer met de lijst van artikelen, de valuta en de waarde, en na een volledige herstelling add_to_cart. Is Google Tag Pro (dfgtagmanager) ingeschakeld, dan verstuurt die deze gebeurtenissen zelf: de module verdubbelt ze niet. Op het document worden ook de JavaScript-gebeurtenissen dfclearcart:cleared en dfclearcart:restored verstuurd.
Statistieken
De module telt per winkel en per dag de geleegde winkelwagens, de herstellingen, de verwijderde artikelen en de waarde (incl. btw) van de geleegde winkelwagens. Het zijn anonieme tellers: er wordt geen klant, winkelwagen of IP-adres opgeslagen.

Technische werking
Eerst worden de winkelwagenregels verwijderd (hun cadeaus gaan mee), daarna wordt elke regel verwijderd zoals PrestaShop dat doet, met de hooks actionObjectProductInCartDeleteBefore en actionObjectProductInCartDeleteAfter. De verzendoptie en cadeauverpakking worden gereset, zoals de core doet wanneer de winkelwagen leeg wordt. Een cadeau dat automatisch door een winkelwagenregel is toegevoegd, komt niet vanzelf terug.
De knop wordt weergegeven via de hooks displayShoppingCartFooter of displayShoppingCart; roept het thema ze niet aan, dan voegt het script hem zelf in de winkelwagenpagina in.
Beveiliging en gegevens
- Alleen POST-verzoeken van de winkel zelf worden aanvaard (header
X-Requested-With, controle van de herkomst). - Het token is gebonden aan de winkelwagen, de klant en een sessiegeheim in het versleutelde PrestaShop-cookie: het token van een andere bezoeker wordt geweigerd.
- De module werkt alleen op de winkelwagen van de bezoeker. Een winkelwagen die al een bestelling is, wordt nooit gewijzigd.
- Elke winkelwagen is beperkt tot 30 legingen of herstellingen per 10 minuten.
- Tijdens de termijn voor ongedaan maken worden personalisatiebestanden in de beveiligde map
upload/bewaard en daarna verwijderd. - Bij het verwijderen van de module worden tabellen, instellingen en tijdelijke bestanden gewist.
Probleemoplossing
De knop verschijnt niet
Controleer of Knop tonen is ingeschakeld en of de winkelwagen minstens het aantal artikelen bevat dat bij Tonen vanaf is ingesteld. Leeg de PrestaShop-cache (Geavanceerde parameters > Prestaties).
Na de update verschijnt nog de oude knop
De update leegt de cache van de gecombineerde bestanden. Bewaart een servercache of CDN nog een oude kopie, leeg die dan ook.
„Uw sessie is gewijzigd”
Het token is gebonden aan de sessie: heeft de klant zich in een ander tabblad aan- of afgemeld, dan volstaat het de winkelwagenpagina opnieuw te laden.
Ongedaan maken herstelt een product niet
Het product is niet meer beschikbaar (voorraad, uitgeschakeld): de rest van de winkelwagen wordt hersteld en een bericht meldt het.