DataFirefly Product Video

Présentation

DataFirefly Product Video ajoute des vidéos directement dans la galerie de miniatures de la fiche produit PrestaShop, aux côtés des images. Trois sources sont prises en charge : fichiers hébergés (MP4, WebM, OGG), YouTube et Vimeo. Chaque vidéo dispose de son propre poster, de ses options de lecture et d’une position personnalisable.

• Compatibilité : PrestaShop 8.0 à 8.9
• Multiboutique : oui
• Multilingue : titre et description traduisibles par langue
• Version : 1.0.0

Installation

1. Dans le back-office, allez dans Modules > Module Manager.
2. Cliquez sur Charger un module et sélectionnez le fichier dfproductvideo.zip.
3. Le module crée automatiquement ses tables et les dossiers d’upload (img/dfproductvideo/videos et img/dfproductvideo/posters).
4. Cliquez sur Configurer pour définir les réglages par défaut.

Configuration globale

La page de configuration définit les valeurs appliquées par défaut à chaque nouvelle vidéo :

• Autoplay – lecture automatique (le mode muet est requis par Chrome et Safari).
• Muet – obligatoire si l’autoplay est activé.
• Boucle – relit la vidéo en continu.
• Afficher les contrôles – barre de lecture native.
• Chargement paresseux (lazy load) – charge la vidéo seulement quand elle devient visible.
• Lightbox / Plein écran – ouverture de la vidéo en superposition.
• Responsive – adaptation à la largeur de l’écran.
• Analytics – comptage du nombre de lectures par vidéo.
• Taille max fichier (Mo) – limite d’upload, 50 Mo par défaut.
• Extensions autorisées – par défaut mp4,webm,ogg.
• Couleur et fond de l’icône Play – personnalisation du bouton de lecture.

Ajouter une vidéo à un produit

1. Ouvrez une fiche produit dans le back-office.
2. Rendez-vous dans l’onglet Vidéos ajouté par le module.
3. Choisissez la source : fichier à téléverser, lien YouTube ou lien Vimeo.
4. Renseignez si besoin un poster (image de couverture) et un titre / description par langue.
5. Ajustez les options de lecture (autoplay, muet, boucle, contrôles) si elles diffèrent des valeurs par défaut.
6. Enregistrez. La vidéo apparaît dans la galerie du produit.

Les vidéos peuvent être réordonnées par glisser-déposer, activées ou désactivées, et l’une d’elles peut être désignée comme vidéo de couverture (une seule par produit et par boutique).

Posters automatiques

Si aucun poster n’est fourni, le module génère automatiquement une image d’aperçu : la miniature YouTube (hqdefault) pour les vidéos YouTube, et la vignette Vimeo pour les vidéos Vimeo. Pour les fichiers téléversés, fournir un poster manuellement est recommandé.

Affichage en front-office

Les vidéos s’insèrent dans la galerie de miniatures de la fiche produit, juste après les images. Au clic, la vidéo se lit en place ou s’ouvre en lightbox selon la configuration. Les vidéos uploadées utilisent le lecteur HTML5 natif ; YouTube et Vimeo sont intégrés via leur lecteur officiel avec les paramètres correspondant aux options choisies (autoplay, muet, boucle, contrôles).

Analytics

Lorsque l’option Analytics est active, chaque lecture incrémente un compteur (play_count) stocké en base. Cela permet de mesurer l’engagement vidéo par produit.

Désinstallation

La désinstallation supprime les tables du module ainsi que ses réglages. Les fichiers vidéo et posters associés aux produits sont également nettoyés.

Détails techniques

• Tables : dfproductvideo (vidéos et options) et dfproductvideo_lang (titre / description traduits).
• Hooks utilisés : displayAdminProductsExtra, displayAfterProductThumbs, actionFrontControllerSetMedia, actionProductUpdate, actionProductDelete, displayBackOfficeHeader.
• Gestion des vidéos via contrôleur AJAX (enregistrement, suppression, réordonnancement, activation).
• Suivi des lectures via contrôleur front dédié.