DataFirefly Advent Calendar: Adventskalender für PrestaShop

Installation

Installieren Sie das Modul über Module > Modulmanager > Modul hochladen mit der ZIP-Datei, oder kopieren Sie den Ordner dfadventcalendar in das Verzeichnis /modules/ Ihres Shops und klicken Sie auf Installieren.

Die Installation legt die Tabellen des Moduls an, registriert seine Hooks und fügt den Reiter Katalog > Rabatte > Adventskalender hinzu. Für Türchen hochgeladene Bilder liegen in /img/dfadventcalendar/, außerhalb des Modulordners, damit sie Updates überstehen.

Moduleinstellungen und Cronjob

Die Konfigurationsseite des Moduls (Button Konfigurieren im Modulmanager) enthält drei Einstellungen und die Cron-URL.

Adresse der Kalenderseite

Letzter Teil der Kalender-URL, für alle Sprachen gleich (PrestaShop fügt das Sprachpräfix hinzu, zum Beispiel /en/). Der Standardwert hängt von der Hauptsprache des Shops ab: /adventskalender auf Deutsch, /advent-calendar auf Englisch, /calendrier-de-l-avent auf Französisch. Suchmaschinenfreundliche URLs müssen in PrestaShop aktiviert sein.

Tägliche Erinnerung: Cronjob

Erinnerungs-E-Mails werden per Cronjob versendet. Kopieren Sie die angezeigte URL und planen Sie sie alle 15 Minuten in Ihrem Hosting-Panel ein, zum Beispiel:

*/15 * * * * curl -s "https://www.ihr-shop.de/module/dfadventcalendar/cron?token=IHR_TOKEN" > /dev/null

Bei jedem Aufruf verschickt das Modul die Erinnerungen des Tages ab der im Kalender eingestellten Uhrzeit, in Paketen (standardmäßig 150, einstellbar unter „Erinnerungen pro Cron-Lauf“). Jeder Teilnehmer erhält höchstens eine Erinnerung pro Tag, und nur, wenn er das heutige Türchen noch nicht geöffnet hat. Das Datum des letzten Laufs steht unter der URL; „Neues Cron-Token erzeugen“ macht die alte URL ungültig.

Einen Kalender anlegen

Öffnen Sie Katalog > Rabatte > Adventskalender und klicken Sie auf Neuer Kalender.

Daten und Türchen

• Datum des ersten Türchens: Türchen 1 öffnet um Mitternacht an diesem Tag, in der Zeitzone des Shops, danach ein Türchen pro Tag.
• Anzahl der Türchen: 24 für einen klassischen Kalender, 25 mit dem Weihnachtstag, von 1 bis 31.
• Vergangene Türchen öffnen erlauben: Wer einen Tag verpasst hat, kann das Türchen bis zum Ende des Kalenders nachholen.

Beim Speichern legt das Modul die leeren Türchen an. Sie bleiben geschlossen, bis Sie sie einrichten und aktivieren.

Aussehen

Fünf Designs stehen zur Wahl: Tannenwald, Kraftpapier, Raureif, Winternacht und Zuckerstange. Eigene Farben schaltet vier Farben frei (Hintergrund, Text, Türchen, Akzent). Dazu kommen ein Hintergrundbild (JPG, PNG oder WebP, max. 5 MB), fallender Schnee, gemischte Türchen und unterschiedliche Türchengrößen.

Bei unterschiedlichen Größen legt das Modul selbst fest, welche Türchen breit oder groß sind, damit sich das Raster je nach Bildschirm auf 6, 4 oder 3 Spalten lückenlos füllt. Das letzte Türchen ist immer das größte.

Teilnahme

• E-Mail zum Öffnen der Türchen erforderlich: deaktiviert öffnen Besucher frei, persönliche Codes bleiben aber angemeldeten Teilnehmern vorbehalten.
• E-Mail-Adresse bestätigen (Double-Opt-in): Der Teilnehmer klickt vor dem Öffnen der Türchen auf einen Link in einer E-Mail. Empfohlen gegen falsche Adressen.
• Newsletter-Kontrollkästchen: fügt ein optionales, nicht vorausgewähltes Kästchen hinzu. Die Anmeldung läuft über den nativen Kunden-Newsletter oder das Modul ps_emailsubscription, falls installiert.
• Einwilligungstext: steht neben dem Pflicht-Kästchen. Verlinken Sie hier Ihre Datenschutzerklärung.

Erinnerungen

Aktivieren Sie die Tägliche Erinnerungs-E-Mail und wählen Sie die Uhrzeit der Erinnerung. Teilnehmer können die Erinnerungen auf der Kalenderseite oder über den Link in jeder E-Mail abbestellen.

Banner auf der Startseite

Das Banner erscheint während des Kalenders auf der Startseite und auf Wunsch schon einige Tage vorher mit Countdown. Um es an anderer Stelle im Theme anzuzeigen, fügen Sie {hook h='displayDfAdventCalendar'} in ein Template ein.

Türchen einrichten

Klicken Sie im Dashboard des Kalenders auf Türchen und dann bei jedem Türchen auf Bearbeiten.

Türchen-Typen

• Nachricht: Text und Bild.
• Rabattcode: Der Code steht im Öffnungsfenster im Mittelpunkt.
• Enthülltes Produkt: Produktkarte mit Preis und Warenkorb-Button. Suchen Sie das Produkt nach Name oder Artikelnummer.

Das Feld Teaser für die Erinnerungs-E-Mail ist der Satz in der Erinnerung des Tages: Neugier wecken, ohne die Überraschung zu verraten.

Belohnung

Prozentrabatt, Betragsrabatt (brutto, Standardwährung), kostenloser Versand oder Gratisprodukt, optional mit Mindestbestellwert. Bei einem Produkt-Türchen beschränkt „Rabatt nur auf das enthüllte Produkt anwenden“ den Code auf dieses Produkt.

Code-Art

• Persönlicher Code: Beim Öffnen des Türchens wird eine Einmal-Warenkorbregel erzeugt. Sie ist mit dem Kundenkonto verknüpft, wenn es bekannt ist, und gilt bis Mitternacht am Öffnungstag plus der gewählten zusätzlichen Gültigkeit.
• Gleicher Code für alle: eine Warenkorbregel pro Türchen, vom Modul angelegt und synchronisiert. Feld leer lassen für einen automatischen Code (Präfix, Jahr und Türchennummer, zum Beispiel ADVENT26-07) oder eigenen Code eingeben. Die Gültigkeit zählt ab dem Datum des Türchens.

Vorschau vor dem Start

Der Button Vorschau im Dashboard zeigt den Kalender so, wie er an einem bestimmten Tag aussieht, und das Augensymbol jeder Zeile öffnet direkt das Türchen dieses Tages. In der Vorschau sind die Codes Beispiele und es wird nichts gespeichert. Die Seite wird nicht indexiert.

Mehr > Test-E-Mails an mich senden schickt die drei E-Mails (Erinnerung, Willkommen, Bestätigung) an den angemeldeten Mitarbeiter, in dessen Sprache.

Was der Kunde sieht

• Einen Countdown bis zum nächsten Türchen und, für Teilnehmer, einen Fortschrittsbalken.
• Das heutige Türchen hervorgehoben. Die Türchen öffnen sich in 3D, beim ersten Mal mit Konfetti. Für Besucher, die weniger Bewegung wünschen, sind die Animationen abgeschaltet.
• Einen Button In meinen Warenkorb unter jedem Code. Ist der Warenkorb leer, wird der Code 14 Tage gemerkt und mit dem ersten Produkt angewendet.
• Die Übersicht Ihre Codes unter dem Raster, mit Gültigkeit und Status jedes Codes (eingelöst, abgelaufen).
• Einen Teilen-Button für den Kalender und einen Link im Kundenkonto.

Ein bereits angemeldeter Teilnehmer, der seine Adresse erneut eingibt, erhält einen Anmeldelink per E-Mail: Das Modul meldet niemanden allein über eine eingetippte Adresse an.

Große Verlosung

In den Kalendereinstellungen legt das Feld Große Verlosung die Mindestzahl geöffneter Türchen für die Teilnahme fest (0 deaktiviert die Verlosung), und Preis der Verlosung beschreibt den im Kalender angezeigten Preis.

Das Panel Große Verlosung im Dashboard zeigt die Zahl der berechtigten Teilnehmer. Gewinner auslosen wählt zufällig unter den berechtigten, bestätigten Teilnehmern, frühere Gewinner ausgeschlossen. Jede Ziehung wird mit E-Mail, geöffneten Türchen, Zahl der Berechtigten und Datum protokolliert.

Dashboard und Statistiken

Das Dashboard zeigt Teilnehmer, bestätigte Teilnehmer, aktive Erinnerungen, Newsletter-Anmeldungen, mit einem Code aufgegebene Bestellungen und den Nettoumsatz. Pro Türchen: Öffnungen, Bestellungen und Umsatz. Die Teilnehmer lassen sich über die Liste Teilnehmer als CSV exportieren.

Mehr > Für das nächste Jahr duplizieren kopiert den Kalender mit Türchen, Texten und Bildern, verschiebt das Datum um ein Jahr und lässt ihn inaktiv, ohne Teilnehmer und Codes.

Ist Google Tag Manager eingebunden, sendet das Modul diese Events an den dataLayer: dfadv_join, dfadv_door_open, dfadv_code_copy, dfadv_code_apply und dfadv_share.

E-Mails

Drei Vorlagen liegen in acht Sprachen in mails/: dfadvent_reminder (Erinnerung), dfadvent_confirm (Bestätigung und Anmeldelink) und dfadvent_welcome (Willkommen). Um sie anzupassen, ohne Änderungen beim Update zu verlieren, kopieren Sie sie nach themes/ihr-theme/modules/dfadventcalendar/mails/.

Personenbezogene Daten

• Das Einwilligungskästchen ist Pflicht, das Newsletter-Kästchen ist separat und nicht vorausgewählt.
• Jede Erinnerungs-E-Mail enthält einen Abmeldelink für einen Klick.
• IP-Adressen werden nur gehasht gespeichert, um Anmeldungen auf 5 pro Stunde und Verbindung zu begrenzen.
• Das Modul beantwortet die Export- und Löschanfragen für personenbezogene Daten von PrestaShop.

Fehlerbehebung

Erinnerungen werden nicht verschickt

Prüfen Sie das Datum des letzten Cron-Laufs in der Modulkonfiguration, ob die Erinnerungen im Kalender aktiviert sind und ob die Erinnerungszeit bereits vorbei ist. Nur bestätigte Teilnehmer, die das heutige Türchen noch nicht geöffnet haben, erhalten eine Erinnerung. Testen Sie den Versand mit „Test-E-Mails an mich senden“.

Die Kalenderseite liefert einen 404-Fehler

Prüfen Sie, ob suchmaschinenfreundliche URLs aktiviert sind, und leeren Sie den PrestaShop-Cache. Kollidiert die Adresse mit einer CMS-Seite oder Kategorie, ändern Sie sie in der Modulkonfiguration.

Der Code landet nicht im Warenkorb

Die angezeigte Meldung stammt von PrestaShop: Mindestbestellwert nicht erreicht, Code abgelaufen, oder ein persönlicher Code ist mit einem Kundenkonto verknüpft, während der Kunde abgemeldet ist. Im letzten Fall bleibt der Code vorgemerkt und wird nach der Anmeldung im nächsten Warenkorb angewendet.

Ein Türchen bleibt an seinem Tag geschlossen

Die Türchen öffnen um Mitternacht in der Zeitzone des Shops (International > Lokalisierung > Konfiguration). Prüfen Sie außerdem, ob das Türchen aktiv ist: Ein nicht eingerichtetes Türchen bleibt geschlossen.

Kompatibilität

• PrestaShop 8.0 bis 9.x, ein ZIP für beide Versionen.
• Themes Classic, Hummingbird und Child-Themes.
• Multistore und mehrsprachig.
• Architektur ModuleAdminController, ohne Composer-Abhängigkeiten.
• Modul übersetzt in Englisch, Französisch, Spanisch, Deutsch, Italienisch, Niederländisch, Polnisch und Portugiesisch.