DataFirefly Loyaliteit en Doorverwijzing: spaarpunten, niveaus en doorverwijsprogramma voor PrestaShop
Installatie, punten verdienen, niveaus, bonuspunten, omzetten in tegoedbonnen, doorverwijzing, vervallen, back office en probleemoplossing.
Installatie
Installeer de module via Modules > Modulebeheer > Module uploaden met het ZIP-bestand, of kopieer de map dfloyalty naar de map /modules/ van je winkel en klik op Installeren.
Bij de installatie maakt de module zijn tabellen aan, slaat de standaardinstellingen op, maakt vier statusniveaus aan (Brons, Zilver, Goud, Platina) en voegt het tabblad Klanten > Loyaliteit & Doorverwijzing toe. De knop Configureren in Modulebeheer opent direct het scherm met instellingen.
Kies eerst de accentkleur onder Instellingen > Algemeen. Die kleurt de knoppen van de module, de voortgangsbalken en de e-mails. Standaard is dat een donkergroen dat misschien niet bij je merk past.
Eerste instellingen
De instellingen zijn in secties gegroepeerd, bereikbaar via het menu links. Controleer minstens het volgende voordat je het programma voor klanten openstelt:
- Punten per bestede munteenheid: standaard 1, dus 1 punt per euro. Decimalen zijn toegestaan (0,5 = 1 punt per 2 euro).
- Bestelstatussen die de punten bevestigen: standaard betaling aanvaard, verzonden en afgeleverd.
- Omrekenkoers: standaard 100 punten = 5 €. Het vak links toont live het percentage dat na omzetting naar klanten terugvloeit.
- Doorverwijsbeloningen: standaard 10 € voor de vriend en 500 punten voor de doorverwijzer.
Punten verdienen
Berekening
De punten worden berekend op de productregels van de bestelling, in de valuta van de klant en daarna omgerekend naar de standaardvaluta. Verzendkosten leveren nooit punten op. Drie opties passen de basis aan:
- Berekenen op prijzen incl. btw: zet deze uit om op prijzen excl. btw te rekenen.
- Tegoedbonnen en kortingen aftrekken: de winkelwagenregels van de bestelling (behalve gratis verzending) worden naar verhouding van de basis afgetrokken.
- Geen punten op producten die al in de aanbieding zijn: producten met een korting worden uitgesloten.
Daarna worden de vermenigvuldiger van het niveau van de klant en de bonuspunten van het product toegepast. Het resultaat wordt naar beneden afgerond.
Levenscyclus van de punten
- Bij het plaatsen van de bestelling worden de punten in behandeling geregistreerd. De klant ziet ze in zijn account maar kan ze niet gebruiken.
- Als de bestelling een van de bevestigende statussen bereikt, worden ze beschikbaar.
- Gaat de bestelling naar een van de annulerende statussen, dan worden ze verwijderd, in behandeling of beschikbaar.
- Een gedeeltelijke creditnota trekt het deel van de punten af dat bij het terugbetaalde productbedrag hoort.
- Gaat een geannuleerde bestelling terug naar een bevestigende status, dan komen de punten terug.
Elke beweging komt in een geschiedenis die nooit wordt overschreven: er wordt een correctieregel toegevoegd in plaats van een bestaande regel aan te passen.
Punten bij registratie
De instelling Punten bij registratie kent een vast aantal punten toe bij elk nieuw klantaccount (niet bij gastbestellingen). Laat 0 staan om dit uit te schakelen.
Statusniveaus
Het tabblad Niveaus toont de niveaus op volgorde van drempel. Elk niveau heeft een vertaalbare naam en voordelentekst, een drempel in statuspunten, een puntenvermenigvuldiger en een kleur voor de ledenpas van de klant.
Statuspunten zijn de verdiende punten min annuleringen en terugbetalingen. Punten omzetten in tegoedbonnen of laten vervallen verlaagt de status niet. De instelling Statusperiode beperkt de berekening tot de laatste N maanden; laat 0 staan om vanaf de registratie te tellen.
Het eerste niveau moet drempel 0 hebben, zodat elke klant vanaf de eerste bestelling een status heeft. Bereikt een klant een nieuw niveau, dan ziet hij een felicitatie bij zijn volgende bezoek aan de loyaliteitspagina.
De voordelentekst is informatief. Wil je dat een voordeel echt geldt, koppel het niveau dan aan een klantengroep (zie hieronder).
Klantengroep van het niveau
In het formulier van een niveau koppelt het veld Klantengroep van dit niveau het niveau aan een PrestaShop-groep. De module voegt klanten die het niveau bereiken aan die groep toe en verwijdert ze als ze het niveau verlaten. Stel voor de groep een korting in (Klanten > Groepen), een winkelwagenregel voor gratis verzending die alleen voor de groep geldt, of specifieke prijzen: het voordeel geldt zonder handwerk.
- Maak voor elk niveau een aparte groep aan. Een klant die met de hand in die groep is gezet, wordt verwijderd als hij het niveau niet heeft.
- De standaardgroep van de klant wordt nooit gewijzigd.
- De synchronisatie gebeurt bij elke puntenbeweging, bij het opslaan van een niveau en dagelijks met de geplande taak.
Bonuspunten op producten
Met het tabblad Bonusproducten geef je meer punten op bepaalde producten. Zoek het product op naam of referentie en kies:
- Vermenigvuldiger: 2 verdubbelt de punten van dit product.
- Vaste punten per artikel: een aantal punten per stuk, bovenop de standaardpunten.
Begin- en einddatum zijn optioneel. Zonder datums is de bonus permanent. De productpagina toont een badge (x2, +50) en de te verdienen punten, herberekend als de klant het aantal wijzigt. De bonus wordt gecombineerd met de niveauvermenigvuldiger.
Punten omzetten in tegoedbonnen
Vanuit het klantaccount
In het tabblad Beloningen van de loyaliteitspagina kiest de klant met een schuifregelaar hoeveel punten hij omzet, in veelvouden van het aantal punten van de omrekenkoers. Hij krijgt een persoonlijke tegoedbon met code DFPTS-XXXXXXXX, getoond in een venster met kopieerknop en, als de optie aan staat, per e-mail verstuurd.
Direct in de winkelwagen
Staat Klanten hun punten direct in de winkelwagen laten gebruiken aan, dan toont het loyaliteitsblok in de winkelwagen een schuifregelaar. De tegoedbon wordt met één klik aangemaakt en toegepast, nooit boven het producttotaal. Vanuit dit blok kan per winkelwagen één puntenbon worden toegepast. Eerder aangemaakte, ongebruikte bonnen verschijnen ook met een knop Toepassen.
Instellingen van de tegoedbonnen
- Minimum aantal punten om om te zetten: daaronder ziet de klant een voortgangsbalk naar de eerste bon.
- Geldigheid van de tegoedbon: in dagen, standaard 365.
- Minimale winkelwagen om hem te gebruiken: 0 voor geen minimum.
- Combinatie met andere winkelwagenregels: zet dit uit als loyaliteitsbonnen niet met je kortingscodes gecombineerd mogen worden.
De tegoedbonnen zijn standaard winkelwagenregels van PrestaShop, zichtbaar onder Catalogus > Kortingen, gekoppeld aan de klant en eenmalig bruikbaar.
Doorverwijzing
De link van de doorverwijzer
Elke klant heeft een verwijzingscode en -link (parameter ?dfref=CODE op de homepage), zichtbaar in het tabblad Doorverwijzing van de loyaliteitspagina. Hij kan de link kopiëren, delen via WhatsApp, e-mail, Facebook of X of via de deelfunctie van zijn telefoon, en vanuit het formulier e-mailuitnodigingen versturen.
De komst van de vriend
Wie op de link klikt, wordt onthouden gedurende de tijd ingesteld bij Geheugen van de link (standaard 30 dagen). Een onopvallende banner stelt het cadeau voor en een bericht begeleidt het registratieformulier. Bij het aanmaken van het account, ook tijdens het afrekenen:
- is de beloning van de vriend een bedrag of een percentage, dan wordt een tegoedbon zonder code aangemaakt en automatisch aan de winkelwagen toegevoegd, met de ingestelde minimale aankoop en geldigheid;
- zijn het punten, dan worden die toegekend bij de bevestiging van de eerste bestelling.
Code ingevuld bij registratie
Met de optie Een optioneel veld „Verwijzingscode” toevoegen aan het registratieformulier kan een vriend die de code mondeling kreeg, hem invullen bij het aanmaken van zijn account. Een onbekende code wordt geweigerd met een foutmelding. Het veld verschijnt niet als de bezoeker al via een verwijzingslink binnenkwam.
De beloning van de doorverwijzer
De doorverwijzer wordt beloond wanneer de eerste bestelling van de vriend een bevestigende status bereikt en het producttotaal incl. btw de Minimale eerste bestelling van de vriend haalt. Hij krijgt punten of een tegoedbon met code DFREF-XXXXXXXX, plus een bedankmail.
Beveiliging
- Een klant kan zichzelf niet doorverwijzen, ook niet met hetzelfde e-mailadres.
- Een e-mailadres dat al in de winkel besteld heeft, wordt niet aan een doorverwijzer gekoppeld.
- Alleen de eerste bevestigde bestelling van de vriend telt. Ligt die onder het minimum, dan krijgt de doorverwijzing de status Niet in aanmerking.
- E-mailuitnodigingen zijn per klant per dag beperkt, en hetzelfde adres kan binnen 7 dagen niet twee keer worden uitgenodigd.
Statussen van een doorverwijzing
Uitgenodigd: e-mail verzonden door de klant. Geregistreerd: account aangemaakt via de link. Beloond: eerste bestelling bevestigd, beloningen toegekend. Niet in aanmerking: eerste bestelling onder het minimum.
Vervallen en geplande taak
De instelling Vervallen na inactiviteit laat het saldo van een klant vervallen als hij gedurende het opgegeven aantal maanden geen punten heeft verdiend. Elke bestelling schuift de datum op, en de klant ziet die in zijn account. Laat 0 staan als punten nooit mogen vervallen.
Het vervallen wordt toegepast wanneer de klant zijn loyaliteitspagina opent en door de dagelijkse taak waarvan de URL onder Instellingen > Onderhoud staat. Plan die één keer per dag in je cronbeheer of een cronmodule van PrestaShop. Ze verstuurt ook de vervalherinneringen, kent de verjaardagspunten toe en werkt de groepen van de niveaus bij. De knop Dagelijkse taak nu uitvoeren in het tabblad Onderhoud doet hetzelfde.
De instelling Herinnering voor het vervallen (standaard 30 dagen) stuurt de klant een e-mail met het saldo, de waarde en de vervaldatum. Er wordt één herinnering per vervaldatum verstuurd; bestelt de klant intussen, dan verschuift de datum en volgt te zijner tijd een nieuwe herinnering.
Voeg &resync=1 aan de URL toe om ook de bestelstatussen van de laatste 7 dagen opnieuw te verwerken.
Verjaardag, nieuwsbrief en campagnes
Verjaardagspunten
De instelling Verjaardagspunten kent eenmaal per jaar punten toe op de geboortedatum in het klantaccount, met een felicitatiemail. De toekenning gebeurt via de dagelijkse taak en ook wanneer de klant inlogt of zijn loyaliteitspagina opent. Klanten die op 29 februari geboren zijn, krijgen ze in niet-schrikkeljaren op de 28e. Standaard komen alleen klanten met een bevestigde bestelling in aanmerking, om accounts te vermijden die alleen voor het cadeau worden aangemaakt.
Het veld geboortedatum moet in het klantformulier staan: Winkelparameters > Klantinstellingen, optie voor de geboortedatum.
Punten voor inschrijving op de nieuwsbrief
De instelling Punten voor inschrijving op de nieuwsbrief kent eenmaal per klant punten toe: bij registratie als het vakje voor de nieuwsbrief is aangevinkt, bij een latere inschrijving vanuit het account, of via het nieuwsbriefblok in de footer voor een adres dat bij een klantaccount hoort. Abonnees van vóór het inschakelen van de optie krijgen geen punten met terugwerkende kracht.
Puntencampagnes
Het onderdeel Puntencampagne vermenigvuldigt alle punten die tussen twee data worden verdiend: 2 voor dubbele punten. De vermenigvuldiger komt bovenop die van het niveau en de productbonussen. Tijdens de campagne staat een badge op de productpagina’s, in het winkelwagenblok en op de loyaliteitspagina. De besteldatum telt: een bestelling die tijdens de campagne is geplaatst, houdt haar extra punten, ook als ze na het einde wordt bevestigd.
Klantengroepen uitsluiten
Vink onder Instellingen > Algemeen de klantengroepen aan die van het programma zijn uitgesloten, bijvoorbeeld zakelijke accounts of personeel. Een klant uit een van die groepen verdient geen punten, ziet de tegel, de loyaliteitspagina en de product- en winkelwagenblokken niet, en zijn verwijzingslink levert geen beloning op.
Wat de klant ziet
- Mijn account: een tegel met de naam van het programma en het saldo, en een link in het blok Mijn account in de footer.
- Loyaliteitspagina: ledenpas in de kleuren van het niveau, voortgang, tabbladen Beloningen, Doorverwijzing, Geschiedenis en Statussen.
- Productpagina: te verdienen punten, waarde in euro, bonusbadge. Optie Te verdienen punten op productpagina’s tonen.
- Winkelwagen: punten van de bestelling, saldo, punten gebruiken en beschikbare bonnen. Optie Puntenblok in de winkelwagen tonen. Het blok wordt bij elke wijziging van de winkelwagen bijgewerkt.
- Orderbevestiging: verdiende punten, in behandeling of al toegekend.
Back office
Dashboard
Punten in omloop en hun waarde (de verplichting die de saldi vertegenwoordigen), punten in behandeling, aantal leden, verdiende en omgezette punten over 30 dagen met grafiek, leden per niveau, aangemaakte en gebruikte tegoedbonnen, doorverwijstrechter, beste doorverwijzers en recente activiteit.
Leden en ledendossier
Het tabblad Leden toont klanten met punten, gesorteerd op saldo. De zoekfunctie werkt op naam, e-mail, klant-ID of verwijzingscode en omvat ook klanten zonder punten, zodat je ze punten kunt toekennen. Het ledendossier toont saldo, niveau, geschiedenis, tegoedbonnen en doorverwezen vrienden, en maakt een handmatige aanpassing mogelijk: voer een positief of negatief getal en een reden in, die de klant in zijn geschiedenis ziet.
De standaard klantpagina van PrestaShop toont ook een blok met saldo, niveau, verwijzingscode en een link naar het ledendossier.
Bestelpagina en exports
Op de pagina van een bestelling in de back office toont een blok de punten van de bestelling en hun status, de toegepaste bonussen en vermenigvuldigers, de gebruikte loyaliteitsbonnen en of het om de eerste bestelling van een doorverwezen klant gaat. Het tabblad Leden biedt twee CSV-exports: de ledenlijst (saldo, niveau, statuspunten, verwijzingscode) en alle puntenbewegingen. De bestanden openen direct in Excel of LibreOffice.
E-mails
De module verstuurt zes e-mails in de taal van de ontvanger: de uitnodiging van een vriend, het welkomstcadeau van de vriend, de beloning van de doorverwijzer, de tegoedbon die uit punten is aangemaakt, de verjaardagswens en de vervalherinnering. Ze gebruiken één sjabloon in de accentkleur met het logo van de winkel. De teksten komen uit de vertalingen van de module, het sjabloon staat in mails/.
Gegevens en verwijderen
Standaard staat Saldi en instellingen bewaren bij het verwijderen van de module aan: verwijderen en opnieuw installeren kost niets. Zet dit uit voordat je de module verwijdert als je alle gegevens wilt wissen. Wordt een klant in PrestaShop verwijderd, dan worden zijn punten, geregistreerde tegoedbonnen en doorverwijzingen mee verwijderd.
De module werkt samen met de officiële AVG-module van PrestaShop: de gegevensexport van een klant bevat zijn puntengeschiedenis en verwijzingscode, en het verwijderen van een klant via die module wist zijn loyaliteitsgegevens.
Probleemoplossing
De punten blijven in behandeling
Controleer of de huidige status van de bestelling is aangevinkt bij Bestelstatussen die de punten bevestigen. Heeft een medewerker de status gewijzigd en heeft zijn profiel geen leesrecht op de module (Geavanceerde instellingen > Team > Machtigingen), dan heeft PrestaShop de module niet uitgevoerd: gebruik Bestellingen van de laatste 90 dagen opnieuw synchroniseren onder Instellingen > Onderhoud. Dit kan zonder risico op dubbele toekenning opnieuw worden uitgevoerd.
Het loyaliteitsblok verschijnt niet in de winkelwagen
Het blok wordt getoond via de hook displayShoppingCart, die in het thema Classic aanwezig is. Roept je thema die niet aan, voeg dan {hook h='displayShoppingCart'} toe aan het winkelwagensjabloon, of neem contact met ons op met de naam van het thema.
De doorverwijsbanner verschijnt niet
Die wordt alleen getoond aan niet-ingelogde bezoekers die via een geldige link binnenkomen, en blijft 3 dagen verborgen na het sluiten. Test in een privévenster.
Sommige teksten blijven in het Engels
De module wordt geleverd in 8 talen. Voor een andere taal of om een tekst aan te passen, gebruik je Internationaal > Vertalingen > Vertalingen van geïnstalleerde modules.
Compatibiliteit
- PrestaShop 8.0 tot 9.x, dezelfde ZIP dekt beide versies.
- Meertalig en meerdere valuta. In multistore is het saldo van een klant gemeenschappelijk voor alle winkels.
- ModuleAdminController-architectuur, zonder Composer-afhankelijkheid.
- Module en e-mails vertaald in het Engels, Frans, Spaans, Duits, Italiaans, Nederlands, Pools en Portugees.