Placement dans la galerie d'images

Affiche les miniatures vidéo aux côtés de vos images produit pour que les clients puissent regarder une vidéo de la même façon qu'ils font défiler les photos du produit.

remarque

Disponible depuis la v3.0.0

Vue d'ensemble

Le placement dans la galerie d'images insère chaque vidéo produit sous forme de miniature directement dans la galerie d'images du produit — à côté des photos habituelles. Un clic (ou un survol) sur une miniature vidéo remplace l'image principale du produit par un lecteur vidéo intégré. Lorsque le client clique sur une miniature d'image classique, le lecteur se ferme et l'image sélectionnée reprend sa place.

C'est le point d'intégration le plus naturel pour la plupart des thèmes. Les clients n'ont pas besoin de faire défiler la page ou de chercher une section séparée — la vidéo est directement dans la bande d'images. Associée à l'option Vidéo en couverture, vous pouvez faire démarrer la vidéo automatiquement dès qu'un visiteur arrive sur la page produit.

Tous les paramètres de cette section sont indépendants des autres emplacements d'affichage (Panneau latéral, Onglets, Listes de produits). Vous pouvez activer n'importe quelle combinaison d'emplacements simultanément.

Configuration

1. Accédez à Modules > Gestionnaire de modules, recherchez Product Video et cliquez sur Configurer.
2. Ouvrez l'onglet Galerie d'images.

Affichage

Paramètre	Valeurs	Défaut	Description
Afficher la vidéo avec les images	Activé / Désactivé	Activé	Interrupteur principal pour cet emplacement. Lorsqu'il est désactivé, aucune miniature vidéo n'apparaît dans la galerie d'images, quels que soient les autres paramètres.
Afficher sur	Tous les appareils / Bureau uniquement / Mobile et tablette uniquement	Tous les appareils	Limite cet emplacement à un type d'appareil spécifique. Utile si votre thème s'affiche différemment sur mobile et que la galerie pose des problèmes sur les petits écrans.

Vidéo en couverture

Paramètre	Valeurs	Défaut	Description
Utiliser la vidéo comme image par défaut (Vidéo en couverture) (PV_DEFAULT)	Activé / Désactivé	Activé	Active automatiquement la première vidéo au chargement de la page produit, remplaçant la photo principale du produit par le lecteur vidéo. Aucun clic n'est nécessaire de la part du client.
Définir la vidéo par défaut une seule fois (PV_DEFAULT_ONCE)	Activé / Désactivé	Désactivé	Lorsqu'il est activé, la vidéo en couverture n'est définie qu'au premier chargement. Changer de déclinaison ou actualiser la page ne relance pas la vidéo en couverture. Utile quand vous souhaitez que la première impression soit la vidéo, sans qu'elle redémarre à chaque fois que le client modifie une taille ou une couleur.

Activer la Vidéo en couverture conjointement avec la Lecture automatique (configurée par fournisseur dans les sections YouTube, Vimeo ou HTML5) crée une page produit de style cinéma : la vidéo démarre automatiquement dès l'ouverture de la page.

Position des miniatures

Paramètre	Valeurs	Défaut	Description
Position des miniatures (PV_THUMB_POS)	Avant / Après / Personnalisé	Avant	Emplacement où les miniatures vidéo sont insérées dans la bande d'images. Avant les place devant toutes les photos du produit ; Après les ajoute à la fin ; Personnalisé permet de spécifier un numéro de position exact.
Position personnalisée des miniatures (PV_THUMB_POS_CUSTOM)	1, 2, 3…	1	Visible uniquement lorsque Personnalisé est sélectionné ci-dessus. 1 = premier emplacement, 2 = deuxième emplacement, et ainsi de suite. Si le produit possède moins d'images que le chiffre saisi, la vidéo est placée en dernier.
Nombre maximum de vidéos à afficher (PV_LIMIT)	0 (toutes), ou un entier positif	0	Limite le nombre de miniatures vidéo dans la galerie. Définir à 0 pour afficher toutes les vidéos. Définir à 1 ou 2 pour éviter que la galerie ne déborde lorsqu'un produit comporte de nombreuses vidéos.
Autoriser la répétition des vidéos (PV_IMG_REPEAT)	Activé / Désactivé	Activé	Lorsqu'une limite de vidéos est active, ce paramètre contrôle si la même URL vidéo peut également apparaître dans d'autres emplacements (Panneau latéral, Onglets). Désactivez-le pour éviter qu'une même vidéo s'affiche à deux endroits sur la même page.

Apparence des miniatures

Paramètre	Valeurs	Défaut	Description
Taille personnalisée des miniatures (PV_CUST_THUMB_TYPE)	Tout type d'image défini dans votre thème (ex. cart, small_default)	cart	Le préréglage de taille d'image que le module utilise pour les cadres des miniatures vidéo. Faites correspondre ce paramètre à celui utilisé par votre thème pour les miniatures de galerie afin d'assurer une taille cohérente.
Utiliser JS pour forcer la taille des miniatures (PV_FORCE_THUMB_SIZE)	Activé / Désactivé	Désactivé	Force toutes les miniatures vidéo à correspondre aux dimensions exactes en pixels des miniatures d'images adjacentes via JavaScript. Activez cette option si les miniatures vidéo apparaissent plus grandes ou plus petites que les miniatures des images produit.
Taille de l'image produit (PV_IMG_SIZE)	Tout type d'image de votre thème, ou vide pour la valeur par défaut du thème	Vide (valeur par défaut du thème)	Le préréglage de taille d'image utilisé pour la zone d'image principale du produit où la vidéo remplace la couverture. Faites-le correspondre à la taille d'image principale de votre thème. Laissez vide sauf en cas de problème de dimensionnement.

Activation des miniatures

Paramètre	Valeurs	Défaut	Description
Comportement des miniatures — Bureau (PV_DESKT_BV)	Survol / Clic	Survol (PS 1.7+), Clic (PS 1.6)	Détermine si la vidéo se charge lorsque le client survole la miniature ou uniquement lorsqu'il clique dessus. Choisissez Survol si votre thème active les images produit au survol ; choisissez Clic si votre thème nécessite un clic.
Comportement des miniatures — Mobile / Tablette (PV_MOBILE_BV)	Survol / Clic	Clic	Identique au paramètre précédent mais pour les écrans tactiles. Sur les appareils tactiles, les événements de survol ne sont pas fiables, le Clic est donc presque toujours le bon choix.

Fonctionnement

Lorsqu'un client ouvre une page produit :

1. Le module insère les miniatures vidéo dans la bande de la galerie aux côtés des photos existantes du produit.
2. Chaque miniature affiche une image fixe extraite de YouTube ou Vimeo (ou une miniature personnalisée pour les vidéos HTML5) avec une icône de lecture superposée.
3. Lorsque le client survole ou clique sur une miniature vidéo — selon le paramètre Comportement des miniatures — l'image principale du produit est remplacée par un lecteur vidéo intégré.
4. Si la Vidéo en couverture est activée, la première vidéo se charge automatiquement sans aucune interaction.
5. Lorsque le client clique sur une autre miniature d'image, le lecteur est supprimé et l'image sélectionnée s'affiche normalement.

L'expérience de navigation dans la galerie est identique à celle du passage d'une photo produit à l'autre — la vidéo n'est qu'une miniature supplémentaire dans la bande.

Changements de déclinaison

Lorsqu'un client change de déclinaison de produit (par exemple en sélectionnant une couleur ou une taille différente), PrestaShop recharge la galerie d'images via AJAX. Le module détecte cette mise à jour et réinsère les miniatures vidéo correspondant à la déclinaison nouvellement sélectionnée. Si des vidéos sont assignées par déclinaison, seules les vidéos de cette déclinaison s'affichent.

Si les miniatures vidéo disparaissent après qu'un client change de déclinaison, augmentez le Délai de rafraîchissement AJAX / changement de déclinaison dans la section Compatibilité avec le thème de la configuration du module.

Vidéo en couverture avec les déclinaisons

Si la Vidéo en couverture est activée et que Définir la vidéo par défaut une seule fois est désactivé, la première vidéo de la déclinaison nouvellement sélectionnée s'active automatiquement après chaque changement de déclinaison. Activez Définir la vidéo par défaut une seule fois pour empêcher ce redéclenchement lorsque vous souhaitez que la vidéo ne soit lue qu'au chargement initial de la page.

Exemples d'utilisation

Exemple : page produit qui met la vidéo en avant

Vous vendez un appareil de cuisine et souhaitez que la vidéo de démonstration soit la première chose que les clients voient. Activez la Vidéo en couverture et configurez la Lecture automatique dans les paramètres YouTube. La vidéo démarre automatiquement en mode silencieux (ou avec le son, selon vos paramètres de lecture automatique) dès le chargement de la page — sans défilement ni clic nécessaire.

Exemple : plusieurs vidéos sans surcharger la galerie

Un produit comporte cinq vidéos (déballage, tutoriel, trois variantes de couleur). Définissez le Nombre maximum de vidéos à afficher à 2 pour que seules les deux vidéos les plus importantes apparaissent dans la galerie. Les trois autres restent accessibles via le Panneau latéral ou les Onglets si ces emplacements sont activés.

Exemple : galerie en clic uniquement pour correspondre à un thème de boutique

Votre thème n'active les images produit qu'au clic (courant dans les thèmes mode et luxe). Définissez le Comportement des miniatures — Bureau sur Clic sur la miniature. Les miniatures vidéo se comportent alors exactement comme les miniatures d'images habituelles, pour une expérience cohérente.

Remarques importantes

• Multi-boutique : tous les paramètres de la Galerie d'images sont par boutique. Configurez chaque boutique séparément via le sélecteur de boutique dans l'en-tête du Back Office avant d'ouvrir la configuration du module.
• La position des miniatures Personnalisé repose sur le balisage de la galerie correspondant à ce qu'attend le module. Si votre thème utilise une structure de galerie non standard, Avant ou Après sont des choix plus fiables.
• La fonction Vidéo en couverture nécessite que la zone d'image principale de votre thème soit identifiable via les sélecteurs CSS définis dans Compatibilité avec le thème. Si la vidéo en couverture ne se charge pas automatiquement, vérifiez ces sélecteurs en premier lieu.
• Les préréglages de taille d'image (ex. cart, small_default) sont définis par PrestaShop et votre thème. Vous pouvez consulter les tailles disponibles dans Design > Paramètres des images dans le Back Office.
• Sur PS 1.6, le Comportement des miniatures — Bureau est par défaut sur Clic car les scripts de galerie de PS 1.6 gèrent les événements souris différemment.

Dépannage

Problème	Solution
La miniature vidéo apparaît beaucoup plus grande ou plus petite que les photos produit	Modifiez Taille personnalisée des miniatures pour le type d'image réellement utilisé par votre thème pour les miniatures de galerie (souvent small_default sur les thèmes PS 1.7+). Activez Utiliser JS pour forcer la taille des miniatures en solution de secours.
La vidéo ne se charge pas automatiquement à l'ouverture de la page	Vérifiez que Utiliser la vidéo comme image par défaut est activé. Ensuite, vérifiez dans Compatibilité avec le thème que le sélecteur CSS pour le conteneur de l'image principale du produit est correct.
La vidéo redémarre à chaque fois que le client change de déclinaison	Activez Définir la vidéo par défaut une seule fois pour empêcher la vidéo en couverture de se redéclencher lors des changements de déclinaison.
La miniature vidéo apparaît dans le mauvais emplacement	Définissez Position des miniatures sur Personnalisé et entrez le numéro d'emplacement exact. Si la position est toujours incorrecte, votre thème ne prend peut-être pas en charge le positionnement personnalisé — passez à Avant ou Après.
Trop de miniatures dans la galerie	Définissez Nombre maximum de vidéos à afficher à 1 ou 2 pour limiter le nombre affiché.
La vidéo disparaît après un changement de déclinaison	Augmentez le Délai de rafraîchissement AJAX / changement de déclinaison dans la section Compatibilité avec le thème pour que le module attende plus longtemps avant de réinsérer les miniatures après le rechargement de la galerie.
La même vidéo apparaît à la fois dans la galerie et le panneau latéral	Désactivez Autoriser la répétition des vidéos pour empêcher la même URL d'apparaître dans plusieurs emplacements simultanément.

Foire aux questions

Si j'active la Vidéo en couverture, la vidéo sera-t-elle lue automatiquement pour tous les visiteurs, y compris sur mobile ?

La Vidéo en couverture charge le lecteur et active la première vidéo, mais la lecture automatique effective (démarrage sans clic) dépend du paramètre Lecture automatique dans les sections YouTube, Vimeo ou HTML5 — et du navigateur du visiteur. La plupart des navigateurs bloquent la lecture automatique avec le son sur mobile ; la lecture automatique en mode silencieux fonctionne généralement.

Puis-je afficher une miniature vidéo différente selon la déclinaison produit sélectionnée ?

Oui. Assignez des vidéos à des déclinaisons spécifiques dans la page de modification du produit. Lorsqu'un client sélectionne cette déclinaison, le module substitue les vidéos qui lui sont assignées. La miniature de galerie de la déclinaison précédente est supprimée et la nouvelle apparaît.

La limite de vidéos définie ici s'applique-t-elle aussi aux vidéos affichées dans le Panneau latéral ou les Onglets ?

Non. La limite du Nombre maximum de vidéos à afficher s'applique uniquement à l'emplacement Galerie d'images. Le Panneau latéral et les Onglets ont leurs propres paramètres d'affichage. L'option Autoriser la répétition des vidéos contrôle si la même URL vidéo peut apparaître dans plusieurs emplacements, et non le nombre de vidéos affiché par emplacement.

Que se passe-t-il si je définis la Position personnalisée des miniatures à 3, mais que le produit n'a qu'une seule image ?

La miniature vidéo est placée à la fin de la galerie (après l'unique image produit), car il n'y a pas assez d'images pour atteindre la position 3.

Cet emplacement fonctionne-t-il sur les pages de liste de produits (pages catégorie) ?

Non. L'emplacement Galerie d'images est réservé à la page de détail du produit. Pour les pages catégorie, utilisez la fonctionnalité Listes de produits distincte.

Mon thème affiche les miniatures sous l'image principale. Les vidéos apparaîtront-elles là ou ailleurs ?

Le module injecte les miniatures dans le conteneur de miniatures utilisé par votre thème. Si les vidéos apparaissent au mauvais endroit, ajustez le sélecteur du conteneur de miniatures dans la section Compatibilité avec le thème afin que le module cible le bon élément.

Fonctionnalités associées

• Panneau latéral — Afficher les vidéos dans une colonne à côté de la description du produit plutôt que dans la galerie d'images
• Onglets et description — Afficher un lecteur vidéo en pleine taille sous les détails du produit dans un onglet dédié
• Listes de produits — Ajouter des icônes vidéo ou des lecteurs intégrés aux pages de catégorie et de résultats de recherche
• Compatibilité avec le thème — Configurer les sélecteurs CSS pour le conteneur d'image, le conteneur de miniatures et le délai de changement de déclinaison