DF Swipe Gallery: productnavigatie met swipen
Installatie, configuratie en gebruik van het ontdekkingsdek met veeggebaren: verlanglijst, toevoegen aan de winkelwagen met een gebaar en statistieken.
Overzicht
DF Swipe Gallery maakt van de categoriepagina’s van uw PrestaShop-winkel een kaartenstapel op volledig scherm in Tinder-stijl. De bezoeker ontdekt de producten één voor één: swipe naar rechts om te liken (verlanglijst), naar links om over te slaan, omhoog om aan de winkelwagen toe te voegen. Een voortgangsbalk in storiesstijl toont de vordering en een eindscherm vat de favorieten van de sessie samen. Elke interactie voedt een dashboard in de backoffice.
De module werkt zonder afhankelijkheden: geen Composer, geen jQuery, geen externe dienst. Compatibel met PrestaShop 8.0 tot 9.x, multistore, vertaald in 8 talen (FR, EN, ES, DE, IT, NL, PL, PT).
Installatie
- Open in de backoffice Modules > Modulebeheer > Een module uploaden.
- Upload het bestand
dfswipegallery-1.3.0.zipen klik op Installeren. - De module maakt zijn twee tabellen aan (
df_swipegallery_likeendf_swipegallery_stat), registreert zijn hooks en voegt het tabblad Catalogus > Swipe Gallery toe.
Er is geen enkele themawijziging nodig: de startknop en de overlay worden geïnjecteerd via de hook displayFooterAfter, los van uw template.
Sinds 1.3.0 worden de knop en de overlay daarna rechtstreeks naar <body> verplaatst: rasters van het thema (zoals de Bootstrap-rij in de footer van Hummingbird) kunnen de knop niet meer vervormen.
Bijwerken
Upload de ZIP 1.3.0 over de geïnstalleerde module heen, vanaf elke versie (1.0.0, 1.1.0 of 1.2.0). De updatescripts worden na elkaar uitgevoerd: ze voegen ontbrekende kolommen, hooks en instellingen met hun standaardwaarden toe, zonder uw bestaande instellingen te wijzigen, en behouden uw likes en statistieken. Leeg daarna de cache van PrestaShop.
Sinds 1.1.0 telt de teller “Bekeken kaarten” alleen kaarten die echt bovenop de stapel kwamen (in 1.0.0 werden alle geladen kaarten geteld). Percentages op basis van de nieuwe gegevens zijn daardoor betrouwbaarder; een reset van de statistieken na de update wordt aanbevolen.
Configuratie
Open Modules > DF Swipe Gallery > Configureren. Beschikbare opties:
- Swipe gallery inschakelen: schakelt de module globaal in of uit.
- Alleen mobiele apparaten: beperkt de zwevende knop tot schermen smaller dan 992 px (standaard ingeschakeld). Schakel uit om de stapel ook op desktop aan te bieden.
- Maximum aantal producten per stapel: van 5 tot 100 (standaard 30).
- Volgorde van de stapel: positie in de categorie, willekeurig (aanbevolen om te ontdekken) of nieuwste eerst.
- Producten uit subcategorieën opnemen: net als de categorielijst toont de stapel ook de producten van zichtbare subcategorieën, na die van de categorie zelf (nieuw in 1.3.0, standaard ingeschakeld).
- Swipe omhoog voegt toe aan winkelwagen: schakelt de superlike in.
- Bezoeker de combinatie laten kiezen: bij producten met combinaties opent swipe omhoog een paneel om maat, kleur enz. te kiezen voordat het product in de winkelwagen gaat. Uitgeschakeld wordt de standaardcombinatie direct toegevoegd (nieuw in 1.2.0, standaard ingeschakeld).
- Al gelikete producten verbergen: laat producten die de bezoeker al leuk vond weg uit nieuwe stapels.
- Producten zonder voorraad verbergen: laat producten weg die door gebrek aan voorraad niet te bestellen zijn (nieuw in 1.1.0).
- Prijs op de kaarten tonen: toont de prijs, met de oorspronkelijke prijs doorgestreept bij een korting. Automatisch verborgen in catalogusmodus.
- Positie van de startknop: rechtsonder, linksonder of midden onder.
- Accentkleur: kleur van de startknop en van de knop Opnieuw beginnen (nieuw in 1.1.0). De tekstkleur past zich automatisch aan om leesbaar te blijven.
Voor een overtuigende demo kiest u de willekeurige volgorde, laat u swipe omhoog ingeschakeld en zet u Producten zonder voorraad verbergen aan: zo kan elke kaart in de winkelwagen belanden.

Gebruik in de winkel
Op elke categoriepagina verschijnt een zwevende knop “Swipemodus”. Bij een tik opent de stapel op volledig scherm:
- Swipe naar rechts (of hartknop): het product wordt geliket en op de verlanglijst gezet.
- Swipe naar links (of kruisknop): gaat naar het volgende product.
- Swipe omhoog (of winkelwagenknop): voegt het product toe aan de winkelwagen; bij een product met combinaties opent eerst een paneel om de combinatie te kiezen. Bij niet-beschikbare producten is de knop grijs.
- “Product bekijken”: opent de productpagina.
Een korte maar snelle beweging volstaat om een swipe te bevestigen. De kaarten tonen de labels “Al geliked” en “Niet beschikbaar” waar van toepassing. Op desktop bootsen de pijltoetsen de bewegingen na (rechts: liken, links: overslaan, omhoog: winkelwagen) en sluit Esc de stapel. Op mobiel sluit de terugknop van de telefoon de stapel in plaats van de pagina te verlaten.
Aan het einde van de stapel toont een overzichtsscherm de gelikete producten met hun prijs en een link naar elke pagina. De knop Opnieuw beginnen laadt een nieuwe stapel zonder de overlay te sluiten.
Toegankelijkheid: de focus gaat bij het openen naar de stapel en bij het sluiten terug naar de knop, tabben blijft binnen de stapel, het huidige product wordt aan schermlezers gemeld en animaties worden uitgeschakeld als de bezoeker prefers-reduced-motion heeft ingesteld.
Sinds 1.3.0 toont de hulptekst onder de kaarten op desktop de sneltoetsen. Een product dat personalisatie vereist (verplicht veld) krijgt het label “Te personaliseren”: het blijft zichtbaar en aanklikbaar, maar wordt via de productpagina aan de winkelwagen toegevoegd.






Verlanglijst, klanten en gasten
Elke like wordt opgeslagen in de tabel van de module, of hij nu van een ingelogde klant of van een gast komt (gekoppeld aan zijn PrestaShop-bezoekers-ID). Een unieke sleutel voorkomt dubbele regels, ook wanneer dezelfde klant meerdere apparaten gebruikt.
Is de officiële module blockwishlist geïnstalleerd en de klant ingelogd, dan wordt het product met zijn standaardcombinatie aan zijn standaardverlanglijst toegevoegd, die indien nodig automatisch wordt aangemaakt. Er is geen configuratie nodig.
Sinds 1.1.0 worden de likes van een gast bij het inloggen of registreren automatisch naar het klantaccount overgezet en daarna aan zijn blockwishlist-verlanglijst toegevoegd. De hooks actionAuthentication en actionCustomerAccountAdd regelen dit; een fout in deze stap blokkeert het inloggen nooit.
Toevoegen aan de winkelwagen met een swipe
De swipe omhoog voegt het product op de server toe volgens dezelfde regels als de standaardknop: door de bezoeker gekozen combinatie (of de standaardcombinatie als het paneel is uitgeschakeld), minimale hoeveelheid, controle van voorraad en toegangsrechten. De winkelwagen wordt indien nodig aangemaakt en in de sessie van de bezoeker bewaard.
Daarna wordt de winkelwagenbadge van het thema bijgewerkt via het standaardevent prestashop.emit('updateCart'), zonder het themavenster “product toegevoegd” te openen. Een melding bevestigt de toevoeging; kan het product niet worden toegevoegd, dan ziet de bezoeker waarom.
Producten met een verplicht personalisatieveld worden op de server geweigerd, net als bij de standaardwinkelwagen: de bezoeker ziet de melding “Dit product moet op de productpagina worden gepersonaliseerd voordat het aan de winkelwagen wordt toegevoegd.” (nieuw in 1.3.0).

De combinatie kiezen
Bij een product met combinaties openen swipe omhoog, de winkelwagenknop of de pijl omhoog een paneel onderaan het scherm. Kleuren verschijnen als kleurstalen (of met hun textuur als die is ingesteld in Catalogus > Attributen), andere attributen als knoppen, en een lange lijst van het type keuzelijst blijft een keuzelijst. De standaardcombinatie is vooraf geselecteerd.
Bij elke keuze werkt het paneel de afbeelding, de prijs (doorgestreept bij een korting) en de voorraad van de combinatie bij. Een waarde zonder voorraad is gedimd; een waarde die met de andere keuzes niet bestaat, is doorgestreept, en die kiezen schakelt over naar de dichtstbijzijnde bestaande combinatie, bij voorkeur een die op voorraad is. De toevoegknop blijft uitgeschakeld zolang de combinatie niet te bestellen is.
Esc, het kruisje of de terugknop van de telefoon sluiten het paneel zonder de stapel te verlaten. De gegevens worden bij de eerste opening geladen en voor de sessie in het geheugen bewaard. Op de server wordt de ontvangen combinatie gecontroleerd (die moet bij het product horen en in de winkel verkocht worden) en wordt de voorraad nagekeken, inclusief wat al in de winkelwagen zit.
Liken (swipe naar rechts) blijft direct: het product gaat met zijn standaardcombinatie naar de verlanglijst, zodat het swiperitme niet wordt onderbroken.

Statistieken in de backoffice
Het tabblad Catalogus > Swipe Gallery toont:
- De tellers: bekeken kaarten, likes, overgeslagen, toevoegingen aan de winkelwagen, geopende productpagina’s.
- De like-ratio (likes / (likes + overgeslagen)), de winkelwagenratio en de openingsratio van de productpagina per bekeken kaart.
- De 20 meest gelikete producten, met een link naar hun productpagina in de backoffice.
- De meest overgeslagen producten (minstens 5 swipes), gesorteerd op overslaanratio: goede kandidaten voor een betere hoofdfoto of een herziene prijs.
- De CSV-export van alle statistieken en een resetknop per winkel (de likes van bezoekers blijven behouden).
De statistieken van een verwijderd product worden automatisch opgeschoond. Er worden geen gegevens naar diensten van derden gestuurd.

AVG
De module meldt zich aan bij de officiële module psgdpr: likes die aan een klantaccount gekoppeld zijn, verschijnen in de export van persoonsgegevens en worden verwijderd bij een verzoek tot wissen. Ze worden ook gewist wanneer een klant in de backoffice wordt verwijderd. De statistieken zijn per product samengevoegd en bevatten geen persoonsgegevens.
Multistore en vertalingen
Likes en statistieken worden per winkel bijgehouden. De module wordt vertaald geleverd in 8 talen (Engels als brontaal, plus FR, ES, DE, IT, NL, PL, PT). Om een tekst aan te passen, gebruikt u Internationaal > Vertalingen > Vertalingen van geïnstalleerde modules.
Problemen oplossen
- De knop verschijnt niet: controleer of de module is ingeschakeld, of u op een categoriepagina bent en of “Alleen mobiele apparaten” uit staat als u op desktop test.
- De stapel is leeg: de categorie bevat geen actief zichtbaar product, is niet toegankelijk voor de klantgroep van de bezoeker, of alle producten worden uitgesloten door “Al gelikete producten verbergen” of “Producten zonder voorraad verbergen”.
- De winkelwagenbadge wordt niet bijgewerkt: uw thema luistert misschien niet naar het event
updateCart; het product zit wel in de winkelwagen, pas de listener van het thema aan of neem contact op met de support. - Een element van het thema ligt over de stapel: de overlay gebruikt een z-index van 100000; verhoog die via CSS als een cookiebanner of chatwidget hem bedekt.
- Na de update blijft het oude gedrag bestaan: leeg de cache van PrestaShop en van de browser; het updatescript reset ook OPcache als dat beschikbaar is.
- De stapel bevat minder producten dan de categorielijst: schakel “Producten uit subcategorieën opnemen” in en controleer het maximum aantal producten per stapel (standaard 30). Producten die alleen in de zoekfunctie zichtbaar zijn, worden nooit getoond.
- PrestaShop 9.1.5 in het Spaans met Hummingbird: fout op categoriepagina’s: dit ligt niet aan de module. Het officiële taalpakket es-ES bevat de foutieve vertaling “Subcategorías de %s%” in
translations/es-ES/ShopThemeCatalog.es-ES.xlf; vervang die door “Subcategorías de %s” en leeg daarna de cache.
Wijzigingslog
- 1.3.0 (2026-10-29): met Hummingbird (PrestaShop 9) verschijnt de knop “Swipemodus” niet meer als balk over de volle breedte; producten met verplichte personalisatie kunnen niet meer zonder personalisatie aan de winkelwagen worden toegevoegd (label “Te personaliseren”); optie “Producten uit subcategorieën opnemen” (standaard ingeschakeld, zoals de categorielijst); bij meer dan 60 kaarten blijft de sluitknop op mobiel zichtbaar; na “Product bekijken” volstaat één keer terug; toetsenbordhulp op desktop; ondoorzichtige achtergrond van de overlay. Gecontroleerd op PrestaShop 8.2.1 (Classic) en 9.1.5 (Hummingbird), PHP 7.4 tot 8.5.
- 1.2.0 (2026-10-13): keuze van de combinatie vóór het toevoegen aan de winkelwagen (kleurstalen, maten, prijs, afbeelding en voorraad per combinatie, niet-bestaande combinaties doorgestreept en automatische overstap naar de dichtstbijzijnde); optie “Bezoeker de combinatie laten kiezen”; duidelijke melding wanneer een combinatie niet op voorraad is; weergave onafhankelijk van de box-sizing van het thema.
- 1.1.0 (2026-10-13): de winkelwagen die met een swipe omhoog wordt aangemaakt, blijft nu bewaard; standaardcombinatie in winkelwagen en verlanglijst; geen venster “product toegevoegd” meer achter de stapel; automatische overdracht van gastlikes naar het klantaccount; betrouwbare statistieken (echt bekeken kaarten, geopende productpagina’s, meest overgeslagen producten, CSV-export, reset); opties “Producten zonder voorraad verbergen” en “Accentkleur”; doorgestreepte prijs; terugknop op mobiel, snelle veegbeweging, focusbeheer; AVG via psgdpr; vertalingen in 8 talen.
- 1.0.0 (2026-07-16): eerste versie. Swipestapel op volledig scherm, verlanglijst met swipe naar rechts en brug naar blockwishlist, toevoegen aan winkelwagen met swipe omhoog, ondersteuning voor gasten, dashboard, voortgangsbalk in storiesstijl, compatibel met PrestaShop 8 en 9, multistore.