PS PrestaShop Beginner

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.

Bijgewerkt Moduleversie 2.0.0

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

  1. Klik in Modules > Modulebeheer op Een module uploaden en sleep het bestand dfclearcart-2.0.0.zip erin.
  2. 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.

Winkelwagenpagina met de knop „Winkelwagen legen” onder de producten, thema Hummingbird
Knop „Winkelwagen legen” onder de producten

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.

Toegankelijke bevestiging: aantal artikelen, bedrag van de winkelwagen en ongedaan maken mogelijk
Toegankelijke bevestiging

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.

Winkelwagen geleegd zonder herladen, met de knop „Ongedaan maken” en het aftellen
Geleegde winkelwagen en ongedaan maken

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.

Op mobiel: bevestiging onderaan het scherm, daarna enkele seconden ongedaan te maken
Winkelwagen legen op mobiel

Configuratie

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

Instellingen: bevestiging, ongedaan maken, weergavedrempel, behouden kortingscodes en live voorbeeld
Instellingen en live voorbeeld

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).

Positie naar keuze: hier de knop naast de titel van de winkelwagen
Knop naast de winkelwagentitel
Positie, stijl, kleur met contrastcontrole en teksten per taal
Weergave en teksten per taal

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.

Anonieme statistieken over 30 dagen: geleegde winkelwagens, herstellingen, verwijderde artikelen (demogegevens)
Anonieme statistieken (demogegevens)

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.

Was deze pagina nuttig?

Loopt u nog vast? Neem contact op met support