PS PrestaShop Beginner

DataFirefly Advent Calendar: adventskalender voor PrestaShop

Installatie en update, instellingen en herinneringscron, kant-en-klare modellen, vakjes en kortingscodes, direct winnen, voorbeeld, e-mails, trekking, statistieken en problemen oplossen.

Bijgewerkt Moduleversie 2.0.0

Installatie en update

Installeer de module via Modules > Modulebeheer > Een module uploaden door het ZIP-bestand te versturen, of zet de map dfadventcalendar in de map /modules/ van uw winkel en klik op Installeren. Dezelfde ZIP werkt van PrestaShop 1.7.8 tot 9.x.

De installatie maakt de tabellen van de module aan, registreert de hooks, maakt de kalenderpagina aan (één adres per taal) en voegt het tabblad Catalogus > Kortingen > Adventskalender toe. Afbeeldingen van de vakjes worden opgeslagen in /img/dfadventcalendar/, buiten de modulemap.

Update vanaf 1.0.0: upload de nieuwe ZIP en PrestaShop voert de migratie uit. Kalenders, vakjes, deelnemers en codes blijven behouden. Het vorige paginaadres blijft in alle talen werken, zodat links die al per e-mail zijn verstuurd blijven werken.

Module-instellingen

De configuratiepagina van de module (knop Configureren) bundelt de instellingen die voor alle kalenders gelden.

  • Adres van de kalenderpagina: één adres per taal, bijvoorbeeld /adventskalender in het Nederlands en /advent-calendar in het Engels. De module weigert een adres dat al door een andere pagina wordt gebruikt. De SEO-titel van de pagina stelt u in onder Winkelparameters > Verkeer & SEO.
  • Tijdzone en tijd van de winkel: de vakjes gaan open in deze tijdzone, ongeacht de tijdzone van de bezoeker of van de server.
  • Herinneringen per cronrun: maximaal aantal e-mails per aanroep (standaard 150).
  • Gegevens bewaren bij het verwijderen: kalenders, vakjes, deelnemers en afbeeldingen blijven in de database, klaar voor een herinstallatie.
  • Testklok (alleen in debugmodus): de hele kalender gedraagt zich alsof het de ingevoerde datum en tijd is. De backoffice toont een waarschuwing zolang de klok is ingesteld. Laat hem nooit actief in een live winkel.

Dagelijkse herinnering: crontaak

Kopieer het getoonde cronadres en plan het elke 15 minuten in het paneel van uw hostingprovider:

*/15 * * * * curl -s "https://www.uw-winkel.nl/module/dfadventcalendar/cron?token=UW_TOKEN" > /dev/null

De kalender werkt zonder cron: alleen de herinneringsmails zijn ervan afhankelijk. De laatste run wordt getoond, en de checklist voor de start op het dashboard meldt een gestopte cron.

DataFirefly Adventskalender: module-instellingen: paginaadres per taal, tijdzone van de winkel, herinneringscron en bewaren van gegevens
Module-instellingen: paginaadres per taal, tijdzone van de winkel, herinneringscron en bewaren van gegevens

Een kalender aanmaken

Open Catalogus > Kortingen > Adventskalender. Het snelst start u vanuit een model: datums, aantal vakjes, thema en titel in al uw talen zijn al voorbereid. U hoeft alleen de vakjes nog te vullen.

  • Adventskalender, 24 vakjes of 25 vakjes met eerste kerstdag, vanaf 1 december;
  • De 12 dagen van kerst, van 13 tot 24 december;
  • Black Friday-week, 7 vakjes tot de laatste vrijdag van november;
  • Aftelkalender naar een evenement, 10 vakjes vóór een lancering of een privéverkoop.

Met de knop Lege kalender of Nieuwe kalender kiest u elke instelling zelf.

DataFirefly Adventskalender: lijst van kalenders met kant-en-klare modellen: advent, 12 dagen van kerst, Black Friday-week en aftelkalender
Lijst van kalenders met kant-en-klare modellen: advent, 12 dagen van kerst, Black Friday-week en aftelkalender

Datums en openen

  • Datum van het eerste vakje en aantal vakjes (1 tot 60): één vakje per dag vanaf die datum.
  • Openingstijdstip van de vakjes: 00:00 voor middernacht, of een vast tijdstip zoals 08:00. Vóór dat tijdstip blijft het vakje van gisteren het vakje van de dag.

Uiterlijk

Er zijn negen thema’s: Dennenbos, Kraftpapier, Rijp, Winternacht, Zuurstok en vier thema’s buiten kerst (Zwart en goud, Black Friday, Lentepastel, Zomerlagune). De optie Eigen kleuren activeert vier kleuren. Er zijn drie stijlen van de vakjes: openklappende deurtjes, cadeaudozen met lint en minimalistische tegels. De decoratie animeert de achtergrond: sneeuw, sterren, confetti of geen. Een live voorbeeld toont het resultaat terwijl u instelt.

Met gevarieerde formaten vult het raster zich zonder gaten op 6 of 4 kolommen. Op mobiel schakelt het over naar 4 gelijke kolommen. Animaties stoppen voor bezoekers die hun apparaat vragen om minder beweging.

DataFirefly Adventskalender: instellingen van het uiterlijk met live voorbeeld: thema, stijl van de vakjes en decoratie
Instellingen van het uiterlijk met live voorbeeld: thema, stijl van de vakjes en decoratie

Deelname

  • E-mail verplicht om de vakjes te openen: uitgeschakeld openen bezoekers vrij, maar persoonlijke codes en spellen blijven voorbehouden aan deelnemers.
  • Alleen voor klantaccounts: alleen ingelogde klanten doen mee, en hun codes zijn aan hun account gekoppeld. Dit is de beste bescherming tegen het verzamelen van codes met wegwerpadressen.
  • E-mailadres bevestigen (double opt-in) en een optioneel, niet aangevinkt vakje voor de nieuwsbrief.
  • Openen van voorbije vakjes toestaan: gedeelde codes blijven dan geldig tot het einde van de kalender.
  • Toestemmingstekst: voeg de link naar uw privacybeleid toe.

De vakjes instellen

Het dashboard van de kalender toont de vakjes als kaarten: datum, type, beloning, code, openingen, onthulde codes en bestellingen. De filters In te stellen, Met een code, Direct winnen, Vandaag en binnenkort en Voorbij en het zoekveld vinden meteen een vakje. Vanaf elke kaart kunt u het vakje bewerken, als voorbeeld openen of activeren.

DataFirefly Adventskalender: visuele editor van de vakjes met filters, zoeken en statistieken per vakje
Visuele editor van de vakjes met filters, zoeken en statistieken per vakje

Soorten vakjes

  • Bericht: tekst, afbeelding en optionele knop.
  • Kortingscode: de code staat centraal, op een ticket om te kopiëren of in de winkelwagen te leggen.
  • Onthuld product: productkaart met prijs en knop om aan de winkelwagen toe te voegen.
  • Direct winnen: de deelnemer waagt een kans en wint de beloning met de winkans die u instelt.

Beloning en code

Korting in procenten, korting in bedrag, gratis verzending, cadeauproduct, of een bestaande winkelwagenregel van de winkel met haar eigen voorwaarden. Voor beloningen die de module aanmaakt:

  • Persoonlijke code: een winkelwagenregel voor eenmalig gebruik wordt aangemaakt wanneer de deelnemer het vakje opent. Ze is gekoppeld aan het klantaccount als dat bekend is en geldig tot middernacht, plus de extra geldigheid die u kiest.
  • Dezelfde code voor iedereen: één winkelwagenregel per vakje, automatisch gesynchroniseerd. Laat het veld leeg voor een automatische code (prefix, jaar en nummer, bijvoorbeeld ADVENT26-07).
  • Optioneel minimumbedrag van de bestelling en beperking tot het onthulde product.

Met de knoppen Vorig vakje en Volgend vakje vult u de kalender in één keer. Weinig tijd? Lege vakjes vullen past een kant-en-klaar plan toe, vertaald in al uw talen.

Direct winnen

Stel de winkans in (1 tot 100%), het aantal prijzen (0 voor onbeperkt) en het bericht als de deelnemer niet wint. De trekking gebeurt op de server bij het openen van het vakje, één keer per deelnemer. Het vakje opnieuw openen geeft hetzelfde resultaat. Zijn alle prijzen gewonnen, dan zien de volgende deelnemers het verliesbericht.

DataFirefly Adventskalender: instellingen voor direct winnen van een vakje: winkans, aantal prijzen en bericht bij verlies
Instellingen voor direct winnen van een vakje: winkans, aantal prijzen en bericht bij verlies

Voorbeeld en start

Het dashboard bundelt alles wat u nodig hebt om de kalender te starten:

  • Voorbeeld op: kies een datum en open de kalender zoals hij er die dag uitziet. Getoonde codes zijn voorbeelden en er wordt niets opgeslagen. Voorbeeldlinks verlopen na 7 dagen.
  • Checklist voor de start: kalender actief, vakjes ingesteld, herinneringscron en e-mails van de winkel.
  • Meer > Testmails naar mij sturen: de vier e-mails (herinnering, welkom, bevestiging, toegangslink) gaan naar de ingelogde medewerker, in diens taal.
DataFirefly Adventskalender: backoffice-dashboard: checklist voor de start, deelnemers, geopende vakjes, codes, bestellingen, omzet en activiteitsgrafiek
Backoffice-dashboard: checklist voor de start, deelnemers, geopende vakjes, codes, bestellingen, omzet en activiteitsgrafiek

Wat de klant ziet

De kalenderpagina opent met een aftelklok tot het volgende vakje, met het vakje van de dag uitgelicht. Na inschrijving ziet de deelnemer zijn voortgangsring, zijn reeks opeenvolgende dagen en de schakelaar voor de dagelijkse herinnering.

DataFirefly Adventskalender: adventskalenderpagina met aftelklok, voortgangsring, dagenreeks en eindtrekking
Adventskalenderpagina met aftelklok, voortgangsring, dagenreeks en eindtrekking

Vakjes hebben vijf statussen: vandaag (geanimeerde gloed), in te halen, geopend (inhoud zichtbaar), komend (hangslot en datum) en gemist. Een ster markeert spelvakjes.

DataFirefly Adventskalender: raster met vakjes: vakje van de dag, geopende vakjes, in te halen en komende vakjes
Raster met vakjes: vakje van de dag, geopende vakjes, in te halen en komende vakjes

Bij het openen toont een venster de verrassing: product met prijs, code op een ticket, knoppen In mijn winkelwagen en Kopiëren. Is de winkelwagen leeg, dan wordt de code 14 dagen bewaard en toegepast op het eerste toegevoegde product.

DataFirefly Adventskalender: vakje van de dag onthult een product en een persoonlijke kortingscode om te kopiëren of in de winkelwagen te leggen
Vakje van de dag onthult een product en een persoonlijke kortingscode om te kopiëren of in de winkelwagen te leggen

Het overzicht Uw codes toont de verzamelde codes, met hun geldigheid en status (gebruikt, verlopen).

DataFirefly Adventskalender: overzicht van de verzamelde codes van de deelnemer, met kopiëren en in winkelwagen leggen
Overzicht van de verzamelde codes van de deelnemer, met kopiëren en in winkelwagen leggen

Op mobiel schakelt het raster over naar 4 gelijke kolommen en worden de panelen onder elkaar gezet.

DataFirefly Adventskalender: adventskalender op mobiel met deelnamepaneel en vakjes
Adventskalender op mobiel met deelnamepaneel en vakjes

Direct-winspel

Met een spelvakje waagt de deelnemer een kans. Wint hij, dan krijgt hij de code zoals bij een gewoon vakje. Zo niet, dan ziet hij het verliesbericht en kan hij spelen bij het volgende spelvakje. Een bezoeker die niet is ingeschreven, wordt gevraagd zijn e-mailadres achter te laten: één kans per deelnemer.

DataFirefly Adventskalender: direct-winvakje: de deelnemer wint een kortingscode
Direct-winvakje: de deelnemer wint een kortingscode

De banner verschijnt op de startpagina tijdens de kalender en, als u wilt, een paar dagen voor de start. De zwevende knop, in te schakelen in de kalenderinstellingen, herinnert op elke pagina aan het vakje van de dag. De bezoeker kan hem tot de volgende dag verbergen. Om de banner elders te plaatsen, voegt u {hook h='displayDfAdventCalendar'} toe aan een template van uw thema.

DataFirefly Adventskalender: banner op de startpagina en zwevende knop met het vakje van de dag
Banner op de startpagina en zwevende knop met het vakje van de dag

Aftelkalenders buiten kerst

Dezelfde module ondersteunt elk belangrijk moment: Black Friday-week, de lancering van een collectie, uitverkoop, de verjaardag van uw winkel. Kies een aftelmodel, een thema zoals Zwart en goud, minimalistische tegels en een openingstijdstip. Vóór de start toont de pagina de aftelklok tot het eerste vakje.

DataFirefly Adventskalender: aftelkalender voor een evenement buiten kerst, thema zwart en goud met minimalistische tegels
Aftelkalender voor een evenement buiten kerst, thema zwart en goud met minimalistische tegels

Herinneringen en e-mails

Elke dag, vanaf het gekozen tijdstip (nooit vóór het openingstijdstip van de vakjes), kondigt een korte e-mail het vakje van de dag aan bij bevestigde deelnemers die het nog niet hebben geopend. Een deelnemer krijgt hoogstens één herinnering per dag, en geen op de dag van inschrijving: de welkomstmail volstaat. De e-mails gebruiken de kleuren van het kalenderthema.

DataFirefly Adventskalender: dagelijkse herinneringsmail over het vakje van de dag
Dagelijkse herinneringsmail over het vakje van de dag

Vier sjablonen worden in acht talen meegeleverd in mails/: dfadvent_reminder (herinnering), dfadvent_welcome (welkom), dfadvent_confirm (bevestiging van het adres) en dfadvent_access (toegangslink). Een deelnemer die zijn adres opnieuw invoert, krijgt een toegangslink: de module logt nooit iemand in op basis van alleen een ingetypt adres, en hetzelfde adres krijgt hoogstens één e-mail per 2 minuten. Om de sjablonen aan te passen, kopieert u ze naar themes/uw-thema/modules/dfadventcalendar/mails/.

DataFirefly Adventskalender: welkomstmail die de deelname bevestigt, in de kleuren van de kalender
Welkomstmail die de deelname bevestigt, in de kleuren van de kalender

Deelnemers

De deelnemerslijst filtert u met één klik: bevestigd, wachten op bevestiging, herinneringen aan, nieuwsbrief, klantaccounts, winnaars van de trekking. Ze toont de geopende vakjes en verzamelde codes per deelnemer en kan naar CSV worden geëxporteerd.

DataFirefly Adventskalender: deelnemers met snelle filters: bevestigd, wachtend, herinneringen, nieuwsbrief, klantaccounts
Deelnemers met snelle filters: bevestigd, wachtend, herinneringen, nieuwsbrief, klantaccounts

Eindtrekking

Stel in de kalenderinstellingen het minimale aantal geopende vakjes in om mee te doen (0 schakelt de trekking uit) en beschrijf de prijs. Het dashboard toont hoeveel deelnemers in aanmerking komen. De knop Winnaar trekken kiest willekeurig onder de bevestigde deelnemers die in aanmerking komen, met uitsluiting van eerdere winnaars. Elke trekking wordt vastgelegd.

Een prijstrekking en een direct-winspel vallen onder de regels voor promotionele kansspelen. Publiceer vóór de start een reglement in uw winkel.

Statistieken

Het dashboard toont deelnemers (bevestigd, met een klantaccount), geopende vakjes en het gemiddelde per deelnemer, onthulde codes en het aandeel gebruikte persoonlijke codes, geldige bestellingen met een code, de omzet exclusief btw van die bestellingen en de actieve herinneringen. De activiteitsgrafiek toont openingen en inschrijvingen per vakje.

Als Google Tag Manager aanwezig is, stuurt de module deze events naar de dataLayer: dfadv_join, dfadv_door_open, dfadv_code_copy, dfadv_code_apply en dfadv_share.

Het menu Meer > Dupliceren voor volgend jaar kopieert de kalender en zijn vakjes een jaar later, inactief, zonder deelnemers of codes.

Persoonsgegevens

  • Het toestemmingsvakje is verplicht, het nieuwsbriefvakje staat apart en is niet aangevinkt.
  • Elke herinneringsmail bevat een afmeldlink met één klik.
  • Het IP-adres wordt alleen gehasht bewaard, om inschrijvingen te beperken tot 5 per uur per verbinding.
  • De module beantwoordt de PrestaShop-verzoeken om export (inclusief codes) en verwijdering van persoonsgegevens.

Problemen oplossen

Herinneringen worden niet verstuurd

Controleer de checklist voor de start op het dashboard: cron uitgevoerd in de afgelopen 24 uur, e-mails van de winkel ingeschakeld. Herinneringen vertrekken vanaf het gekozen tijdstip, en alleen naar bevestigde deelnemers die het vakje van de dag nog niet hebben geopend.

De kalenderpagina geeft een 404-fout

Controleer of vriendelijke URL’s zijn ingeschakeld en leeg daarna de cache. Botst het adres met een andere pagina, wijzig het dan in de module-instellingen.

Een vakje blijft dicht op zijn dag

Controleer het openingstijdstip van de kalender en de tijdzone van de winkel (Internationaal > Lokalisatie). Een vakje dat niet is ingesteld of inactief is, blijft dicht.

De code wordt niet aan de winkelwagen toegevoegd

Het getoonde bericht komt van PrestaShop: minimumbedrag niet bereikt, verlopen code of code gekoppeld aan een ander klantaccount. Is de winkelwagen leeg, dan blijft de code bewaard en wordt hij toegepast op het eerste product.

Compatibiliteit

  • PrestaShop 1.7.8 tot 9.x, dezelfde ZIP voor alle versies.
  • Classic, Hummingbird en afgeleide thema’s.
  • Multistore (één kalender per winkel) en meerdere valuta (bedragen omgerekend naar de valuta van de bezoeker).
  • ModuleAdminController-architectuur, zonder Composer-afhankelijkheden.
  • Module vertaald in het Engels, Frans, Spaans, Duits, Italiaans, Nederlands, Pools en Portugees.
Was deze pagina nuttig?

Loopt u nog vast? Neem contact op met support