Options d'image

Contrôlez le format d'image, le nombre d'images et leur ordre d'apparition de vos produits dans le flux de catalogue Facebook et Instagram.

remarque

Disponible depuis la v1.0.0

Vue d'ensemble

Chaque entrée produit dans le flux nécessite au moins une URL d'image. Facebook accepte également jusqu'à 10 URL d'images supplémentaires par produit via le champ additional_image_link, qu'il utilise pour afficher plusieurs angles dans les publicités dynamiques et le catalogue de la boutique.

L'onglet Images Options dans la configuration du module vous permet de choisir le format d'image PrestaShop à utiliser, de vérifier ou non l'existence des fichiers image sur le disque avant de les inclure, d'encoder les URL, et de définir le nombre d'images à inclure par produit. Ces réglages influencent à la fois la qualité de vos publicités et la durée de génération du flux.

Configuration

Accédez à Modules > Gestionnaire de modules, recherchez Facebook & Instagram Product Catalogue Feed Pro, puis cliquez sur Configurer. Cliquez ensuite sur l'onglet Images Options.

Champ	Valeurs	Défaut	Description
Select image size to show with products	Tout type d'image PS enregistré pour les produits	fpf_image (si disponible)	Le format de miniature PrestaShop utilisé pour construire les URL d'images dans le flux.
Disable check image exists	Activé / Désactivé	Désactivé	Lorsque désactivé, le module vérifie l'existence physique du fichier sur le disque avant d'inclure l'image. Activez cette option pour ignorer cette vérification.
Disable image URL encoding	Activé / Désactivé	Désactivé	Lorsque désactivé, le module applique la translittération iconv pour supprimer les caractères non-ASCII des URL d'images. Activez cette option pour conserver les caractères spéciaux tels quels.
Disable Additional Images	Activé / Désactivé	Désactivé	Lorsque désactivé, toutes les images supplémentaires du produit sont incluses en tant qu'entrées additional_image_link. Activez cette option pour n'exporter que l'image de couverture.
Ignore cover?	Activé / Désactivé	Désactivé	Lorsque activé, le module ignore l'image de couverture désignée du produit et utilise à la place la première image selon l'ordre de position comme image principale.
Images limit	Entier	0 (sans limite)	Nombre maximum d'images (couverture + supplémentaires) à inclure par produit. Définissez 0 pour inclure toutes les images disponibles.
Image Position Start	Entier	0 (désactivé)	Index de position à partir duquel sélectionner les images. Définissez 0 pour commencer par la couverture. Toute valeur supérieure à 0 active automatiquement Ignore cover.

Recommandation pour le format d'image : Facebook fonctionne mieux avec des images carrées ou quasi-carrées. Choisissez un type d'image dont le ratio est proche de 1:1. Si aucun de vos types existants ne correspond, le module installe un type fpf_image dédié — mais vous devez régénérer les miniatures dans PrestaShop (Design > Préférences des images) après l'avoir sélectionné.

Fonctionnement de chaque réglage

Sélecteur de type d'image

PrestaShop stocke les images produit en plusieurs formats pré-générés (miniatures). Le sélecteur liste tous les types d'images enregistrés pour le contexte "produits". Le module utilise le nom du type sélectionné lorsqu'il appelle getImageLink() de PrestaShop pour construire l'URL de chaque produit.

Si vous sélectionnez fpf_image, vous devez régénérer les miniatures dans votre Back Office au moins une fois — sinon ces fichiers n'existeront pas sur le disque et des erreurs d'image apparaîtront dans le flux.

WebP et AVIF : PrestaShop peut stocker les images en WebP ou AVIF selon vos paramètres de qualité d'image (Design > Préférences des images > Format d'image). L'importateur de catalogue Facebook ne prend pas en charge de manière fiable les URL WebP ou AVIF pour tous les formats publicitaires. Si vous utilisez un format d'image moderne dans votre boutique, activez Disable check image exists pour que le module n'ignore pas silencieusement les images qu'il ne trouve pas en .jpg, et vérifiez dans Facebook Commerce Manager que les images sont bien récupérées.

Disable check image exists

Par défaut, avant d'ajouter une URL d'image au flux, le module vérifie si le fichier .jpg (ou .png) correspondant existe sur le système de fichiers du serveur. Cela évite que des URL d'images invalides ne parviennent à Facebook.

Activez ce réglage dans deux situations :

• Votre boutique utilise un format d'image non standard (WebP, AVIF, JPEG 2000, dérivés HEIC) où la vérification d'existence du module recherche un .jpg qui n'existe pas.
• Votre catalogue est très volumineux et la génération du flux est lente — ignorer la vérification du système de fichiers accélère sensiblement la génération.

Disable image URL encoding

Par défaut, le module applique la translittération UTF-8 iconv aux URL d'images avant de les écrire dans le flux. Cela convertit les caractères accentués ou spéciaux (courants dans les slugs de produits en français, espagnol, allemand et d'autres langues) en leurs équivalents ASCII, produisant des URL plus propres compatibles avec tous les parseurs XML.

Activez Disable image URL encoding si vos URL d'images utilisent déjà un encodage en pourcentage correct, ou si la translittération corrompt les URL dans votre locale spécifique.

Disable Additional Images

Lorsque désactivé (par défaut), le module collecte toutes les images attachées à un produit au-delà de la couverture et les écrit sous forme de champs additional_image_link dans le flux. Facebook accepte jusqu'à 10 valeurs additional_image_link par produit — le module applique automatiquement cette limite quel que soit le nombre d'images du produit.

Activez ce réglage pour omettre entièrement les images supplémentaires et n'inclure que la couverture. Cela peut réduire significativement le temps de génération du flux pour les grands catalogues comportant de nombreuses images par produit.

Ignore cover

Lorsque désactivé (par défaut), le module utilise l'image marquée comme couverture du produit dans PrestaShop comme image_link principal dans le flux.

Activez Ignore cover pour utiliser la première image selon l'ordre de position à la place, en ignorant le marqueur de couverture. Cela est utile si vos images de couverture ne sont pas les visuels les plus performants pour les publicités, mais que votre ordre positionnel l'est.

Images limit

Définissez un nombre pour limiter le nombre d'images par produit écrites dans le flux. La couverture compte comme première image ; les images supplémentaires occupent les emplacements à partir de la position 2. La limite s'applique avant la propre limite de 10 images de Facebook.

Laissez à 0 pour exporter toutes les images disponibles (Facebook plafonne tout de même à 10 images supplémentaires).

Image Position Start

Saisissez un numéro de position (base 1) pour démarrer la sélection d'images à partir de cette position dans la liste d'images du produit, plutôt que depuis la première image. Par exemple, saisir 2 fait utiliser au module la deuxième image (par position) comme image_link principal et ignorer la première.

Lorsque ce réglage est supérieur à 0, Ignore cover est automatiquement activé — car le module n'utilise plus l'image de couverture, et l'option de couverture serait redondante.

Surveillez l'onglet Erreurs : Si vous définissez Image Position Start à une valeur supérieure au nombre total d'images de certains produits, ces produits apparaîtront dans l'onglet Erreurs sous "Produits avec moins de N images". Le libellé de l'onglet reflète dynamiquement la valeur de départ configurée.

Exemples d'utilisation

Exemple : Grand catalogue avec images WebP Votre boutique est configurée pour générer des images WebP. La vérification du système de fichiers du module recherche des fichiers .jpg et signale des centaines de produits comme ayant des images manquantes. Activez Disable check image exists pour que les URL soient incluses quel que soit le format, et vérifiez dans Facebook Commerce Manager que les images se chargent correctement.

Exemple : Catalogue mode — ignorer la couverture lifestyle, utiliser la photo produit propre Vos produits ont une photo lifestyle comme couverture, mais la deuxième image est une photo produit sur fond blanc. Définissez Image Position Start à 2. Le module utilisera la position 2 comme image_link sur tous les produits et activera automatiquement Ignore cover.

Exemple : Accélérer la génération pour 50 000 produits Votre flux prend 40 minutes à générer. Activez Disable Additional Images pour ignorer la boucle de collecte d'images par produit, et activez Disable check image exists pour ignorer les recherches sur le système de fichiers. Ces deux modifications réduisent généralement le temps de génération de 20 à 40 % pour les grands catalogues.

Remarques importantes

• La limite additional_image_link de Facebook est de 10 images. Le module applique cette limite stricte dans FeedImage::getAdditionalImages() quel que soit votre réglage Images limit.
• Si vous utilisez des combinaisons (déclinaisons de produits), les images assignées à une combinaison spécifique sont utilisées pour les entrées de cette déclinaison. Si aucune image propre à la combinaison n'existe, les images partagées du produit sont utilisées à la place.
• Les URL d'images utilisent toujours le domaine SSL de votre boutique lorsque SSL est activé (PS_SSL_ENABLED). Si votre domaine d'images diffère de celui de votre boutique (par exemple, un CDN), le module corrige la partie hôte de l'URL pour correspondre au domaine de la boutique courante.
• Ces réglages sont propres à chaque boutique dans les configurations multi-boutiques. Ajustez-les séparément pour chaque contexte de boutique.

Résolution de problèmes

Problème	Solution
De nombreuses erreurs d'image dans l'onglet Erreurs alors que les produits ont des images	Activez Disable check image exists — vos images sont peut-être stockées en format WebP ou AVIF, que la vérification du système de fichiers ne trouve pas.
Les URL d'images contiennent des caractères corrompus ou ne se chargent pas	Désactivez Disable image URL encoding (c'est-à-dire, gardez l'encodage activé) pour que le module supprime les caractères non-ASCII des URL.
La génération du flux est très lente pour un grand catalogue	Activez Disable Additional Images et/ou Disable check image exists pour ignorer les opérations par image les plus chronophages.
Facebook affiche la mauvaise image comme couverture du produit	Activez Ignore cover si votre désignation de couverture dans PrestaShop ne correspond pas à l'image que vous souhaitez que Facebook utilise, ou utilisez Image Position Start pour sélectionner une position spécifique.
Les produits disparaissent du flux après avoir défini Image Position Start	Ces produits ont moins d'images que la position de départ ne le requiert. Réduisez la valeur ou ajoutez davantage d'images aux produits concernés.
Le type fpf_image est sélectionné mais les images sont invalides dans le flux	Vous devez régénérer les miniatures dans PrestaShop (Design > Préférences des images > Régénérer les miniatures) après avoir sélectionné fpf_image.

Foire aux questions

Quel format d'image dois-je choisir pour les publicités Facebook ?

Facebook recommande des images avec un ratio de 1:1 (carré). Examinez les types d'images listés dans le sélecteur et choisissez celui dont les dimensions sont proches du carré, généralement 800×800 px ou plus. Évitez les formats bannière très larges car Facebook peut les recadrer ou les refuser.

Facebook accepte-t-il les images WebP dans le flux de catalogue ?

L'importateur de catalogue Facebook peut récupérer des images WebP depuis une URL, mais la prise en charge varie selon le format publicitaire et le placement. En cas de doute, conservez le paramètre de qualité d'image PrestaShop sur JPEG et utilisez un type d'image .jpg pour que le flux pointe toujours vers des fichiers JPEG.

Pourquoi l'activation d'Image Position Start active-t-elle automatiquement Ignore cover ?

Lorsque vous demandez au module de démarrer à partir d'une position d'image spécifique, la désignation de couverture devient sans objet — le module sélectionne par ordre, et non par le marqueur de couverture. Le module active Ignore cover automatiquement pour éviter un conflit entre les deux réglages.

Puis-je inclure plus de 10 images supplémentaires par produit ?

Non. La spécification du flux Facebook autorise un maximum de 10 valeurs additional_image_link par produit. Le module applique cette limite et cesse d'ajouter des images dès que 10 ont été collectées, quel que soit le nombre d'images du produit dans PrestaShop.

La désactivation de la vérification d'existence des images entraînera-t-elle des URL invalides dans Facebook ?

Seulement si les fichiers image n'existent réellement pas. La vérification est un filtre de sécurité — la désactiver signifie que le module considère que toutes les URL d'images qu'il construit sont valides. Si vos images existent mais dans un format non standard (WebP, AVIF), désactiver la vérification est la bonne solution. Si les images sont réellement manquantes, elles produiront des erreurs dans Facebook Commerce Manager.

Comment Image Position Start interagit-il avec les images de combinaisons ?

Pour les combinaisons, le module recherche d'abord les images assignées à la combinaison spécifique. Si elles sont trouvées, FPF_IMG_START est appliqué à la liste d'images de cette combinaison via array_slice. Si aucune image propre à la combinaison n'existe, la liste d'images partagées du produit est utilisée avec le même décalage de départ.

Fonctionnalités associées

• Combinations
• Cycle Generation