Flash Sale & Countdown — Vollständige Anleitung

Überblick und Voraussetzungen

Flash Sale verwandelt Ihre Aktionen in echte zeitlich begrenzte Flash-Sales. Sie planen eine Kampagne über ein Datumsfenster; das Modul wendet den Rabatt automatisch über die nativen spezifischen Preise von PrestaShop an und zeigt einen mit der Serverzeit synchronisierten Countdown. Der Aktionspreis gilt somit überall — Produktseite, Listen, Warenkorb und E-Mails — ohne jede Änderung an Ihrem Theme.

• Kompatibel mit PrestaShop 8.0 bis 9.x, Classic-Theme und abgeleitete Themes.
• PHP 7.4 bis 8.3.
• Multistore und mehrsprachig (FR/EN/ES/DE/IT).
• Keine CRON-Aufgabe erforderlich: Aktivierung und Abschaltung des Rabatts steuern die Daten des spezifischen Preises.
• PrestaShop-konforme Architektur (ModuleAdminController, ObjectModel), PSR-4-Autoloader ohne Composer-Abhängigkeit.

Installation

Installieren Sie das Modul wie jedes PrestaShop-Modul:

1. Laden Sie das Archiv dfflashsale.zip aus Ihrem Kundenkonto herunter.
2. Gehen Sie im Backoffice zu Module > Modulmanager.
3. Klicken Sie auf Ein Modul hochladen und legen Sie das Archiv ab.
4. Verwalten Sie Ihre Kampagnen nach der Installation über Katalog > Flash-Sales.

Bei der Installation erstellt das Modul seine Tabellen (Kampagnen, Ausrichtung, Zuordnung der spezifischen Preise), registriert seine Anzeige-Hooks und fügt den Tab Flash-Sales unter Katalog hinzu.

Allgemeine Moduleinstellungen

Die Konfigurationsseite (Konfigurieren im Modulmanager) bündelt die globalen, für alle Kampagnen gemeinsamen Einstellungen:

• Countdown mit dem Server synchronisieren: richtet die Uhr nach der Serverzeit aus (empfohlen). Siehe den eigenen Abschnitt.
• Seiteninhalt verschieben (Push Body): fügt automatisch einen Abstand hinzu, damit der Sticky-Banner den Inhalt nie überdeckt.
• Banner auf Mobilgeräten anzeigen: zeigt oder verbirgt den Banner auf kleinen Bildschirmen.
• Z-Index des Banners: Stapelebene des Banners; erhöhen Sie sie, wenn ein Theme-Element darüber erscheint.

Eine Flash-Sale-Kampagne anlegen

Klicken Sie im Tab Katalog > Flash-Sales auf Kampagne hinzufügen. Das Formular ist in Panels gegliedert.

Allgemein

• Name: interner Bezeichner der Kampagne (frei).
• Aktiv: aktiviert oder pausiert die Kampagne.
• Start-/Enddatum: das Aktivitätsfenster. Rabatt und Countdown stützen sich auf diese Daten.
• Priorität: Wenn mehrere Kampagnen dasselbe Produkt betreffen, gewinnt für die Anzeige die mit der höchsten Priorität.
• Shops: Wählen Sie im Multistore die betroffenen Shops.

Rabatt

• Rabattart: Prozentsatz (z. B. -30 %) oder Festbetrag (z. B. -15 €).
• Wert: der Prozentsatz oder der Betrag des Rabatts.
• Währung: bei einem Festbetragsrabatt die Referenzwährung.
• Steuer: gibt an, ob der Festbetrag inklusive oder exklusive Steuer gilt.

Ausrichtung

Wählen Sie den Umfang der Kampagne:

• Gesamter Katalog: Der Rabatt gilt für alle Produkte.
• Kategorien: Wählen Sie eine oder mehrere Kategorien. Die Option Unterkategorien einbeziehen erweitert den Rabatt auf den gesamten Baum.
• Produkte: Suchen und wählen Sie bestimmte Produkte (nach Name, Referenz oder ID).

Anzeige

• Countdown-Banner: zeigt die globale Promo-Leiste.
• Bannerposition: oben oder unten auf der Seite.
• Sticky-Banner: hält den Banner beim Scrollen sichtbar.
• Auf Produktseiten anzeigen: fügt unter dem Preis eine Countdown-Karte hinzu.
• Auf der Startseite anzeigen: fügt einen Promo-Block auf der Startseite hinzu.
• Teaser vor dem Start: zeigt vor dem Startdatum einen „startet in…“-Countdown.
• Am Ende des Countdowns: das Element ausblenden oder eine Endnachricht anzeigen.

Erscheinungsbild und Texte

Im Panel Erscheinungsbild stellen Sie die Hintergrundfarbe, die Textfarbe und die Akzentfarbe sowie den Link der Call-to-Action-Schaltfläche (CTA) ein. Das Panel Texte bündelt die übersetzbaren Beschriftungen: Bannertitel und -untertitel, Schaltflächentext und Endnachricht, für jede Shop-Sprache editierbar.

Wie die Planung funktioniert

Beim Speichern einer Kampagne erstellt das Modul die zur Ausrichtung passenden spezifischen Preise: einen globalen spezifischen Preis (Produkt 0) für „gesamter Katalog“ oder je einen spezifischen Preis pro Produkt für die Kategorie- und Produktausrichtung. Das Gültigkeitsfenster jedes spezifischen Preises ist an Start- und Enddatum der Kampagne ausgerichtet.

PrestaShop schaltet den Rabatt also selbst ein und aus, sekundengenau, ohne geplante Aufgabe. Die IDs der erstellten spezifischen Preise werden in einer Zuordnungstabelle gespeichert, damit sie beim Bearbeiten, Löschen der Kampagne oder beim Deinstallieren sauber entfernt werden.

Der serversynchrone Countdown

Der Countdown ist an der Serverzeit ausgerichtet, nicht an der des Besuchers. Beim Rendern übergibt das Modul den Server-Zeitstempel und das Enddatum; das Skript berechnet einen Versatz zwischen Serverzeit und lokaler Zeit und zählt dann lokal ab diesem Versatz herunter.

Ein Besucher, der die Uhr seines Computers vor- oder zurückstellt, verfälscht den Timer also nicht. Es ist kein wiederholter Netzwerkaufruf nötig, und der Countdown bleibt für alle flüssig und korrekt.

Der Evergreen-Modus

Der Evergreen-Modus verwandelt die Kampagne in einen individuellen Dauertimer: Jeder Besucher erhält seine eigene Frist, ausgelöst bei seinem ersten Besuch und basierend auf einer von Ihnen festgelegten Dauer in Minuten. Die Frist wird lokal (localStorage) gespeichert, um über Seiten und Besuche hinweg konsistent zu bleiben.

Mehrsprachig und Multistore

Alle Beschriftungen (Titel, Untertitel, Schaltfläche, Endnachricht) sind je Sprache übersetzbar. Im Multistore lässt sich jede Kampagne auf bestimmte Shops beschränken, und die spezifischen Preise werden pro Shop erstellt. Eine einzelne Kampagne kann so einen bestimmten Shop ansprechen, ohne die anderen zu beeinflussen.

FAQ und Fehlerbehebung

Der Rabatt wird nicht angewendet

Prüfen Sie, ob die Kampagne aktiv ist, ob das heutige Datum zwischen Start- und Enddatum liegt und ob sie den aktuellen Shop betrifft. Stellen Sie bei einer Kategorieausrichtung sicher, dass Sie die Kampagne nach jeder Umstrukturierung des Baums erneut gespeichert haben.

Der Banner überdeckt mein Menü oder meinen Inhalt

Aktivieren Sie die Option Seiteninhalt verschieben (Push Body) in den allgemeinen Einstellungen. Wenn ein Theme-Element über dem Banner erscheint, erhöhen Sie den Wert des Z-Index.

Der Countdown zeigt eine inkonsistente Zeit

Stellen Sie sicher, dass die Zeit Ihres Servers korrekt und die Serversynchronisation aktiv ist. Der Timer richtet sich nach der Serverzeit, unabhängig von der Uhr des Besuchers.

Mehrere Kampagnen betreffen dasselbe Produkt

Die Anzeige behält die Kampagne mit der höchsten Priorität. Für den Rabatt gilt die Prioritätslogik der spezifischen Preise von PrestaShop.

Was passiert bei der Deinstallation?

Die Deinstallation entfernt über die Zuordnungstabelle alle vom Modul erstellten spezifischen Preise, löscht seine Hooks und seinen Tab und bereinigt seine Tabellen. Ihre ursprünglichen Preise werden vollständig wiederhergestellt.