PS PrestaShop Anfänger

DataFirefly Advent Calendar: Adventskalender für PrestaShop

Installation und Update, Einstellungen und Erinnerungs-Cron, fertige Vorlagen, Türchen und Rabattcodes, Sofortgewinn, Vorschau, E-Mails, Verlosung, Statistiken und Fehlerbehebung.

Aktualisiert Modulversion 2.0.0

Installation und Update

Installieren Sie das Modul über Module > Modulverwaltung > Modul hochladen mit der ZIP-Datei, oder kopieren Sie den Ordner dfadventcalendar in das Verzeichnis /modules/ Ihres Shops und klicken Sie auf Installieren. Dieselbe ZIP-Datei funktioniert von PrestaShop 1.7.8 bis 9.x.

Die Installation legt die Tabellen des Moduls an, registriert seine Hooks, erstellt die Kalenderseite (eine Adresse pro Sprache) und fügt den Reiter Katalog > Rabatt > Adventskalender hinzu. Die Bilder der Türchen werden in /img/dfadventcalendar/ gespeichert, außerhalb des Modulordners.

Update von 1.0.0: Laden Sie die neue ZIP-Datei hoch, PrestaShop führt die Migration aus. Kalender, Türchen, Teilnehmer und Codes bleiben erhalten. Die bisherige Seitenadresse wird in allen Sprachen beibehalten, damit bereits per E-Mail versendete Links weiter funktionieren.

Moduleinstellungen

Die Konfigurationsseite des Moduls (Schaltfläche Konfigurieren) bündelt die Einstellungen für alle Kalender.

  • Adresse der Kalenderseite: eine Adresse pro Sprache, zum Beispiel /adventskalender auf Deutsch und /advent-calendar auf Englisch. Das Modul lehnt eine Adresse ab, die bereits von einer anderen Seite verwendet wird. Den SEO-Titel der Seite legen Sie unter Shopparameter > Traffic & SEO fest.
  • Zeitzone und Uhrzeit des Shops: Die Türchen öffnen sich in dieser Zeitzone, unabhängig von der Zeitzone des Besuchers oder des Servers.
  • Erinnerungen pro Cron-Lauf: maximale Anzahl an E-Mails pro Aufruf (standardmäßig 150).
  • Daten bei der Deinstallation behalten: Kalender, Türchen, Teilnehmer und Bilder bleiben in der Datenbank, bereit für eine Neuinstallation.
  • Testuhr (nur im Debug-Modus): Der ganze Kalender verhält sich, als wären es das eingegebene Datum und die Uhrzeit. Das Backoffice zeigt eine Warnung, solange sie gesetzt ist. Lassen Sie sie in einem Live-Shop nie aktiv.

Tägliche Erinnerung: Cron-Aufgabe

Kopieren Sie die angezeigte Cron-Adresse und planen Sie sie im Panel Ihres Hosters alle 15 Minuten ein:

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

Der Kalender funktioniert ohne Cron: Nur die Erinnerungs-E-Mails hängen davon ab. Der letzte Lauf wird angezeigt, und die Start-Checkliste im Dashboard meldet einen angehaltenen Cron.

DataFirefly Adventskalender: Moduleinstellungen: Seitenadresse pro Sprache, Zeitzone des Shops, Erinnerungs-Cron und Datenaufbewahrung
Moduleinstellungen: Seitenadresse pro Sprache, Zeitzone des Shops, Erinnerungs-Cron und Datenaufbewahrung

Einen Kalender erstellen

Öffnen Sie Katalog > Rabatt > Adventskalender. Am schnellsten starten Sie mit einer Vorlage: Daten, Anzahl der Türchen, Thema und Titel in allen Ihren Sprachen sind vorbereitet. Sie füllen dann nur noch die Türchen.

  • Adventskalender, 24 Türchen oder 25 Türchen mit dem Weihnachtstag, ab dem 1. Dezember;
  • Die 12 Tage vor Weihnachten, vom 13. bis 24. Dezember;
  • Black-Friday-Woche, 7 Türchen bis zum letzten Freitag im November;
  • Event-Countdown, 10 Türchen vor einem Launch oder einem Private Sale.

Mit Leerer Kalender oder Neuer Kalender wählen Sie jede Einstellung selbst.

DataFirefly Adventskalender: Kalenderliste mit fertigen Vorlagen: Advent, 12 Tage vor Weihnachten, Black-Friday-Woche und Event-Countdown
Kalenderliste mit fertigen Vorlagen: Advent, 12 Tage vor Weihnachten, Black-Friday-Woche und Event-Countdown

Daten und Öffnung

  • Datum des ersten Türchens und Anzahl der Türchen (1 bis 60): ein Türchen pro Tag ab diesem Datum.
  • Öffnungszeit der Türchen: 00:00 für Mitternacht oder eine feste Uhrzeit wie 08:00. Vor dieser Uhrzeit bleibt das Türchen vom Vortag das Türchen des Tages.

Aussehen

Neun Themen stehen zur Wahl: Tannenwald, Kraftpapier, Frost, Winternacht, Zuckerstange und vier Themen außerhalb von Weihnachten (Schwarz und Gold, Black Friday, Frühlingspastell, Sommerlagune). Die Option Eigene Farben aktiviert vier Farben. Drei Türchen-Stile sind verfügbar: aufklappbare Türchen, Geschenkboxen mit Schleife und minimalistische Kacheln. Die Dekoration belebt den Hintergrund: Schnee, Sterne, Konfetti oder keine. Eine Live-Vorschau zeigt das Ergebnis schon beim Einstellen.

Mit unterschiedlichen Größen füllt sich das Raster lückenlos auf 6 oder 4 Spalten. Auf dem Smartphone wechselt es zu 4 gleichmäßigen Spalten. Die Animationen stoppen für Besucher, die auf ihrem Gerät reduzierte Bewegung eingestellt haben.

DataFirefly Adventskalender: Einstellungen des Aussehens mit Live-Vorschau: Thema, Türchen-Stil und Dekoration
Einstellungen des Aussehens mit Live-Vorschau: Thema, Türchen-Stil und Dekoration

Teilnahme

  • E-Mail zum Öffnen der Türchen erforderlich: Wenn deaktiviert, öffnen Besucher frei, persönliche Codes und Spiele bleiben aber angemeldeten Teilnehmern vorbehalten.
  • Nur für Kundenkonten: Nur angemeldete Kunden nehmen teil, ihre Codes sind an ihr Konto gebunden. Das ist der beste Schutz gegen das Sammeln von Codes mit Wegwerfadressen.
  • E-Mail-Adresse bestätigen (Double-Opt-in) und optionales, nicht angehaktes Newsletter-Kästchen.
  • Öffnen vergangener Türchen erlauben: Gemeinsame Codes bleiben dann bis zum Ende des Kalenders gültig.
  • Einwilligungstext: Fügen Sie den Link zu Ihrer Datenschutzerklärung ein.

Die Türchen einrichten

Das Kalender-Dashboard zeigt die Türchen als Karten: Datum, Typ, Belohnung, Code, Öffnungen, enthüllte Codes und Bestellungen. Die Filter Einzurichten, Mit Code, Sofortgewinn, Heute und demnächst und Vergangen sowie die Suche finden ein Türchen sofort. Jede Karte erlaubt Bearbeiten, Vorschau und Aktivieren.

DataFirefly Adventskalender: visueller Türchen-Editor mit Filtern, Suche und Statistik pro Türchen
Visueller Türchen-Editor mit Filtern, Suche und Statistik pro Türchen

Türchen-Typen

  • Nachricht: Text, Bild und optionale Schaltfläche.
  • Rabattcode: Der Code steht auf einem Ticket im Mittelpunkt, zum Kopieren oder für den Warenkorb.
  • Enthülltes Produkt: Produktkarte mit Preis und Warenkorb-Schaltfläche.
  • Sofortgewinn: Der Teilnehmer versucht sein Glück und gewinnt den Preis mit der von Ihnen festgelegten Chance.

Belohnung und Code

Prozentrabatt, Betragsrabatt, kostenloser Versand, Gratisprodukt oder eine bestehende Warenkorbregel des Shops mit ihren eigenen Bedingungen. Für die vom Modul erstellten Belohnungen:

  • Persönlicher Code: Beim Öffnen des Türchens wird eine Warenkorbregel zur einmaligen Verwendung erzeugt. Sie ist an das Kundenkonto gebunden, wenn es bekannt ist, und gilt bis Mitternacht plus der gewählten zusätzlichen Gültigkeit.
  • Gleicher Code für alle: eine Warenkorbregel pro Türchen, automatisch synchronisiert. Lassen Sie das Feld leer für einen automatischen Code (Präfix, Jahr und Nummer, zum Beispiel ADVENT26-07).
  • Optionaler Mindestbestellwert und Beschränkung auf das enthüllte Produkt.

Mit den Schaltflächen vorheriges Türchen und nächstes Türchen füllen Sie den Kalender am Stück. Wenig Zeit? Leere Türchen füllen wendet einen fertigen Plan an, übersetzt in alle Ihre Sprachen.

Sofortgewinn

Stellen Sie die Gewinnchance (1 bis 100 %), die Anzahl der Preise (0 für unbegrenzt) und die Nachricht bei einer Niete ein. Die Ziehung erfolgt auf dem Server beim Öffnen des Türchens, einmal pro Teilnehmer. Erneutes Öffnen liefert dasselbe Ergebnis. Sind alle Preise gewonnen, sehen die folgenden Teilnehmer die Nachricht bei einer Niete.

DataFirefly Adventskalender: Sofortgewinn-Einstellungen eines Türchens: Gewinnchance, Anzahl der Preise und Nachricht bei Niete
Sofortgewinn-Einstellungen eines Türchens: Gewinnchance, Anzahl der Preise und Nachricht bei Niete

Vorschau und Start

Das Dashboard bündelt alles für den Start des Kalenders:

  • Vorschau am: Wählen Sie ein Datum und öffnen Sie den Kalender so, wie er an diesem Tag aussehen wird. Die angezeigten Codes sind Beispiele, nichts wird gespeichert. Vorschaulinks laufen nach 7 Tagen ab.
  • Start-Checkliste: Kalender aktiv, Türchen eingerichtet, Erinnerungs-Cron und Shop-E-Mails.
  • Mehr > Test-E-Mails an mich senden: Die vier E-Mails (Erinnerung, Willkommen, Bestätigung, Zugangslink) gehen an den angemeldeten Mitarbeiter, in seiner Sprache.
DataFirefly Adventskalender: Backoffice-Dashboard: Start-Checkliste, Teilnehmer, geöffnete Türchen, Codes, Bestellungen, Umsatz und Aktivitätsdiagramm
Backoffice-Dashboard: Start-Checkliste, Teilnehmer, geöffnete Türchen, Codes, Bestellungen, Umsatz und Aktivitätsdiagramm

Was Ihre Kunden sehen

Die Kalenderseite öffnet mit einem Countdown bis zum nächsten Türchen, das Türchen des Tages ist hervorgehoben. Nach der Anmeldung sieht der Teilnehmer seinen Fortschrittsring, seine Serie von Tagen in Folge und den Schalter für die tägliche Erinnerung.

DataFirefly Adventskalender: Adventskalender-Seite mit Countdown, Fortschrittsring, Tagesserie und großer Verlosung
Adventskalender-Seite mit Countdown, Fortschrittsring, Tagesserie und großer Verlosung

Die Türchen haben fünf Zustände: heute (animierter Schein), nachzuholen, geöffnet (Inhalt sichtbar), demnächst (Schloss und Datum) und verpasst. Ein Stern kennzeichnet Spiel-Türchen.

DataFirefly Adventskalender: Türchen-Raster: Türchen des Tages, geöffnete, nachzuholende und kommende Türchen
Türchen-Raster: Türchen des Tages, geöffnete, nachzuholende und kommende Türchen

Beim Öffnen zeigt ein Fenster die Überraschung: Produkt mit Preis, Code auf einem Ticket, Schaltflächen In meinen Warenkorb und Kopieren. Ist der Warenkorb leer, wird der Code 14 Tage gespeichert und beim ersten Produkt angewendet.

DataFirefly Adventskalender: Türchen des Tages enthüllt ein Produkt und einen persönlichen Rabattcode zum Kopieren oder für den Warenkorb
Türchen des Tages enthüllt ein Produkt und einen persönlichen Rabattcode zum Kopieren oder für den Warenkorb

Die Übersicht Ihre Codes listet die gesammelten Codes mit Gültigkeit und Status (eingelöst, abgelaufen).

DataFirefly Adventskalender: Übersicht der gesammelten Codes des Teilnehmers mit Kopieren und In-den-Warenkorb
Übersicht der gesammelten Codes des Teilnehmers mit Kopieren und In-den-Warenkorb

Auf dem Smartphone wechselt das Raster zu 4 gleichmäßigen Spalten, die Bereiche stehen untereinander.

DataFirefly Adventskalender: Adventskalender auf dem Smartphone mit Teilnahmebereich und Türchen
Adventskalender auf dem Smartphone mit Teilnahmebereich und Türchen

Sofortgewinnspiel

Ein Spiel-Türchen lässt den Teilnehmer sein Glück versuchen. Gewinnt er, erhält er den Code wie bei einem normalen Türchen. Andernfalls sieht er die Nachricht bei einer Niete und kann beim nächsten Spiel-Türchen erneut spielen. Ein nicht angemeldeter Besucher wird gebeten, seine E-Mail zu hinterlassen: eine Chance pro Teilnehmer.

DataFirefly Adventskalender: Sofortgewinn-Türchen: Der Teilnehmer gewinnt einen Rabattcode
Sofortgewinn-Türchen: Der Teilnehmer gewinnt einen Rabattcode

Startseiten-Banner und schwebende Schaltfläche

Das Banner erscheint während des Kalenders auf der Startseite und auf Wunsch einige Tage vor dem Start. Die schwebende Schaltfläche, aktivierbar in den Kalendereinstellungen, erinnert auf allen Seiten an das Türchen des Tages. Besucher können sie bis zum nächsten Tag ausblenden. Um das Banner an anderer Stelle zu zeigen, fügen Sie {hook h='displayDfAdventCalendar'} in ein Template Ihres Themes ein.

DataFirefly Adventskalender: Banner auf der Startseite und schwebende Schaltfläche mit dem Türchen des Tages
Banner auf der Startseite und schwebende Schaltfläche mit dem Türchen des Tages

Countdowns außerhalb von Weihnachten

Dasselbe Modul belebt jeden Höhepunkt: Black-Friday-Woche, Launch einer Kollektion, Sale, Shop-Jubiläum. Wählen Sie eine Countdown-Vorlage, ein Thema wie Schwarz und Gold, minimalistische Kacheln und eine Öffnungszeit. Vor dem Start zeigt die Seite den Countdown bis zum ersten Türchen.

DataFirefly Adventskalender: Event-Countdown-Kalender außerhalb von Weihnachten, Thema Schwarz und Gold mit minimalistischen Kacheln
Event-Countdown-Kalender außerhalb von Weihnachten, Thema Schwarz und Gold mit minimalistischen Kacheln

Erinnerungen und E-Mails

Jeden Tag ab der gewählten Uhrzeit (nie vor dem Öffnen der Türchen) kündigt eine kurze E-Mail das Türchen des Tages an bestätigte Teilnehmer an, die es noch nicht geöffnet haben. Ein Teilnehmer erhält höchstens eine Erinnerung pro Tag und keine am Tag seiner Anmeldung: Die Willkommens-E-Mail genügt. Die E-Mails tragen die Farben des Kalenderthemas.

DataFirefly Adventskalender: tägliche Erinnerungs-E-Mail mit dem Türchen des Tages
Tägliche Erinnerungs-E-Mail mit dem Türchen des Tages

Vier Vorlagen liegen in acht Sprachen in mails/: dfadvent_reminder (Erinnerung), dfadvent_welcome (Willkommen), dfadvent_confirm (Adressbestätigung) und dfadvent_access (Zugangslink). Wer seine Adresse erneut eingibt, erhält einen Zugangslink: Das Modul meldet niemanden allein über eine eingegebene Adresse an, und dieselbe Adresse erhält höchstens eine E-Mail alle 2 Minuten. Zum Anpassen kopieren Sie die Vorlagen nach themes/ihr-theme/modules/dfadventcalendar/mails/.

DataFirefly Adventskalender: Willkommens-E-Mail zur Bestätigung der Teilnahme in den Farben des Kalenders
Willkommens-E-Mail zur Bestätigung der Teilnahme in den Farben des Kalenders

Teilnehmer

Die Teilnehmerliste lässt sich mit einem Klick filtern: bestätigt, wartet auf Bestätigung, Erinnerungen aktiv, Newsletter, Kundenkonten, Gewinner der Verlosung. Sie zeigt die geöffneten Türchen und die gesammelten Codes jedes Teilnehmers und lässt sich als CSV exportieren.

DataFirefly Adventskalender: Teilnehmer mit Schnellfiltern: bestätigt, wartend, Erinnerungen, Newsletter, Kundenkonten
Teilnehmer mit Schnellfiltern: bestätigt, wartend, Erinnerungen, Newsletter, Kundenkonten

Große Verlosung

Legen Sie in den Kalendereinstellungen die Mindestanzahl geöffneter Türchen für die Teilnahme fest (0 deaktiviert die Verlosung) und beschreiben Sie den Preis. Das Dashboard zeigt die Zahl der Teilnahmeberechtigten. Die Schaltfläche Gewinner ziehen wählt zufällig unter den berechtigten, bestätigten Teilnehmern, frühere Gewinner ausgenommen. Jede Ziehung wird protokolliert.

Eine Verlosung und ein Sofortgewinnspiel unterliegen den Regeln für Gewinnspiele. Veröffentlichen Sie vor dem Start Teilnahmebedingungen in Ihrem Shop.

Statistiken

Das Dashboard zeigt die Teilnehmer (bestätigt, mit Kundenkonto), die geöffneten Türchen und den Durchschnitt pro Teilnehmer, die enthüllten Codes und den Anteil eingelöster persönlicher Codes, die gültigen Bestellungen mit einem Code, den Nettoumsatz dieser Bestellungen und die aktiven Erinnerungen. Das Aktivitätsdiagramm zeigt Türchen für Türchen die Öffnungen und die Anmeldungen des Tages.

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

Das Menü Mehr > Für nächstes Jahr duplizieren kopiert den Kalender und seine Türchen ein Jahr später, inaktiv, ohne Teilnehmer oder Codes.

Personenbezogene Daten

  • Das Einwilligungskästchen ist Pflicht, das Newsletter-Kästchen ist getrennt und nicht angehakt.
  • Jede Erinnerungs-E-Mail enthält einen Abmeldelink mit einem Klick.
  • Die IP-Adresse wird nur gehasht gespeichert, um Anmeldungen auf 5 pro Stunde und Verbindung zu begrenzen.
  • Das Modul beantwortet die PrestaShop-Anfragen zum Export (inklusive Codes) und zur Löschung personenbezogener Daten.

Fehlerbehebung

Die Erinnerungen werden nicht versendet

Prüfen Sie die Start-Checkliste im Dashboard: Cron in den letzten 24 Stunden gelaufen, Shop-E-Mails aktiviert. Die Erinnerungen gehen ab der gewählten Uhrzeit raus, und nur an bestätigte Teilnehmer, die das Türchen des Tages noch nicht geöffnet haben.

Die Kalenderseite liefert einen 404-Fehler

Prüfen Sie, ob die suchmaschinenfreundlichen URLs aktiviert sind, und leeren Sie den Cache. Kollidiert die Adresse mit einer anderen Seite, ändern Sie sie in den Moduleinstellungen.

Ein Türchen bleibt an seinem Tag geschlossen

Prüfen Sie die Öffnungszeit des Kalenders und die Zeitzone des Shops (International > Lokalisierung). Ein nicht eingerichtetes oder inaktives Türchen bleibt geschlossen.

Der Code wird nicht in den Warenkorb gelegt

Die angezeigte Meldung stammt von PrestaShop: Mindestbestellwert nicht erreicht, Code abgelaufen oder an ein anderes Kundenkonto gebunden. Ist der Warenkorb leer, bleibt der Code vorgemerkt und wird beim ersten Produkt angewendet.

Kompatibilität

  • PrestaShop 1.7.8 bis 9.x, dieselbe ZIP-Datei für alle Versionen.
  • Themes Classic, Hummingbird und Child-Themes.
  • Multistore (ein Kalender pro Shop) und mehrere Währungen (Beträge in die Währung des Besuchers umgerechnet).
  • Architektur ModuleAdminController, ohne Composer-Abhängigkeiten.
  • Modul übersetzt in Englisch, Französisch, Spanisch, Deutsch, Italienisch, Niederländisch, Polnisch und Portugiesisch.
War diese Seite hilfreich?

Immer noch nicht weiter? Support kontaktieren