Opgeslagen zoekopdrachten & meldingen nieuwe producten: documentatie
Installatie, configuratie en planning van de module dfsavedsearch: opgeslagen zoekopdrachten, e-mailmeldingen bij nieuwe producten, cron en AVG-conformiteit.
Overzicht
De module Opgeslagen zoekopdrachten & meldingen (dfsavedsearch) laat je klanten een combinatie van zoekcriteria opslaan (zoekwoorden, categorie, fabrikant, prijsbereik, beschikbaarheid) en automatisch een e-mail ontvangen zodra er een nieuw passend product in je winkel wordt gepubliceerd.
De opslagknop verschijnt ook als de zoekopdracht geen enkel product vindt. Dat is het belangrijkste gebruik: de klant zoekt een artikel dat niet in de catalogus staat, vraagt om een melding en komt terug op de dag dat je het publiceert. Een anti-dubbellogboek zorgt ervoor dat de klant alleen meldingen krijgt over producten die na het opslaan van zijn zoekopdracht zijn gepubliceerd, en nooit twee keer over hetzelfde product.
Kort samengevat: zoekopdracht opslaan met één klik op de resultatenpagina, woord-voor-woord matching, prijsfilter incl. of excl. btw, e-mailmelding met uitdrukkelijke toestemming, dagelijks of wekelijks overzicht via een cron-taak op je eigen server.
Installatie
- Open in je back-office Modules > Modulebeheer en klik op Een module uploaden.
- Selecteer het archief
dfsavedsearch-1.1.0.zipen bevestig. - Bij de installatie maakt de module twee SQL-tabellen, een beheertabblad en de standaardconfiguratie aan. Een cron-token van 32 tekens wordt automatisch gegenereerd.
- De module is direct actief. Er zijn geen externe afhankelijkheden nodig (geen Composer, geen framework).
Bijwerken naar 1.1.0: upload dfsavedsearch-1.1.0.zip over de geïnstalleerde versie. Je zoekopdrachten, meldingen en instellingen blijven behouden. Het updatescript voegt een kolom voor de cron toe, vertaalt het beheertabblad en leegt de CSS/JS-cache van PrestaShop zodat de nieuwe bestanden worden gebruikt. Versie 1.0.0 bevatte een conflict in klassennaam waardoor installeren niet lukte: is een poging mislukt, verwijder dan de map modules/dfsavedsearch voordat je 1.1.0 uploadt.
De module werkt met PrestaShop 8.0 tot 9.x en PHP 8.1 tot 8.5, in een enkele winkel of multistore. Interface en e-mails zijn vertaald in FR, EN, ES, DE, IT, NL, PL en PT.
Configuratie (back-office)
Ga naar de configuratiepagina van de module (Modules > Modulebeheer > dfsavedsearch > Configureren). De beschikbare instellingen zijn:
- Module inschakelen: schakelt de weergave van de knop en het verzenden van meldingen in of uit.
- Max. producten per e-mailoverzicht: maximumaantal producten in één meldingsmail (standaard 12).
- Max. opgeslagen zoekopdrachten per klant: maximumaantal zoekopdrachten dat een klant kan opslaan (standaard 20).
- Standaard meldingsfrequentie: dagelijks of wekelijks, voor nieuwe zoekopdrachten.
- Prijsfilters incl. btw: « Ja » vergelijkt de min./max. prijzen die de klant invoert met de normale prijs incl. btw, berekend met het btw-tarief van het standaardland. « Nee » vergelijkt met de prijs excl. btw, wat past bij B2B. Bij installatie volgt deze instelling de prijsweergave van de standaard klantgroep. Promoties worden niet meegenomen. Als belastingen in de winkel zijn uitgeschakeld, wordt altijd excl. btw vergeleken.
- Cron-token: zichtbaar weergegeven, met een knop om opnieuw te genereren. De volledige cron-URL en de datum van de laatste uitvoering staan in een apart paneel.
De waarden worden opgeslagen in de configuratievariabelen DFSAVEDSEARCH_ENABLED, DFSAVEDSEARCH_MAX_PRODUCTS, DFSAVEDSEARCH_MAX_PER_CUST, DFSAVEDSEARCH_DEFAULT_FREQ, DFSAVEDSEARCH_PRICE_TAX, DFSAVEDSEARCH_CRON_TOKEN en DFSAVEDSEARCH_LAST_CRON.

Gebruik door de klant
Op de pagina met zoekresultaten wordt automatisch een knop « Deze zoekopdracht opslaan » toegevoegd, met of zonder resultaten. Na een klik opent de klant een venster waarin hij:
- zijn zoekopdracht een naam geeft;
- zijn criteria preciseert: zoekwoorden, categorie (inclusief subcategorieën), fabrikant, minimum- en maximumprijs (met vermelding incl. of excl. btw), alleen producten op voorraad;
- desgewenst de e-mailmelding inschakelt en de frequentie kiest.
De e-mailmelding vereist een vakje voor uitdrukkelijke toestemming, standaard uitgevinkt, met een duidelijke toestemmingstekst. Een niet-ingelogde bezoeker wordt gevraagd in te loggen en keert daarna terug naar zijn zoekopdracht.




Hoe producten worden gevonden
De module splitst de zoekopdracht in woorden (minimaal twee tekens, maximaal acht woorden). Elk woord moet voorkomen in de naam, de korte omschrijving of de referentie van het product, in willekeurige volgorde. Hoofdletters en accenten worden genegeerd. Een zoekopdracht « nike pegasus 41 » vindt dus « Nike Air Zoom Pegasus 41 », maar niet « Pegasus Trail », dat « nike » niet bevat.
Een product telt mee als het actief is in de winkel, zichtbaar in de zoekfunctie (zichtbaarheid « Overal » of « Alleen zoeken ») en een naam heeft in de taal die de klant gebruikte bij het opslaan. De cron leest de catalogus rechtstreeks: een product dat in de back-office, via de webservice, een CSV-import of een ERP is aangemaakt, geeft op dezelfde manier een melding. Een product dat later gaat overeenkomen (geactiveerd, hernoemd, weer op voorraad) geeft ook een melding, één keer.
De sectie « Mijn opgeslagen zoekopdrachten »
Via de hook displayCustomerAccount wordt in het klantaccount een item « Mijn opgeslagen zoekopdrachten » toegevoegd. Daar vindt de klant al zijn opgeslagen zoekopdrachten en kan hij per zoekopdracht:
- de e-mailmelding in- of uitschakelen;
- de frequentie wijzigen (dagelijks of wekelijks);
- de zoekopdracht verwijderen.
De criteria van elke zoekopdracht worden als duidelijke labels getoond (categorie, fabrikant, prijsbereik incl. of excl. btw, op voorraad).
Sinds 1.1.0 is de naam van elke zoekopdracht een link die de zoekopdracht opnieuw uitvoert, bedragen worden met de valuta van de winkel getoond en op mobiel wordt de lijst als kaarten weergegeven. Met Hummingbird, het standaardthema van PrestaShop 9, past het item in het accountoverzicht en het accountmenu, met actieve status. Slaat de klant precies dezelfde zoekopdracht een tweede keer op, dan wordt die bijgewerkt in plaats van gedupliceerd.



De cron plannen (meldingen verzenden)
Het verzenden van e-mails wordt aangestuurd door een cron-taak die met een token is beveiligd. Stel de taakplanner van je server (of een cron-dienst) in om de volgende URL aan te roepen:
https://jouw-winkel.nl/index.php?fc=module&module=dfsavedsearch&controller=cron&token=JOUW_TOKEN
Vervang JOUW_TOKEN door het token uit de moduleconfiguratie.
Aanbevolen frequentie: roep de URL elk uur aan. De module respecteert daarna de eigen frequentie van elke zoekopdracht (dagelijks of wekelijks): de datum van de laatste verzending wordt alleen bijgewerkt als er echt een e-mail is verstuurd.
De verwerking gebeurt om beurten in batches van 200 zoekopdrachten: een zoekopdracht zonder nieuws gaat terug naar het einde van de wachtrij, zodat alle zoekopdrachten worden gecontroleerd, ook boven 200 actieve meldingen. Een vergrendeling voorkomt dat twee gelijktijdige uitvoeringen dezelfde e-mail twee keer versturen. De uitvoer van de cron toont het aantal verwerkte zoekopdrachten, verzonden e-mails en eventuele fouten, die in de PrestaShop-logs worden vastgelegd. De e-mail, de onderwerpregel en de prijsnotatie volgen de taal van de klant.
Houd je cron-token geheim. Is het uitgelekt, genereer het dan met één klik opnieuw in de configuratie: de oude URL werkt dan niet meer.

Lijst van zoekopdrachten in de back-office
Het menu Klanten > Opgeslagen zoekopdrachten toont alle zoekopdrachten: klant, naam en zoekterm, criteria (categorie, merk, prijs, voorraad), verzendtaal, melding en frequentie, aantal al gemelde producten en datum van de laatste verzending. Een paneel toont de cron-URL met een knop « Nu uitvoeren ». De lijst kan naar CSV worden geëxporteerd en ondersteunt verwijderen in bulk.

AVG-conformiteit
- Uitdrukkelijke toestemming: de e-mailmelding wordt nooit ingeschakeld zonder bewuste actie van de klant (vakje standaard uitgevinkt).
- Afmelden met één klik: elke e-mail bevat een ondertekende afmeldlink die de melding zonder inloggen uitschakelt.
- Export en verwijdering: de module gebruikt de AVG-hooks van PrestaShop (psgdpr) voor export en verwijdering van persoonsgegevens.
- Automatisch opschonen: bij het verwijderen van een klantaccount worden al zijn opgeslagen zoekopdrachten verwijderd.

Thema’s en compatibiliteit
Je hoeft geen templates aan te passen. De knop en het venster worden gegenereerd door de standaardhook displayFooter, waarna de knop direct boven #js-product-list-top wordt geplaatst. Bestaat dat blok niet, dan probeert de module #main .page-header, #main h1 en daarna het begin van #main. De knop blijft staan na sorteren of facetfilteren via AJAX.
- PrestaShop 8.0 tot 9.x, PHP 8.1 tot 8.5, multistore. Getest met de thema’s Classic en Hummingbird.
- De zoekterm wordt gelezen uit
sen anders uit de historische parametersearch_query. - Gebruikte hooks:
displayCustomerAccount,actionFrontControllerSetMedia,displayFooter,actionObjectCustomerDeleteAfter,actionDeleteGDPRCustomer,actionExportGDPRData. - Beheertabblad
AdminDfSavedSearchonder het menu Klanten. - Geen afhankelijkheden: handmatige PSR-4-autoloader, vanilla JS, geen externe dienst.
Footers die met een page builder zijn gebouwd en displayFooter niet aanroepen, worden niet ondersteund: de knop verschijnt dan niet.
Problemen oplossen
- Er wordt geen e-mail verzonden: controleer of de cron echt wordt aangeroepen (datum van de laatste uitvoering in de configuratie), of de module is ingeschakeld en of de e-mailconfiguratie van PrestaShop werkt.
- De knop verschijnt niet: hij wordt alleen op de zoekresultatenpagina getoond. Controleer of de module is ingeschakeld en je thema
displayFooteraanroept, en leeg daarna de PrestaShop-cache. - Een klant krijgt geen melding: controleer of de melding voor die zoekopdracht actief is, of elk woord van de zoekopdracht in de naam, korte omschrijving of referentie van het nieuwe product staat en of het product na het opslaan is gepubliceerd.
- Het prijsfilter lijkt niet te kloppen: controleer de instelling « Prijsfilters incl. btw ». De vergeleken prijs is de normale prijs, zonder promoties.
Versiegeschiedenis
- 1.1.0 (29 oktober 2026): opslagvenster en link « Mijn opgeslagen zoekopdrachten » aangepast aan het Hummingbird-thema van PrestaShop 9, stijlen geladen op de accountpagina, prijzen in de e-mail in de notatie van de klanttaal, cron om beurten met vergrendeling tegen dubbele verzending, identieke zoekopdrachten samengevoegd, klikbare naam om opnieuw te zoeken, prijzen met valuta, kaartweergave op mobiel, back-officelijst met criteria en taal, beheertabblad vertaald in 8 talen, afmeldpagina niet geïndexeerd, weergavecorrecties voor Classic.
- 1.0.1 (27 oktober 2026): oplossing van het conflict in klassennaam dat installeren blokkeerde, woord-voor-woord matching, prijsfilter incl. of excl. btw, stabiele knop na sorteren of filteren via AJAX, ondersteuning van
search_query, vertalingen in 8 talen met de onderwerpregel in de taal van de klant, gevalideerd op PHP 8.3 en 8.4. - 1.0.0 (15 juli 2026): eerste versie.