# Images des déclinaisons par couleur : installation et configuration > Présentation Le module associe les photos d'un produit à ses déclinaisons selon leur couleur. Pour chaque photo, vous indiquez si elle appartient à une couleur, à toutes, à certaines ou… - Page: - Langue: fr - Mis à jour le: 2026-10-07 - Autres langues: [en](https://www.datafirefly.com/en/documentation/dfcombinationimages/index.md), [it](https://www.datafirefly.com/it/documentation/dfcombinationimages/index.md), [es](https://www.datafirefly.com/es/documentation/dfcombinationimages/index.md), [de](https://www.datafirefly.com/de/documentation/dfcombinationimages/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfcombinationimages/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfcombinationimages/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfcombinationimages/index.md) - Index: ## Présentation Le module associe les photos d'un produit à ses déclinaisons selon leur couleur. Pour chaque photo, vous indiquez si elle appartient à une couleur, à toutes, à certaines ou à aucune. Le module écrit ensuite la liste exacte des images de chaque déclinaison, pour toutes les tailles de la couleur. Dans PrestaShop, une déclinaison sans image affiche toutes les photos du produit. Le module donne donc à chaque déclinaison une liste explicite d'images. ## Installation 1. Dans le back-office, ouvrez **Modules > Gestionnaire de modules** et cliquez sur **Installer un module**. 2. Envoyez le fichier `dfcombinationimages.zip`. 3. Le module ajoute le menu **Catalogue > Images des déclinaisons** et crée ses tables. Pour une mise à jour, envoyez le nouveau ZIP par-dessus l'ancien : les configurations et les sauvegardes sont conservées. ## Réglages Onglet **Réglages**, à configurer une seule fois. ### Groupes d'attributs couleur Cochez les groupes qui indiquent la couleur d'une déclinaison. Les groupes de type couleur sont cochés à l'installation. Les autres attributs (taille, bonnet, longueur) sont ignorés : toutes les déclinaisons d'une même couleur reçoivent les mêmes photos. ### Photo ajoutée plus tard Choisissez si une nouvelle photo, placée après la couverture d'un produit déjà configuré, va sur toutes les déclinaisons ou sur aucune tant que vous ne la configurez pas. Une photo ajoutée avant la couverture n'est jamais associée automatiquement. ### Mise à jour automatique Quand une déclinaison ou une photo est ajoutée à un produit configuré, le module réapplique sa configuration. PrestaShop n'exécute ces hooks que pour les employés autorisés à voir le module (**Équipe > Permissions > Modules**). Sinon, utilisez **Réappliquer** sur le produit ou le traitement en masse. ### Textes ALT et synonymes Le module peut chercher le nom de la couleur dans le texte ALT des photos. Si une couleur est écrite autrement dans vos ALT, ajoutez une ligne par couleur : `Carne = nudo, skin, beige`. La lecture de l'ALT est ignorée quand toutes les photos d'un produit ont le même ALT. ### Produits par lot Nombre de produits traités par requête pendant un traitement en masse. 25 convient dans la plupart des cas ; baissez la valeur si le serveur dépasse son délai d'exécution. ## Configurer un produit Onglet **Produits** : la liste affiche les produits à déclinaisons avec leur nombre de couleurs et de photos avant la couverture. Filtrez par catégorie, cherchez par nom ou référence, puis cliquez sur **Configurer**. Le même écran est accessible depuis la fiche produit, onglet Modules. ### Les quatre options de chaque photo - **Photo d'une seule couleur** : la photo n'apparaît que sur les déclinaisons de la couleur choisie. - **Toutes les couleurs** : la photo apparaît sur toutes les déclinaisons, comme une photo portée ou la couverture. - **Uniquement ces couleurs** : cochez les couleurs concernées. - **Aucune déclinaison** : la photo reste sur la fiche produit mais n'est affichée sur aucune déclinaison. ### La proposition automatique Un produit pas encore configuré affiche une proposition, enregistrée seulement quand vous cliquez sur **Enregistrer et appliquer**. - **D'après les associations actuelles** (par défaut) : une photo déjà liée aux déclinaisons d'une couleur garde cette couleur, une photo liée à aucune déclinaison devient une photo commune. Les photos placées avant la couverture et liées à aucune couleur reçoivent une couleur chacune quand il y en a exactement une par couleur. - **D'après l'ordre des photos et l'ALT** : chaque photo placée avant la couverture reçoit une couleur, d'abord d'après son texte ALT, puis dans l'ordre des photos et des valeurs de couleur. ### Texte ALT et zoom Le texte ALT complet s'affiche sous chaque photo. Si vous choisissez une couleur différente de celle indiquée dans l'ALT, la carte passe en orange. Cliquez sur une photo pour l'agrandir et distinguer des couleurs proches. ### Aperçu par couleur et image principale L'aperçu se met à jour pendant la saisie. Pour chaque couleur, la première photo de la ligne est l'image principale des déclinaisons : PrestaShop 9 prend la première photo associée dans l'ordre des positions. Si une photo placée sur plusieurs couleurs passe devant la photo propre à une couleur, l'aperçu l'indique en orange. ### Placer les photos de couleur en premier Quand la couverture est la première photo et que les photos de couleur viennent après, la case **Placer les photos d'une seule couleur avant les autres photos** les déplace avant la couverture. Les photos déjà placées avant la couverture ne bougent jamais, et le drapeau de couverture du produit ne change pas. L'ordre final s'affiche sous la case avant d'enregistrer. ## Affectation en masse 1. Choisissez une ou plusieurs catégories, ou laissez vide pour tout le catalogue. 2. Choisissez les produits : non configurés, non configurés ou configurés en masse (les produits configurés à la main sont conservés), tous, ou seulement réappliquer les configurations enregistrées. 3. Choisissez la source des photos d'une seule couleur : les images actuelles des déclinaisons (recommandé après un import) ou les photos placées avant la couverture. 4. Choisissez quoi faire si une couleur n'a pas de photo propre : ignorer le produit (recommandé) ou appliquer quand même. 5. Choisissez où vont les photos communes : toutes les déclinaisons ou seulement certaines couleurs. 6. Laissez **Simulation** cochée et cliquez sur **Lancer**. Cochez **Afficher uniquement les produits à vérifier** pour voir les produits ignorés et les ouvrir. 7. Quand le résultat vous convient, décochez Simulation et relancez. Une sauvegarde est créée avant toute modification. ## Sauvegardes et restauration Chaque enregistrement de produit et chaque traitement en masse crée une sauvegarde. L'onglet **Sauvegardes** les liste ; **Restaurer** remet les images des déclinaisons, l'ordre des photos et la configuration des produits concernés. Le module garde les 10 dernières sauvegardes de masse et les 50 dernières sauvegardes produit. ## Dépannage ### Les options ne réagissent pas avant d'enregistrer Le navigateur utilise encore le JavaScript d'une ancienne version. Videz le cache du navigateur ou rechargez la page avec Ctrl+F5. ### Une nouvelle taille n'a pas reçu ses photos L'employé qui l'a créée n'a probablement pas le droit de voir le module. Ouvrez le produit dans le module et cliquez sur **Réappliquer**, ou lancez le traitement en masse en mode réapplication.