DataFirefly Loyaliteit en Doorverwijzing: spaarpunten, niveaus en doorverwijsprogramma voor PrestaShop
Installatie, punten en retourtermijn, niveaus, waardebonnen, punten voor productbeoordelingen, doorverwijzing beschermd tegen zelfverwijzing, vervaldatum, plaats van het winkelwagenblok, journaal, rechten van medewerkers, update en probleemoplossing.
Installatie
Installeer de module via Modules > Modulebeheer > Een module uploaden met het ZIP-bestand, of kopieer de map dfloyalty naar /modules/ en klik op Installeren. Dezelfde ZIP werkt op PrestaShop 1.7.8, 8 en 9.
Bij de installatie maakt de module zijn tabellen, standaardinstellingen, vier niveaus (Brons, Zilver, Goud, Platina) en het tabblad Klanten > Loyaliteit & Doorverwijzing aan. De knop Configureren opent direct de instellingen.
Begin met de accentkleur (Instellingen > Algemeen): die kleurt knoppen, voortgangsbalken en e-mails.
Eerste instellingen
Controleer vóór de start minstens:
- Punten per besteed €: standaard 1. Decimalen zijn toegestaan.
- De bestelstatussen die de punten bevestigen en die die ze annuleren.
- Wachttijd voordat de punten bruikbaar zijn: stel je retourtermijn in als punten niet vóór het einde daarvan besteed mogen worden.
- Omrekenkoers: standaard 100 punten = € 5. Het kader links toont het aandeel dat klanten na omzetting terugkrijgen.
- De doorverwijsbeloningen en de bescherming van doorverwijzingen.
- De URL van de dagelijkse taak, in te plannen in een cron (zie verder).
Punten verdienen
Berekeningsbasis
Punten worden berekend op de productregels van de bestelling, in de valuta van de klant en daarna omgerekend naar de standaardvaluta: een bestelling in dollars levert evenveel op als in euro. Opties:
- Berekenen op prijzen incl. btw (anders excl. btw).
- Tegoedbonnen en kortingen van de berekeningsbasis aftrekken, naar verhouding.
- Geen punten op producten die al in de aanbieding zijn.
- Verzendkosten leveren ook punten op (standaard uit).
Dezelfde basis geldt op de productpagina, in de winkelwagen, op de bestelling en bij terugbetalingen. Productpagina’s tonen de punten altijd zonder verzending. Daarna gelden de niveauvermenigvuldiger, productbonussen en de lopende campagne; het resultaat wordt naar beneden afgerond.

Levenscyclus van de punten
- Bij het aanmaken van de bestelling staan de punten open.
- Bij de eerste bevestigende status worden ze beschikbaar, of blijven ze open tot het einde van de wachttijd als je die instelde. De klant ziet de datum.
- Bij een annuleringsstatus worden ze verwijderd. Tijdens de wachttijd verwijdert een annulering of terugbetaling ze voordat ze bruikbaar zijn.
- Elke creditnota (gedeeltelijke of standaardterugbetaling, retour) trekt het puntenaandeel van het terugbetaalde bedrag af. Elke creditnota wordt één keer verwerkt; een gemiste wordt bij de hersynchronisatie ingehaald.
- Een geannuleerde bestelling die terugkeert naar een bevestigende status krijgt haar punten terug.
Elke bestelling, creditnota en beloning kan maar één keer worden geregistreerd: de database weigert een dubbel, ook als twee verwerkingen tegelijk binnenkomen (een online betaling en een medewerker, bijvoorbeeld).

Statusniveaus
Het tabblad Niveaus toont de niveaus op drempel. Elk niveau heeft een vertaalbare naam en voordelentekst, een drempel in statuspunten, een vermenigvuldiger en een kleur (die van de ledenpas). Statuspunten zijn verdiende punten min annuleringen: omzetten of laten vervallen verlaagt de status niet. De statusperiode beperkt de telling tot de laatste N maanden.

Het veld Klantengroep van dit niveau koppelt een niveau aan een PrestaShop-groep: de module voegt klanten toe die het niveau bereiken en haalt ze eruit wanneer ze het verlaten. Geef die groep een korting, gratis verzending of specifieke prijzen. De standaardgroep van de klant verandert nooit.

Bonuspunten op producten
Het tabblad Bonusproducten geeft een product een vermenigvuldiger (x2) of vaste punten per stuk, met optionele data. De productpagina toont een badge en herberekent de punten voor de gekozen hoeveelheid.

Punten omzetten in tegoedbonnen
In het tabblad Mijn beloningen kiest de klant met een schuif de om te zetten punten, in veelvouden van de koers, en krijgt een persoonlijke tegoedbon voor eenmalig gebruik (DFPTS-XXXXXXXX) met kopieerknop, ook per e-mail als die optie aan staat. Het bedrag berekent de server; de omzetting wordt geweigerd als het saldo niet volstaat, ook bij meerdere gelijktijdige verzoeken.

Met Klanten hun punten direct in de winkelwagen laten gebruiken biedt het loyaliteitsblok in de winkelwagen dezelfde schuif: de tegoedbon wordt met één klik gemaakt en toegepast, nooit boven het totaal. Bestaande tegoedbonnen pas je ook met één klik toe. Instellingen: minimum punten, geldigheid, minimum winkelwagen, combineerbaarheid. Tegoedbonnen zijn PrestaShop-winkelwagenregels gekoppeld aan de klant; in multistore gelden ze alleen in de winkel waar ze zijn aangemaakt.

Doorverwijzingen
De link van de doorverwijzer
Elke klant heeft een code (8 willekeurige tekens) en een link ?dfref=CODE in het tabblad Vriend doorverwijzen: kopiëren, delen via WhatsApp, e-mail, Facebook, X, delen op de telefoon en e-mailuitnodigingen (beperkt per dag).

De komst van de vriend
Een bezoeker via de link wordt onthouden gedurende de ingestelde periode (standaard 30 dagen). Een bericht begeleidt hem tot het registratieformulier. Bij het aanmaken van het account komt er een welkomstbon zonder code in de winkelwagen (bedrag of percentage), of worden punten beloofd voor de eerste bestelling. Een optioneel veld accepteert ook een mondeling doorgegeven code.

De beloning van de doorverwijzer
De doorverwijzer wordt beloond als de eerste bestelling van de vriend een bevestigende status en het ingestelde minimum bereikt. Met een wachttijd voor de beloningen staat de doorverwijzing op „Wachttijd” en wordt niets toegekend als de bestelling intussen wordt geannuleerd of terugbetaald. Gebeurt dat daarna, dan worden de beloningen teruggenomen (punten afgetrokken, ongebruikte bon van de doorverwijzer uitgeschakeld). Een limiet beperkt het aantal beloonde doorverwijzingen per doorverwijzer over 12 maanden.
Bescherming tegen zelfverwijzing
- Altijd: geen beloning voor hetzelfde account, dezelfde mailbox anders geschreven (hoofdletters,
+alias, punten in Gmail), een klant die al bestelde, of vóór de eerste goedgekeurde bestelling. - Apparaat: de vriend registreert zich in een browser die de doorverwijzer al gebruikte. De controle gebruikt een willekeurige ID in een eigen cookie van de winkel, zonder fingerprinting; alleen een gezouten hash wordt bewaard.
- Huishouden: zelfde bezorg- of factuuradres, of zelfde telefoonnummer, als de doorverwijzer bij de eerste bestelling.
Slaat een controle aan, dan wordt de doorverwijzing aangehouden voor controle (of automatisch afgewezen, naar keuze). Een gezin kan een computer of adres delen: controleren is vaak de eerlijkste keuze. Deze controles verminderen zelfverwijzing zonder ze onmogelijk te maken.

De wachtrij „Te controleren”
Het tabblad Doorverwijzingen toont de reden van elke aanhouding met de knoppen Goedkeuren / Afwijzen. De beslissende medewerker wordt geregistreerd. Een melding toont openstaande controles op alle schermen van de module.

Statussen
Uitgenodigd · Geregistreerd · Te controleren · Wachttijd · Beloond · Niet in aanmerking (minimum niet gehaald, klant had al besteld, limiet bereikt) · Afgewezen · Geannuleerd (eerste bestelling geannuleerd of terugbetaald).
Vervallen en dagelijkse taak
De instelling Geldigheid van de punten (maanden, 0 = nooit) kent twee regels:
- Inactiviteit: het hele saldo vervalt na deze periode zonder nieuwe punten; elke bestelling schuift de datum op.
- Doorlopend: elke bijschrijving vervalt zo lang na het bijschrijven, de oudste punten worden eerst gebruikt.
Een herinnering vertrekt N dagen vooraf (standaard 30), één keer per vervaldatum, met een tekst die bij de regel past. Het vervallen gebeurt via de dagelijkse taak en bij het openen van de loyaliteitspagina.
De dagelijkse taak (URL met token in Instellingen > Onderhoud) geeft punten en beloningen vrij na de wachttijd, verstuurt herinneringen, past het vervallen toe, schrijft verjaardagen bij en werkt de niveaugroepen bij. Plan ze één keer per dag; de module installeert geen cron. Het dashboard waarschuwt als ze twee dagen niet draaide. Voeg &resync=1 toe om ook de statussen en creditnota’s van de laatste 7 dagen opnieuw te verwerken.
Verjaardag, nieuwsbrief en campagnes
Verjaardagspunten: één keer per jaar met een e-mail, standaard alleen voor klanten die al bestelden. Punten voor inschrijving op de nieuwsbrief: één keer per klant. Puntencampagne: een vermenigvuldiger tussen twee data, zichtbaar op productpagina’s, in de winkelwagen en op de loyaliteitspagina; de besteldatum telt.
Punten voor productbeoordelingen
Met DataFirefly Geverifieerde reviews 2.1.0 of hoger leveren productbeoordelingen punten op. Instellingen > Productbeoordelingen (standaard alles op 0):
- Punten per gepubliceerde beoordeling;
- Extra punten als de beoordeling een foto bevat, ongeacht het aantal foto’s;
- Minimale lengte van de beoordelingstekst (0 = het minimum van de reviewmodule);
- Beloonde beoordelingen per klant per 30 dagen (standaard 10, 0 = geen limiet);
- Punten alleen voor geverifieerde aankopen (standaard aan).
Een badge bovenaan de sectie toont of de reviewmodule gekoppeld, te oud, uitgeschakeld of niet geïnstalleerd is.
Wanneer punten worden toegekend en ingetrokken
- De punten worden toegekend wanneer de beoordeling wordt gepubliceerd, nooit bij het verzenden, en ongeacht het aantal sterren. Een beoordeling die op moderatie wacht, levert niets op tot ze gepubliceerd is.
- Een beoordeling die offline wordt gehaald of verwijderd verliest haar punten; een beoordeling waarvan alle foto’s worden verwijderd verliest haar fotobonus. Wordt ze opnieuw gepubliceerd, dan krijgt de klant dezelfde punten terug.
- Als je het product verwijdert, houdt de klant zijn punten.
- Niets voor gasten, uitgesloten groepen, geïmporteerde beoordelingen (CSV, Product Comments), beoordelingen geschreven vóór het inschakelen van de beloning of boven de limiet.
- De voorwaarden worden alleen de eerste keer gecontroleerd: de instellingen wijzigen neemt nooit al verdiende punten terug.
In de geschiedenis ziet de klant „Je beoordeling van ” en „Fotobonus voor je beoordeling van ”. Het journaal in de back-office toont de bewerkingen Productbeoordeling, Fotobonus beoordeling en Beoordelingspunten ingetrokken.
Wat de klant ziet
Het beoordelingsformulier op de productpagina, de vanuit de e-mail geopende pagina om de bestelling te beoordelen en de e-mails met een verzoek om een beoordeling kondigen de beloning aan, bijvoorbeeld „Verdien 50 punten per gepubliceerde beoordeling, en 100 punten extra met een foto, ongeacht het aantal sterren.” Na het verzenden toont het bevestigingsbericht de toegekende punten of de punten die bij publicatie volgen. Het transparantieblok van de beoordelingen vermeldt dat beoordelingen beloond kunnen worden, zoals de Europese Omnibus-richtlijn vereist.
Staat ook de bedankbon van DataFirefly Geverifieerde reviews aan, dan krijgt de klant beide. Kies het een of het ander om niet dubbel te belonen.
Klantengroepen uitsluiten
De groepen aangevinkt in Instellingen > Algemeen (zakelijke klanten, personeel) verdienen geen punten, zien het programma niet en kunnen niet doorverwijzen.
Wat de klant ziet
- Mijn account: een item met het saldo, aangepast aan Hummingbird en Classic.
- Loyaliteitspagina: ledenpas in de niveaukleur, voortgang, openstaande punten met datum, volgende vervaldatum en de tabbladen Mijn beloningen, Vriend doorverwijzen, Geschiedenis en Statussen.
- Productpagina, winkelwagen en orderbevestiging: te verdienen punten, saldo, punten gebruiken.


Back-office
Dashboard
Punten in omloop en de bijbehorende verplichting, openstaande punten, leden, bijschrijvingen en omzettingen over 30 dagen, verdeling per niveau, aangemaakte en gebruikte tegoedbonnen, doorverwijzingen (te controleren, in wachttijd, afgewezen), beste doorverwijzers, recente activiteit en de staat van de dagelijkse taak. Getoonde bedragen zijn geregistreerde bedragen, geen schatting van extra verkopen.

Leden en ledendossier
Zoeken op naam, e-mail, ID of verwijzingscode. Het dossier toont saldo, openstaande punten, niveau, volgende vervaldatum, historiek, tegoedbonnen en doorverwezen vrienden.


Journaal van boekingen
Het tabblad Journaal toont alle puntenboekingen, te filteren op bewerking, status, data en zoekterm, met totalen bijgeschreven / afgeschreven en CSV-export van de selectie. Beschikbare boekingen worden nooit gewijzigd: een correctie is een nieuwe boeking.

Handmatige aanpassingen en rechten
Een aanpassing vereist een reden die de klant ziet en registreert de medewerker. In Instellingen > Rechten van medewerkers kiest een SuperAdmin welke profielen saldi mogen aanpassen en tot welk maximum per bewerking. Instellingen, niveaus en bonussen vereisen het recht Bewerken, verwijderen het recht Verwijderen, en exports (met e-mailadressen) het recht Bewerken.

Bestel- en klantpagina
Een paneel op de bestelling toont de punten en hun status, gebruikte loyaliteitsbonnen en of het de eerste bestelling van een doorverwezen klant is. Ook de PrestaShop-klantpagina toont saldo en niveau.

E-mails
Zeven e-mails in de taal van de ontvanger: uitnodiging, welkomstcadeau, beloning van de doorverwijzer, aangemaakte tegoedbon, verjaardag, vervalherinnering en optioneel beschikbare punten. Eén sjabloon in de accentkleur, in mails/.

Gegevens, AVG en verwijderen
Met de officiële AVG-module bevat de export van een klant boekingen, tegoedbonnen, doorverwijzingen en code; het verwijderen wist ook de apparaathashes en zijn adres in ontvangen uitnodigingen. Vermeld de cookie van de apparaatcontrole in je privacybeleid; de module alleen maakt je winkel niet conform. De optie Saldi en instellingen bewaren bij het verwijderen van de module staat standaard aan.
Bijwerken vanaf 1.1.0
Upload de ZIP 2.2.0 in Modulebeheer: de update bewaart saldi, historiek, niveaus, tegoedbonnen en doorverwijzingen, en markeert al verwerkte creditnota’s zodat ze nooit opnieuw worden verwerkt. Nieuwe opties starten met waarden die de bestaande berekening niet veranderen; alleen de apparaat- en huishoudcontroles worden ingeschakeld. Beloningen toegekend door 1.1.0 worden nooit teruggenomen.
Vanaf 2.0.0 of 2.1.0 wijzigt de update naar 2.2.0 geen gegevens: ze voegt de instellingen voor beoordelingen (uitgeschakeld) en de hook van het besteloverzicht toe.
Probleemoplossing
De punten blijven open staan
Controleer de bevestigende statussen en de wachttijd. Als een medewerker zonder toegang tot de module de status wijzigde, voerde PrestaShop de module niet uit: gebruik Bestellingen van de laatste 90 dagen opnieuw synchroniseren (zonder risico op dubbele bijschrijving). Met een wachttijd: controleer of de dagelijkse taak draait.
Een doorverwijzing staat op „Te controleren”
De reden staat in het tabblad Doorverwijzingen. Keur goed als het verschillende personen zijn; zolang ze is aangehouden, wordt niets toegekend.
Het winkelwagenblok verschijnt niet, of niet waar je het wilt
Het blok wordt getoond via twee hooks: displayShoppingCart op de winkelwagenpagina (rechterkolom in Classic en Hummingbird) en displayCheckoutSummaryTop bovenaan het besteloverzicht van de standaard checkout. Plaatst je thema displayShoppingCart elders, of gebruik je een one-page-checkoutmodule:
- koppel de module aan een andere weergavehook in Design > Posities > Een module koppelen, bijvoorbeeld een hook van de overzichtskolom van je checkoutmodule;
- of voeg
{widget name='dfloyalty'}toe op de gewenste plek in een template van je thema of van je checkoutmodule; - of verplaats in de
cart.tplvan je thema{hook h='displayShoppingCart'}naar de rechterkolom.
Stijlen en script worden geladen op de winkelwagen- en bestelpagina en op de pagina’s van one-page-checkoutmodules, en automatisch toegevoegd overal waar het blok verschijnt. Het blok past zich aan smalle kolommen aan en blijft werken wanneer PrestaShop het besteloverzicht opnieuw laadt. Het is verborgen als de winkelwagen leeg is of als het winkelwagenblok is uitgeschakeld in de weergave-instellingen.
Compatibiliteit
- PrestaShop 1.7.8 tot 9.x met dezelfde ZIP, PHP 7.4 tot 8.x, thema’s Classic en Hummingbird.
- Meertalig, meerdere valuta, multistore (instellingen per winkel, tegoedbonnen beperkt tot hun winkel).
- Module en e-mails vertaald in het Engels, Frans, Spaans, Duits, Italiaans, Nederlands, Pools en Portugees.