DataFirefly Live Shopping — Guide complet

Présentation

Le module DataFirefly Live Shopping (dflive) transforme votre boutique PrestaShop en plateforme de vente vidéo en direct. Vous diffusez un live, vous épinglez des produits en temps réel, vous lancez des offres flash, vos clients ajoutent au panier sans quitter la diffusion, et la session reste accessible en replay. Tout fonctionne sur votre boutique : aucune plateforme de live shopping tierce, aucun abonnement récurrent.

Compatibilité

• PrestaShop 8.0 à 9.x
• PHP 7.4 à 8.3
• Mono-boutique et multi-boutique
• Multilingue (5 langues incluses : FR, EN, ES, DE, IT)
• Aucune dépendance (ni Composer ni framework) ; hls.js est embarqué dans le module
• Compatible hébergement mutualisé (synchronisation par polling AJAX, sans WebSocket ni SFU)

Prérequis

Le module gère la lecture de la vidéo et toute la couche shopping, mais c’est vous qui fournissez la source vidéo. Selon le mode choisi :

• HLS : un flux .m3u8 servi par votre propre serveur HLS, par Mux ou par Cloudflare Stream, alimenté par un encodeur comme OBS.
• MP4 : une URL pointant vers un fichier .mp4 accessible publiquement.
• Embed : un live YouTube, Twitch ou Vimeo (URL ou code d’intégration).

Installation

1. Dans le back-office, ouvrez Modules > Gestionnaire de modules.
2. Cliquez sur Installer un module puis sélectionnez le fichier dflive.zip.
3. Une fois installé, ouvrez le menu Vendre > Live Shopping.

Créer un live

Depuis Vendre > Live Shopping, cliquez sur Ajouter. Le formulaire est organisé en onglets :

Général

• Titre et description du live (multilingues).
• Animateur : nom affiché comme hôte dans le chat et sous la vidéo.
• Date programmée : déclenche le compte à rebours côté spectateur.
• Statut : programmé, en direct ou terminé.
• Image de couverture : affichée avant le live et dans les listes.

Vidéo

• Type de vidéo : HLS, MP4 ou embed.
• Source vidéo : l’URL .m3u8, l’URL .mp4 ou l’URL / code embed selon le type.
• URL de replay (optionnelle) : par exemple l’enregistrement VOD de votre serveur HLS, servi après le live.

Produits

Associez les produits qui seront présentés pendant le live grâce au sélecteur à recherche AJAX. Ces produits alimentent le rail côté spectateur et deviennent épinglables depuis le Studio.

Options & SEO

Activez ou non le chat, le chat invité, les réactions et la preuve sociale pour cette session, et renseignez le titre et la description SEO de la page du live.

Diffuser le flux

Pour un live en HLS, le principe est le suivant :

1. Configurez votre encodeur (OBS, par exemple) pour diffuser vers votre serveur HLS, Mux ou Cloudflare Stream.
2. Récupérez l’URL .m3u8 de sortie et collez-la dans le champ Source vidéo de la session.
3. Lancez la diffusion depuis votre encodeur, puis ouvrez le Studio et cliquez sur Lancer le live.

Le Studio (régie)

Le Studio est la salle de contrôle intégrée au back-office. Ouvrez-le depuis le bouton Studio de la liste des lives.

• Lancer / Terminer le live : bascule le statut de la session. À la fin, les offres flash en cours sont automatiquement nettoyées.
• Épingler un produit : sa carte apparaît immédiatement en surimpression chez les spectateurs. Épingler un produit désépingle automatiquement le précédent.
• Offre flash : saisissez une réduction (par exemple 20% ou 10€). Le module crée un SpecificPrice à la volée et le prix recalculé s’affiche instantanément côté spectateurs. Le bouton dédié permet de stopper l’offre.
• Annonce : diffuse un message hôte épinglé dans le chat.
• Modération : masquer, afficher ou épingler n’importe quel message du chat.
• Statistiques live : nombre de spectateurs et de réactions en temps réel.

Côté spectateur

La page d’un live (/live/{id}-{slug}) présente :

• Le lecteur vidéo avec un bandeau « EN DIRECT » et le nombre de spectateurs.
• La carte du produit épinglé en surimpression, avec bouton d’ajout au panier.
• Le rail de produits du live, chacun ajoutable au panier PrestaShop natif d’un clic.
• Le chat (clients et, si activé, invités) avec anti-flood, messages hôte et réactions cœurs animées.
• Les toasts de preuve sociale « Quelqu’un vient d’ajouter… » lors des ajouts au panier.

Pour une session programmée, le spectateur voit un compte à rebours et peut s’inscrire par e-mail pour être prévenu du démarrage. Après le live, la session bascule en replay et reste accessible.

Réglages du module

La page de configuration regroupe les réglages globaux, notamment :

• Intervalle de polling (3 000 ms par défaut) : fréquence de rafraîchissement du chat et des évènements.
• Chat activé et chat invité : autorise le chat et, le cas échéant, la participation des visiteurs non connectés.
• Réactions et preuve sociale : active les cœurs et les toasts d’ajout au panier.
• Délai de présence : durée au-delà de laquelle un spectateur inactif n’est plus compté.
• Longueur maximale d’un message et anti-flood : encadrent le chat.
• Widget d’accueil et nombre de lives affichés : pilotent l’encart de la page d’accueil.

Page liste et widget d’accueil

La page /live liste les lives en cours, à venir et les replays. Le widget de page d’accueil met en avant les sessions actives et programmées, dans la limite configurée.

FAQ et dépannage

La vidéo ne se lance pas

Vérifiez le type de vidéo et la source. Pour un flux HLS, assurez-vous que l’URL .m3u8 est accessible publiquement et que votre encodeur diffuse bien. Pour un embed, vérifiez que l’URL YouTube, Twitch ou Vimeo est valide.

Le prix de l’offre flash ne change pas chez les spectateurs

L’offre est appliquée via un SpecificPrice créé à la volée et propagée au cycle de polling suivant. Vérifiez l’intervalle de polling et que l’offre n’a pas déjà été stoppée. Les offres en cours sont nettoyées automatiquement à la fin du live.

Le chat n’apparaît pas ou refuse mes messages

Contrôlez que le chat est activé pour la session et globalement. Le chat invité doit être activé pour autoriser les visiteurs non connectés. L’anti-flood impose un délai minimal entre deux messages.

Le compte à rebours ne s’affiche pas

Le compte à rebours n’apparaît que pour les sessions au statut programmé dont la date est dans le futur. Vérifiez le statut et la date programmée.

Le module fonctionne-t-il sur hébergement mutualisé ?

Oui. La synchronisation temps réel utilise du polling AJAX, sans serveur WebSocket ni SFU, ce qui garantit la compatibilité avec les hébergements mutualisés courants.