PS PrestaShop Beginner

Verjaardagskorting: documentatie van de PrestaShop-module

De module installeren, de verjaardagscampagnes instellen, de dagelijkse verzending plannen en de gegenereerde omzet bekijken.

Bijgewerkt Moduleversie 2.0.2

Overzicht

De module stuurt je klanten automatisch een persoonlijke kortingscode bij drie gelegenheden: hun verjaardag, het jubileum van hun eerste geldige bestelling en het jubileum van het aanmaken van hun account. Elke code is een native PrestaShop-winkelwagenregel, voorbehouden aan de klant en eenmaal bruikbaar. Daarna meet de module de omzet van de bestellingen die met deze codes zijn geplaatst.

Compatibiliteit: PrestaShop 1.7.8 tot 9.x (PHP 7.4 tot 8.5), thema’s Classic en Hummingbird, multistore, 8 talen (Engels, Frans, Spaans, Duits, Italiaans, Nederlands, Pools, Portugees).

Nieuw in versie 2.0.2: e-mailbericht opgemaakt met de PrestaShop-editor of rechtstreeks in HTML geschreven.

Nieuw in versie 2.0.1: keuze van de producten waarop elke campagne geldt (hele catalogus, alleen bepaalde producten en categorieën, of alles behalve bepaalde), vermeld voor de klant in de e-mail.

Nieuw in versie 2.0.0: installatieassistent, kalender van speciale dagen, echt e-mailvoorbeeld (computer en mobiel), simulatie van een gekozen dag, pauze van de verzending, vrij te kiezen adres voor test-e-mails, afmeldlink zonder inloggen in elke e-mail, verwijderen van de geboortedatum door de klant, datums voluit in de taal van de klant, ondersteuning van PrestaShop 1.7.8 en Hummingbird. Versie 2.0.0 herstelt ook het opslaan van de back-office-instellingen en de filters in PrestaShop 9.

Installatie

  1. Klik in Modules > Modulebeheer op Upload een module en verstuur het ZIP-bestand.
  2. De module maakt twee tabellen aan, registreert zijn hooks, genereert het token van de geplande taak en kopieert de e-mailsjablonen voor elke geïnstalleerde taal.
  3. In het menu Klanten verschijnt het nieuwe tabblad Verjaardagen en speciale dagen. De knop Configureren van de module leidt er ook naartoe.

Om van een 1.x-versie naar 2.0.2 te gaan, upload je gewoon het nieuwe ZIP-bestand. Je campagnes, teksten, codegeschiedenis en statistieken blijven behouden; een winkel die zijn campagnes nooit had opgeslagen, houdt de verjaardags- en eerstebestellingscampagne ingeschakeld, zoals in 1.x.

De installatieassistent

Bij een nieuwe installatie is geen enkele campagne actief: er wordt niets naar je klanten verstuurd zolang je niet op Mijn campagnes activeren klikt. Het dashboard toont een assistent in drie stappen: de gelegenheden en hun korting kiezen, de automatisering kiezen (geplande taak en terugval via winkelbezoeken, vraag naar de geboortedatum na de bestelling) en daarna het adres voor test-e-mails invullen en activeren. De link Overslaan, ik stel het zelf in leidt direct naar het tabblad Campagnes.

Installatieassistent: keuze van gelegenheden en aanbiedingen, automatisering, test en activering
Installatieassistent: keuze van gelegenheden en aanbiedingen, automatisering, test en activering

Daarna toont het dashboard de checklist “Aan de slag” zolang de vier belangrijkste stappen niet zijn uitgevoerd: een campagne inschakelen, jezelf een test-e-mail sturen, de dagelijkse taak inplannen en geboortedata verzamelen.

De campagnes instellen

Het tabblad Campagnes bevat één kaart per gelegenheid. Schakel hem in met de schakelaar rechtsboven: de instellingen en het voorbeeld van de e-mail verschijnen.

Het aanbod

  • Type korting: percentage, vast bedrag (in de standaardvaluta) of gratis verzending.
  • Waarde en Ook gratis verzending aanbieden bovenop een percentage of bedrag.
  • Minimaal bestelbedrag (incl. btw): 0 voor geen minimum.
  • Geldigheid na de datum: aantal dagen dat de code geldig blijft vanaf de datum van de gelegenheid.
  • Vooraf versturen: aantal dagen voor de datum. 0 verstuurt op de dag zelf.
  • Verhoging per extra jaar en Maximale waarde (bestel- en accountjubileum): bijvoorbeeld 10 % het eerste jaar, +2 per jaar, maximaal 20 %.
  • Producten die al in de aanbieding zijn uitsluiten en Combineerbaar met andere kortingsbonnen.

Producten waarop de code geldt

Standaard geldt de code voor de Hele catalogus. Kies Alleen bepaalde producten of Alles behalve bepaalde producten en voeg categorieën (inclusief subcategorieën) en producten toe door ze op naam, referentie of ID te zoeken. Het aantal betrokken producten verschijnt onder de selectie, en de e-mail vermeldt voor de klant op welke producten de code geldt.

  • Percentage: de korting geldt alleen voor de betrokken producten; de andere producten in de winkelwagen behouden hun prijs.
  • Vast bedrag of gratis verzending: de code wordt geaccepteerd zodra de winkelwagen minstens één betrokken product bevat.
  • Met Alles behalve bepaalde producten, of met categorieën en producten tegelijk, wordt de productlijst vastgelegd bij het verzenden van de code: een product dat later aan de catalogus wordt toegevoegd, valt niet onder al verzonden codes.

Onder PrestaShop 1.7 wordt het percentage van een selectie berekend op de prijs vóór de eigen kortingen van het product. Vink Producten die al in de aanbieding zijn uitsluiten aan, zodat een product in de aanbieding niet beide kortingen krijgt.

Wie ontvangt het

  • Minimaal aantal geldige bestellingen: 0 bij de verjaardag neemt ook klanten mee die nog nooit hebben besteld.
  • Codeprefix: BDAY geeft bijvoorbeeld codes als BDAY-7KQ2M9.
  • Klantgroepen: niets aangevinkt betekent alle groepen.

De e-mail

Pas onderwerp, titel en bericht per taal aan via de taaltabbladen. Het voorbeeld rechts toont het echte e-mailsjabloon zoals de klant het ontvangt, met de werkelijke korting; het wordt bijgewerkt terwijl je typt en schakelt met het telefoonicoon naar mobiele breedte. De tagknoppen voegen de tag in op de plaats van de cursor. Beschikbare tags: {firstname}, {lastname}, {discount}, {code}, {expiry_date}, {min_amount}, {years} (behalve verjaardag) en {shop_name}. Een leeg veld gebruikt de standaardtekst van de taal.

De knop Opslaan en test versturen stuurt de e-mail, in de taal van de medewerker, naar het adres in het veld Test-e-mails worden verzonden naar bovenaan het tabblad (standaard dat van de ingelogde medewerker).

Het Bericht schrijf je met de PrestaShop-editor: vet, kleuren, lijsten, links, tabellen, koppen en afbeeldingen uit het bestandsbeheer. Met de knop <> schrijf of plak je HTML. Bij het opslaan verwijdert de module wat in een e-mail een risico vormt (scripts, formulieren, ingesloten frames, javascript:-links), maakt hij links en afbeeldingen absoluut en maakt hij de tekstversie van de e-mail aan. Tags worden op de cursorpositie ingevoegd en werken ook in HTML. Een bericht dat vóór 2.0.2 is opgeslagen, blijft platte tekst en wordt verzonden zoals voorheen.

Verjaardagscampagne: aanbod, targeting per groep, teksten in 8 talen en echt e-mailvoorbeeld
Verjaardagscampagne: aanbod, targeting per groep, teksten in 8 talen en echt e-mailvoorbeeld

De kalender van speciale dagen

Het tabblad Kalender toont de maand met per dag het aantal klanten dat een verjaardag, het jubileum van de eerste bestelling of een accountjubileum viert. Hij past dezelfde filters toe als de verzending: groepen, minimaal aantal bestellingen, gasten, nieuwsbriefabonnees en afgemelde klanten. Klik op een dag om de lijst van klanten te zien met hun aanbod en de status van de code: gepland (met de verzenddatum als vooraf wordt verstuurd), code verzonden, gebruikt of niet verzonden. De knop Simuleren start de simulatie van die dag. De wachttijd na een wijziging van de geboortedatum wordt op de verzenddag gecontroleerd.

Kalender van speciale dagen: verjaardagen en jubilea per dag, klanten van de dag en status van de codes
Kalender van speciale dagen: verjaardagen en jubilea per dag, klanten van de dag en status van de codes

De dagelijkse verzending plannen

Kopieer in Automatisering en instellingen de URL van de geplande taak en roep hem eenmaal per dag aan, bij voorkeur vroeg in de ochtend. Voorbeeld van een cronregel:

0 7 * * * curl -s "https://jouw-winkel.nl/module/dfkeydates/cron?token=JOUW_TOKEN" >/dev/null

Elke uitvoering maakt de codes van de dag aan, verstuurt de e-mails en herinneringen, koppelt gebruikte codes aan hun bestelling en verwijdert verlopen, ongebruikte codes.

  • Inhalen van gemiste dagen (standaard 2): als de taak niet heeft gedraaid, worden de data van de voorgaande dagen verwerkt.
  • Maximaal aantal codes per uitvoering (standaard 200): de rest wordt bij de volgende uitvoering verstuurd.
  • Ook uitvoeren bij winkelbezoeken: zonder cronjob draait de module bij winkelbezoeken, maximaal eenmaal per uur en nadat de pagina is verstuurd. Hij stopt zodra er in de laatste 26 uur een echte cronjob is aangeroepen.

Op dezelfde pagina toont Simuleren de codes die zouden vertrekken op de dag die je kiest in het veld Te simuleren dag, zonder iets aan te maken of te versturen. De knoppen Nu uitvoeren, Gebruikte codes opnieuw synchroniseren en Nieuw token vullen de kaart aan, die ook aangeeft of de geplande taak is gedetecteerd en wat de tijdzone van de winkel is: de datums volgen de tijdzone uit Internationaal > Lokalisatie, niet die van de server.

Verzending pauzeren tot zet de verzending stil tijdens een sluiting of vakantie. Een melding herinnert er op elk tabblad aan. Tijdens de pauze gemiste dagen worden ingehaald binnen de inhaallimiet.

Elke klant ontvangt maximaal één code per gelegenheid en per jaar. Je kunt de taak dus meerdere keren starten zonder risico op dubbele codes.

Simulatie van een gekozen dag en geplande taak: cron-URL, laatste uitvoering en tijdzone van de winkel
Simulatie van een gekozen dag en geplande taak: cron-URL, laatste uitvoering en tijdzone van de winkel

Bescherming tegen misbruik en verzamelen van geboortedata

De wachttijd na registratie of wijziging van de verjaardag (standaard 30 dagen) blokkeert de verjaardagscode voor een account dat te nieuw is of waarvan de datum net in de winkel is ingevuld of gewijzigd. Wijzigingen door een medewerker in de back-office activeren deze wachttijd niet.

De geboortedata komen uit het native veld van het klantaccount (Klanten > Instellingen > Geboortedatum). Is dat veld uitgeschakeld, dan verzamelt de module ze zelf:

  • op de orderbevestigingspagina, als de datum onbekend is (optie Vraag naar de geboortedatum op de orderbevestigingspagina als die onbekend is);
  • op de pagina Mijn cadeaus en speciale dagen in het klantaccount.

Het dashboard toont het percentage accounts met een bekende datum. Op de orderbevestigingspagina wordt de datum opgeslagen zonder de pagina te verlaten; de vraag vermeldt dat ze optioneel is en alleen voor het verjaardagscadeau dient. Ze wordt niet getoond aan een klant die zich voor deze e-mails heeft afgemeld.

Orderbevestiging: optionele vraag naar de geboortedatum, opgeslagen zonder de pagina te verlaten
Orderbevestiging: optionele vraag naar de geboortedatum, opgeslagen zonder de pagina te verlaten

Herinnering voor het verlopen

Schakel de herinnering in en kies hoeveel dagen voor het verlopen hij wordt verstuurd. Hij gaat alleen uit als de code niet is gebruikt. De teksten van de herinnering en de knoptekst van alle e-mails stel je per taal in. De knop Testherinnering versturen slaat de instellingen op en stuurt je een voorbeeld.

Verzendregels, pauze van de verzending en herinnering voor het verlopen met e-mailvoorbeeld
Verzendregels, pauze van de verzending en herinnering voor het verlopen met e-mailvoorbeeld

Code met één klik

De knop in elke e-mail verwijst naar een ondertekende link die bij de code hoort. De module onthoudt de code en zet hem in de winkelwagen zodra de klant is ingelogd en producten in de winkelwagen heeft. Is de klant niet ingelogd, dan gaat hij naar de inlogpagina. Is het minimale bestelbedrag niet bereikt, dan wacht de code en wordt hij toegepast zodra dat wel zo is. Een verlopen code, een al gebruikte code of een code voor een andere klant wordt met een melding geweigerd.

De datums in de e-mails worden voluit geschreven in de taal van de klant (bijvoorbeeld “4 december 2026”). Elke e-mail bevat een link Mijn aanbiedingen voor speciale dagen beheren en een link Deze cadeau-e-mails niet meer ontvangen die zonder inloggen werkt.

Ontvangen verjaardagsmail: persoonlijke code, korting, geldigheid, knop om met één klik toe te passen en afmeldlink
Ontvangen verjaardagsmail: persoonlijke code, korting, geldigheid, knop om met één klik toe te passen en afmeldlink

De klantpagina “Mijn cadeaus en speciale dagen”

Bereikbaar via Mijn account, toont deze pagina de actieve codes met een kopieerknop en een knop Gebruiken in mijn winkelwagen, de komende speciale dagen van de klant met een aftelling, het formulier voor de geboortedatum met een link Mijn geboortedatum verwijderen, eerdere cadeaus en een schakelaar om deze e-mails wel of niet te ontvangen. Een code die binnen 3 dagen verloopt, wordt gemarkeerd. De pagina past zich aan de thema’s Classic en Hummingbird en aan mobiel aan. Je kunt hem in de instellingen verbergen; de link verschijnt in Mijn account alleen als er minstens één campagne actief is.

Klantenzone: link "Mijn cadeaus en speciale dagen" in het accountmenu
Klantenzone: link “Mijn cadeaus en speciale dagen” in het accountmenu
Klantpagina: aftellen tot de volgende speciale dag, actieve code om te kopiëren of toe te passen, geboortedatum en voorkeuren
Klantpagina: aftellen tot de volgende speciale dag, actieve code om te kopiëren of toe te passen, geboortedatum en voorkeuren
Pagina "Mijn cadeaus en speciale dagen" op mobiel
Pagina “Mijn cadeaus en speciale dagen” op mobiel

Statistieken en omzetrapport

Het tabblad Dashboard toont voor de gekozen periode:

  • de gegenereerde omzet excl. en incl. btw, berekend op geldige bestellingen waarin een code is gebruikt en omgerekend naar de standaardvaluta;
  • de verzonden en gebruikte codes, de conversieratio en de gemiddelde bestelwaarde;
  • de toegekende korting en het rendement (omzet gedeeld door korting);
  • de bestellingen zonder de code die zijn geplaatst terwijl een code geldig was;
  • een grafiek over 12 maanden, de resultaten per gelegenheid, de verzendingen van de komende 30 dagen en de laatste bestellingen met een code.

De omzet wordt toegerekend aan de periode waarin de code is verzonden. Het tabblad Verzonden codes toont alle codes met zoekfunctie, filters op gelegenheid, status en datum, opnieuw verzenden van de e-mail voor een actieve code en CSV-export. Ook de klantpagina in de back-office toont de codes die naar die klant zijn verzonden.

Het dashboard toont ook de komende 7 dagen: elke dag geeft het aantal betrokken klanten per gelegenheid en leidt naar de kalender. In het tabblad Verzonden codes tonen de snelfilters per status (actief, gebruikt, verlopen) hun aantal codes.

Dashboard: komende 7 dagen, gegenereerde omzet, conversieratio en grafiek over 12 maanden
Dashboard: komende 7 dagen, gegenereerde omzet, conversieratio en grafiek over 12 maanden
Verzonden codes: status actief, gebruikt of verlopen, herinnering, gekoppelde bestelling en CSV-export
Verzonden codes: status actief, gebruikt of verlopen, herinnering, gekoppelde bestelling en CSV-export
Klantfiche in de back-office: verzonden codes voor speciale dagen, status en link naar alle codes
Klantfiche in de back-office: verzonden codes voor speciale dagen, status en link naar alle codes

Opschonen van verlopen codes

De instelling Verlopen, ongebruikte codes verwijderen na (standaard 30 dagen) verwijdert de bijbehorende winkelwagenregels zodat Catalogus > Kortingen overzichtelijk blijft. De geschiedenis en statistieken van de module blijven bewaard. Zet 0 om nooit te verwijderen.

AVG

De module meldt zich aan bij de officiële AVG-module van PrestaShop. De gegevensexport van een klant bevat zijn codes en voorkeuren, het verwijderen wist de modulegeschiedenis van die klant. Elke klant kan zich in zijn account of zonder in te loggen via de link in elke e-mail afmelden voor deze e-mails: de link opent een bevestigingspagina, zodat software die links in e-mails volgt niemand afmeldt. De klant kan ook zijn geboortedatum verwijderen op de pagina “Mijn cadeaus en speciale dagen”.

Afmelden voor de cadeau-e-mails met één klik, zonder in te loggen, met bevestiging
Afmelden voor de cadeau-e-mails met één klik, zonder in te loggen, met bevestiging

Multistore

Campagnes en instellingen gelden per winkel. Selecteer een winkel in het multistore-menu om ze te wijzigen. De aangemaakte codes zijn beperkt tot de betreffende winkel.

Veelgestelde vragen en probleemoplossing

Er wordt geen code verstuurd

Controleer of minstens één campagne is ingeschakeld en er geen pauze loopt, en open daarna de Kalender of gebruik Simuleren. Is de lijst leeg, dan voldoet vandaag geen enkele klant aan de criteria: onbekende datum, lopende wachttijd, groep niet geselecteerd, te weinig bestellingen of afgemelde klant.

De e-mails komen niet aan

Stuur een test-e-mail vanuit een campagne. Komt die niet aan, controleer dan de e-mailconfiguratie van PrestaShop in Geavanceerde instellingen > E-mail. Een code waarvan de e-mail is mislukt, wordt in de codelijst gemarkeerd en kan opnieuw worden verzonden.

Een bestelling ontbreekt in de statistieken

Alleen geldige bestellingen worden geteld. Heeft een medewerker zonder rechten op de module een bestelling in de back-office aangemaakt, klik dan op Gebruikte codes opnieuw synchroniseren; de dagelijkse taak doet dit ook automatisch.

Was deze pagina nuttig?

Loopt u nog vast? Neem contact op met support