DataFirefly Live Shopping — Komplette Anleitung

Überblick

Das Modul DataFirefly Live Shopping (dflive) macht Ihren PrestaShop-Shop zur Plattform für Live-Video-Verkauf. Sie senden einen Live-Stream, pinnen Produkte in Echtzeit an, starten Flash-Angebote, Ihre Kunden legen Produkte in den Warenkorb, ohne den Stream zu verlassen, und die Session bleibt als Replay verfügbar. Alles läuft in Ihrem Shop: keine Live-Shopping-Plattform eines Drittanbieters, kein wiederkehrendes Abo.

Kompatibilität

• PrestaShop 1.7.0 bis 1.7.8, 8.x und 9.x (seit Modulversion 1.1.0)
• PHP 5.6 bis 8.3, je nach PrestaShop-Version
• Themes Classic und Hummingbird sowie darauf basierende Themes
• Einzelshop und Multistore
• Mehrsprachig (5 Sprachen enthalten: FR, EN, ES, DE, IT)
• Keine Abhängigkeiten (weder Composer noch Framework); hls.js ist im Modul enthalten
• Shared-Hosting-kompatibel (Synchronisation per AJAX-Polling, ohne WebSocket oder SFU)

Voraussetzungen

Das Modul übernimmt die Wiedergabe des Videos und die gesamte Shopping-Ebene; die Videoquelle stellen Sie bereit. Je nach Modus:

• HLS: ein .m3u8-Stream von Ihrem eigenen HLS-Server, von Mux oder Cloudflare Stream, gespeist von einem Encoder wie OBS.
• MP4: eine URL zu einer öffentlich erreichbaren .mp4-Datei.
• Embed: ein YouTube-, Twitch- oder Vimeo-Livestream (URL oder <iframe>-Code).

Für die Erinnerungen „Benachrichtige mich“ muss Ihr Shop E-Mails versenden können (Erweiterte Einstellungen > E-Mail).

Installation

1. Öffnen Sie im Backoffice Module > Modul-Manager.
2. Klicken Sie auf Modul hochladen und wählen Sie die Datei dflive.zip.
3. Öffnen Sie nach der Installation Verkauf > Live Shopping > Lives & Replays.

Update von Version 1.0.0

1. Laden Sie unter Module > Modul-Manager die neue dflive.zip hoch (oder ersetzen Sie den Ordner modules/dflive per FTP).
2. Klicken Sie in der Modulzeile auf Aktualisieren, falls PrestaShop dies anbietet.

Das Update-Skript 1.1.0 läuft automatisch und ohne Datenverlust. Es:

• ergänzt die nötigen Spalten (Anti-Flood für Gäste, Sprache und Shop der Erinnerungen);
• ordnet Ihre bestehenden Lives allen Ihren Shops zu;
• ersetzt leere, als 0000-00-00 gespeicherte Datumswerte durch Nullwerte;
• entfernt den nicht mehr benötigten Hook displayHeader.

Ein Live anlegen

Klicken Sie unter Verkauf > Live Shopping > Lives & Replays auf Neu hinzufügen. Das Formular ist in Tabs gegliedert:

Allgemein

• Titel und Beschreibung des Lives (mehrsprachig).
• Moderator / Host: Name, der im Chat und unter dem Video als Host erscheint.
• Geplantes Datum / Uhrzeit: startet den Countdown für Zuschauer.
• Status: geplant, live oder beendet. Der Status lässt sich auch im Studio steuern; eine Änderung im Formular hat dieselben Folgen (Datumswerte, Bereinigung der Angebote, Aktualisierung bei den Zuschauern).
• Titelbild: JPG, PNG, GIF oder WebP, angezeigt vor dem Live und in den Listen. Der tatsächliche Dateityp wird geprüft: Andere Dateien werden abgelehnt.

Video

• Art der Videoquelle: HLS, MP4 oder Embed.
• Videoquelle: die .m3u8-URL, die .mp4-URL oder die Embed-URL / der <iframe>-Code je nach Typ. Bei Embed-Code wird für Zuschauer nur die Adresse des iframes verwendet.
• Replay-URL (VOD) (optional): z. B. die Aufzeichnung Ihres HLS-Servers, die nach dem Ende des Lives automatisch abgespielt wird.

Produkte

Ordnen Sie die im Live vorgestellten Produkte über die AJAX-Suche zu (Name, Artikelnummer oder ID). Ändern Sie die Reihenfolge der Leiste per Drag & Drop. Ein deaktiviertes Produkt bleibt in der Liste, wird im Live aber nicht angezeigt.

Optionen

Aktivieren oder deaktivieren Sie Chat, Reaktionen und Replay für diese Session sowie ihre Sichtbarkeit im Shop. Im Multistore wählen Sie die Shops, in denen das Live erscheint.

SEO

Tragen Sie Meta-Titel, Meta-Beschreibung und bei Bedarf die sprechende URL der Live-Seite ein (leer gelassen, wird sie aus dem Titel erzeugt).

Den Stream senden

Für ein HLS-Live gilt:

1. Konfigurieren Sie Ihren Encoder (z. B. OBS) für das Senden an Ihren HLS-Server, Mux oder Cloudflare Stream.
2. Kopieren Sie die ausgegebene .m3u8-URL in das Feld Videoquelle der Session.
3. Starten Sie das Senden im Encoder, öffnen Sie das Studio und klicken Sie auf Live gehen.

Der Stream wird bei den Zuschauern erst beim Start des Lives geladen. Ist der HLS-Stream vorübergehend nicht verfügbar (Encoder startet später, Netzwerkabbruch), versucht der Player es automatisch erneut.

Das Studio (Regie)

Das Studio ist die Regie im Backoffice. Öffnen Sie es über den Button Studio in der Live-Liste.

• Live gehen / Beenden: wechselt den Status der Session. Beim Start erhalten die „Benachrichtige mich“-Anmeldungen ihre E-Mail. Beim Beenden werden laufende Flash-Angebote entfernt und das angepinnte Produkt gelöst.
• Anpinnen: Die Produktkarte erscheint sofort über dem Video der Zuschauer, auch bei später Hinzukommenden. Das Anpinnen eines Produkts löst automatisch das vorherige. Der Zeitpunkt der ersten Vorstellung wird für die Replay-Zeitleiste gespeichert.
• Flash-Angebot: Geben Sie einen Rabatt ein (z. B. 20% oder 10) und bei Bedarf eine Dauer (5 bis 60 Minuten oder unbegrenzt). Das Modul legt spontan einen SpecificPrice an, der neue Preis erscheint sofort bei den Zuschauern. Der Button × beendet das Angebot und stellt den Normalpreis für alle wieder her.
• Angepinnte Ankündigung: zeigt ein Banner über dem Video der Zuschauer und fügt die Nachricht angepinnt in den Chat ein.
• Nachricht als Host: schreibt im Namen des Hosts in den Chat.
• Moderation: jede Nachricht ausblenden, einblenden oder anpinnen. Eine ausgeblendete Nachricht verschwindet auch bei Zuschauern, die sie bereits erhalten hatten.
• Live-Statistiken: Zuschauer, Reaktionen und Erinnerungs-Anmeldungen in Echtzeit.

Erinnerungen „Benachrichtige mich“

Bei einer geplanten Session gibt der Zuschauer seine E-Mail-Adresse ein (bei Anmeldung vorausgefüllt) und klickt auf Benachrichtige mich. Die Anzahl der Anmeldungen wird auf der Live-Seite und im Studio angezeigt.

Wenn Sie auf Live gehen klicken, wird sofort ein erster Schwung E-Mails versendet; der Rest folgt in Paketen zu 20, solange das Studio geöffnet bleibt. Jede Anmeldung erhält die E-Mail in der Sprache, in der sie erfolgt ist (FR, EN, ES, DE oder IT, für andere Sprachen standardmäßig Englisch), mit einem direkten Link zum Live. Jede Anmeldung wird nur einmal benachrichtigt.

Zuschauerseite

Die Seite eines Lives (/live/{id}-{slug}) zeigt:

• Den Videoplayer mit „LIVE“-Kennzeichnung und Zuschauerzahl. Browser erlauben Autoplay nur ohne Ton: Auf dem Video erscheint ein Button Ton einschalten.
• Die Karte des angepinnten Produkts über dem Video, mit Warenkorb-Button.
• Die Produktleiste des Lives; jedes Produkt lässt sich mit einem Klick in den nativen PrestaShop-Warenkorb legen. Der Warenkorb-Block des Themes aktualisiert sich ohne Pop-up, damit das Live nicht unterbrochen wird. Lagerbestand, Mindestmengen und Warenkorbregeln werden berücksichtigt; bei Produkten mit Varianten wird die Standardvariante hinzugefügt.
• Den Chat (Kunden und, falls aktiviert, Gäste) mit Anti-Flood, Host-Nachrichten und animierten Herzen.
• Ankündigungen des Hosts als Banner über dem Video.
• Social-Proof-Hinweise „Jemand hat gerade … hinzugefügt“ bei Warenkorb-Aktionen.

Bei einer geplanten Session sieht der Zuschauer einen Countdown (basierend auf der Serverzeit) und kann sich für Erinnerungen anmelden. Beim Start des Lives wechselt die Seite automatisch ohne Neuladen in den Live-Modus.

Replays und Produkt-Zeitleiste

Am Ende des Lives wechselt die Seite automatisch in den Replay-Modus:

• ist eine Replay-URL hinterlegt, wird das aufgezeichnete Video mit Wiedergabesteuerung geladen;
• bei einem Embed-Live bleibt das Embed sichtbar (oder die Replay-URL, falls angegeben);
• ohne Replay-Quelle erscheint der Bildschirm „Live beendet“.

Während des Replays erscheint jedes Produkt genau dann über dem Video, wenn es im Live zum ersten Mal angepinnt wurde. Gezählt wird ab dem Start des Lives: Für eine exakte Synchronisation sollte Ihre Aufzeichnung beginnen, wenn Sie auf Live gehen klicken.

Moduleinstellungen

Die Konfigurationsseite (Module > Modul-Manager > DataFirefly Live Shopping > Konfigurieren) bündelt die globalen Einstellungen. Werte außerhalb des zulässigen Bereichs werden automatisch angepasst.

• Polling-Intervall (standardmäßig 3.000 ms, 1.000 bis 60.000): Aktualisierungsrate von Chat und Ereignissen während eines Lives. Vor dem Live und im Replay wird der Takt automatisch verlangsamt.
• Live-Chat und Gast-Chat: erlauben den Chat und gegebenenfalls die Teilnahme nicht angemeldeter Besucher.
• Reaktionen und Social Proof: aktivieren Herzen und Warenkorb-Hinweise.
• Zuschauer-Timeout (standardmäßig 30 s, 10 bis 600): Zeit, nach der ein inaktiver Zuschauer nicht mehr gezählt wird.
• Max. Nachrichtenlänge (standardmäßig 300, 20 bis 500) und Anti-Flood (standardmäßig 3 s, 0 zum Deaktivieren): regeln den Chat. Für Gäste gilt der Anti-Flood pro IP-Adresse (als Hash gespeichert, nie im Klartext).
• Startseiten-Widget und angezeigte Lives (standardmäßig 4, 1 bis 24): steuern den Block auf der Startseite.

Listenseite und Startseiten-Widget

Die Seite /live listet laufende Lives, kommende (die nächsten zuerst) und Replays (die neuesten zuerst). Das Startseiten-Widget hebt diese Sessions im eingestellten Umfang hervor. Im Multistore zeigt jeder Shop nur die ihm zugeordneten Lives.

Sicherheit

• Chat, Warenkorb und Erinnerungs-Anmeldung sind durch das standardmäßige Anti-CSRF-Token von PrestaShop geschützt.
• Chat-Nachrichten werden vor der Anzeige von jeglichem HTML bereinigt.
• Als Titelbild werden nur echte Bilder akzeptiert, und der Upload-Ordner blockiert die Ausführung von Skripten.
• Bei Embed-Code wird nur die Adresse des iframes verwendet: Weder Attribute noch Skripte gelangen in die Seite.

FAQ und Fehlerbehebung

Das Video startet nicht

Prüfen Sie Videotyp und Quelle. Bei HLS muss die .m3u8-URL öffentlich erreichbar sein und Ihr Encoder senden; der Player versucht es etwa 90 Sekunden lang automatisch erneut. Bei Embed prüfen Sie, ob die YouTube-, Twitch- oder Vimeo-URL gültig ist. Vor dem Start des Lives wird kein Video geladen: Das ist normal.

Das Live ist stumm

Das ist eine Browser-Regel: Autoplay ist nur ohne Ton erlaubt. Der Zuschauer klickt auf dem Video auf Ton einschalten.

Der Preis des Flash-Angebots ändert sich bei den Zuschauern nicht

Das Angebot wird über einen spontan angelegten SpecificPrice angewendet und im nächsten Polling-Zyklus übertragen. Prüfen Sie das Polling-Intervall, ob das Angebot bereits beendet wurde und ob seine Dauer abgelaufen ist. Ein Betragsrabatt, der mindestens dem Produktpreis entspricht, wird abgelehnt.

Der Chat erscheint nicht oder lehnt meine Nachrichten ab

Prüfen Sie, ob der Chat für die Session und global aktiviert ist. Für nicht angemeldete Besucher muss der Gast-Chat aktiv sein. Der Anti-Flood erzwingt eine Mindestzeit zwischen zwei Nachrichten. Erscheint „Laden Sie die Seite neu, um fortzufahren“, hat sich die Sitzung des Besuchers geändert (z. B. Anmeldung in einem anderen Tab): Neu laden genügt.

Angemeldete haben keine Erinnerungs-E-Mail erhalten

Prüfen Sie die E-Mail-Konfiguration des Shops (Erweiterte Einstellungen > E-Mail, mit einer Test-E-Mail) und die Logs (Erweiterte Einstellungen > Logs). Die E-Mails gehen beim Start des Lives und danach paketweise raus, solange das Studio geöffnet ist: Lassen Sie das Studio bis zum vollständigen Versand offen.

Der Countdown wird nicht angezeigt

Der Countdown erscheint nur bei geplanten Sessions mit hinterlegtem Datum. Ohne Datum wird „Das Live beginnt gleich“ angezeigt.

Der Warenkorb-Zähler aktualisiert sich nicht

Das Produkt wird in den Warenkorb gelegt; die Aktualisierung des Warenkorb-Blocks hängt vom Warenkorb-Modul des Themes ab (ps_shoppingcart). Wenn Sie CCC nutzen, leeren Sie nach einem Modul-Update den Cache.

Funktioniert das Modul auf Shared Hosting?

Ja. Die Echtzeit-Synchronisation nutzt AJAX-Polling ohne WebSocket-Server oder SFU und ist damit mit gängigem Shared Hosting kompatibel.

Versionshistorie

1.1.0 — 26. Oktober 2026

• Kompatibilität mit PrestaShop 1.7.0 bis 1.7.8 (PHP 5.6 bis 8.3), zusätzlich zu 8 und 9.
• Erinnerungen „Benachrichtige mich“ per E-Mail beim Start des Lives (5 Sprachen).
• Replays: automatischer Wechsel, Video nicht mehr verdeckt, Produkt-Zeitleiste.
• Button „Ton einschalten“, automatische HLS-Wiederaufnahme, angepinntes Produkt auch für Nachzügler sichtbar.
• Flash-Angebote mit Dauer, Normalpreis nach Ende des Angebots wiederhergestellt.
• Multistore: Shop-Auswahl pro Live.
• Sicherheit: Anti-CSRF-Token, Upload-Prüfung, IP-basierter Anti-Flood für Gäste, gefiltertes Embed.
• Saubere URLs, SEO-Meta, Breadcrumb, Drag & Drop der Produkte, Ankündigungen als Banner.

1.0.0 — 6. Juni 2026

• Erste Version für PrestaShop 8 und 9.