# Caractéristiques et déclinaisons en masse : documentation dfbulkfeature
> Installation Installez le module depuis Modules > Gestionnaire de modules > Installer un module en envoyant le fichier ZIP. Le même ZIP fonctionne sur PrestaShop 8.0 à 9.x. À l'installation,…
- Page:
- Langue: fr
- Mis à jour le: 2026-10-28
- Autres langues: [en](https://www.datafirefly.com/en/documentation/dfbulkfeature/index.md), [es](https://www.datafirefly.com/es/documentation/dfbulkfeature/index.md), [de](https://www.datafirefly.com/de/documentation/dfbulkfeature/index.md), [it](https://www.datafirefly.com/it/documentation/dfbulkfeature/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfbulkfeature/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfbulkfeature/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfbulkfeature/index.md)
- Index:
## Installation
Installez le module depuis **Modules > Gestionnaire de modules > Installer un module** en envoyant le fichier ZIP. Le même ZIP fonctionne sur PrestaShop 8.0 à 9.x.
À l'installation, le module crée sa table d'historique, enregistre le hook `actionAdminControllerSetMedia` et ajoute l'onglet **Caractéristiques en masse** sous **Catalogue > Attributs et caractéristiques**, à côté des onglets Attributs et Caractéristiques.
### Mise à jour depuis une version précédente
Envoyez le nouveau ZIP de la même façon. PrestaShop détecte la version installée et exécute les scripts de mise à jour : création de la table d'historique, de l'onglet catalogue et des droits. Vos réglages sont conservés.
Si votre hébergeur utilise un cache PHP (OPcache), les scripts de mise à jour le vident automatiquement. En cas de comportement inattendu juste après une mise à jour, videz aussi le cache de PrestaShop depuis Paramètres avancés > Performances.
## Droits des employés
Le module s'appuie sur les droits PrestaShop de chaque profil :
- Les opérations depuis la liste produits demandent le droit de **modification sur Produits**.
- La partie caractéristiques de la page catalogue demande les droits sur **Caractéristiques** (voir, modifier, ajouter, supprimer selon l'action).
- La partie attributs demande les droits sur **Attributs**. Supprimer ou fusionner des valeurs d'attributs demande en plus la modification sur Produits, puisque des déclinaisons sont touchées.
PrestaShop 8 n'exécute pas les hooks d'un module pour un profil qui n'a pas le droit de voir ce module. À l'installation, ce droit est donné automatiquement aux profils qui peuvent modifier les produits. Si vous créez un profil plus tard, accordez-lui le droit « Voir » sur le module dans **Paramètres avancés > Équipe > Permissions**.
## Caractéristiques sur une sélection de produits
Dans **Catalogue > Produits**, cochez les produits concernés, ouvrez **Actions groupées** puis **Gérer les caractéristiques**. La modale affiche à gauche la liste des caractéristiques avec un champ de recherche, et à droite les réglages de l'opération. Le chiffre affiché à côté d'une caractéristique ou d'une valeur indique combien de produits de la sélection l'utilisent déjà.
Actions groupées : gérer caractéristiques et déclinaisons
### Ajouter
Choisissez la caractéristique puis le type de valeur :
- **Valeur existante** : une valeur prédéfinie de la caractéristique.
- **Nouvelle valeur** : le texte saisi devient une valeur prédéfinie, enregistrée dans toutes les langues. Si une valeur portant ce nom existe déjà (sans tenir compte des majuscules), elle est réutilisée.
- **Valeur personnalisée** : un texte propre à chaque produit, comme dans la fiche produit.
La case **Remplacer les valeurs actuelles de cette caractéristique** est cochée par défaut. Décochée, la valeur est ajoutée à côté des valeurs existantes : PrestaShop 8 et 9 acceptent plusieurs valeurs d'une même caractéristique sur un produit.
Ajouter une caractéristique avec une nouvelle valeur
### Modifier
Choisissez la valeur actuelle (ou « N'importe quelle valeur ») et la nouvelle valeur. Seuls les produits de la sélection qui ont déjà cette caractéristique sont modifiés, les autres sont comptés comme non concernés.
Remplacer une valeur de caractéristique
### Retirer
Retirez une valeur précise, toutes les valeurs d'une caractéristique, ou choisissez **Toutes les caractéristiques** en haut de la liste pour vider entièrement les produits sélectionnés. Les valeurs personnalisées qui ne servent plus à aucun produit sont supprimées de la base.
## Déclinaisons sur une sélection de produits
Ouvrez **Actions groupées > Gérer les déclinaisons**, ou basculez sur **Attributs (déclinaisons)** en haut de la modale. La liste de gauche affiche alors les groupes d'attributs.
### Ajouter des déclinaisons
Choisissez un groupe, cochez une ou plusieurs valeurs, et saisissez si besoin de nouvelles valeurs séparées par des points-virgules : elles sont créées dans le groupe, dans toutes les langues. Le module applique ensuite les règles du générateur PrestaShop, produit par produit :
- Un produit **sans déclinaison** reçoit une déclinaison par valeur.
- Un produit déclinant **déjà un autre groupe** est multiplié. Exemple : un t-shirt existe en Rouge et Bleu, vous ajoutez Taille S et M. Les déclinaisons Rouge et Bleu deviennent Rouge-S et Bleu-S en gardant leur stock et leur référence, puis Rouge-M et Bleu-M sont créées.
- Un produit déclinant **déjà ce groupe** reçoit uniquement les valeurs manquantes, combinées avec ses autres attributs.
Les champs de l'opération s'appliquent aux déclinaisons créées :
- **Impact sur le prix (HT)** et **Impact sur le poids** : virgule ou point acceptés.
- **Quantité** : stock de départ de chaque nouvelle déclinaison.
- **Référence** : laissez vide pour ne pas en définir, ou utilisez un modèle. `{ref}` est remplacé par la référence du produit, `{attr}` par les valeurs de la déclinaison. `{ref}-{attr}` donne par exemple `TSHIRT01-rouge-m`.
Les packs et les produits virtuels ne peuvent pas avoir de déclinaisons dans PrestaShop 8.1 et 9. Ils sont ignorés et comptés à part dans l'aperçu et le résultat.
Créer des déclinaisons en masse
### Modifier une valeur d'attribut
Choisissez la valeur actuelle puis la nouvelle valeur, existante ou à créer. Chaque déclinaison portant la valeur actuelle bascule sur la nouvelle et garde son stock, ses prix et ses images. Si le produit possède déjà la déclinaison qui en résulterait, la déclinaison est laissée telle quelle et comptée comme ignorée.
### Retirer
- **Une valeur** : les déclinaisons qui ont cette valeur sont supprimées.
- **Toutes les valeurs (retirer le groupe)** : le groupe est retiré des déclinaisons. Les déclinaisons devenues identiques sont fusionnées : la plus ancienne est conservée et reçoit le stock des autres. Une déclinaison qui n'a plus aucun attribut est supprimée.
- **Toutes les déclinaisons**, en haut de la liste : supprime toutes les déclinaisons des produits sélectionnés, qui redeviennent des produits simples.
Après chaque opération, le module désigne une déclinaison par défaut si besoin, met à jour le type de produit et recalcule le stock global du produit à partir de ses déclinaisons, comme le fait PrestaShop.
Aperçu des déclinaisons créées
## Liste d'opérations, aperçu et application
Le bouton **Ajouter à la liste** place l'opération en attente sous la modale. Vous pouvez en composer plusieurs, caractéristiques et déclinaisons mélangées, puis les appliquer en une fois. Elles s'exécutent dans l'ordre de la liste. Si la liste est vide, **Appliquer** exécute directement l'opération en cours de saisie.
Le bouton **Aperçu** calcule tout sans rien enregistrer. Pour chaque opération, il indique le nombre de produits modifiés, déjà à jour ou non concernés et, pour les déclinaisons, le nombre de déclinaisons créées, supprimées ou ignorées parce qu'elles existent déjà.
L'aperçu des caractéristiques s'appuie sur une transaction annulée en fin de calcul. Il demande des tables en InnoDB, ce qui est le cas par défaut. Sur une base en MyISAM, le bouton Aperçu est désactivé pour les caractéristiques.
Après application, le résultat reprend les mêmes chiffres, propose **Annuler l'opération** et **Recharger la liste**. Les produits qui n'appartiennent pas à la boutique courante sont ignorés et listés.
Aperçu des opérations en masse
## Annuler une opération
Chaque application réussie est enregistrée dans l'historique, avec l'état des produits concernés juste avant. L'annulation est disponible depuis le résultat de la modale ou depuis l'onglet **Historique** de la page Caractéristiques en masse.
- Pour les caractéristiques, les valeurs des produits sont remises à l'identique, valeurs personnalisées comprises.
- Pour les déclinaisons, les déclinaisons sont restaurées avec leurs identifiants d'origine, leur stock, leurs prix spécifiques et leurs images. Les déclinaisons créées par l'opération sont supprimées, y compris des paniers en cours.
L'annulation remet les produits dans l'état d'avant l'opération. Les modifications faites ensuite sur ces mêmes produits sont perdues. Pour un lot de déclinaisons très volumineux (au-delà d'environ 8 Mo de données à conserver), l'annulation n'est pas proposée et le résultat l'indique.
Opérations appliquées et annulation
## Page Caractéristiques en masse
Ouvrez **Catalogue > Attributs et caractéristiques**, onglet **Caractéristiques en masse**. Le sélecteur en haut de page bascule entre **Caractéristiques** et **Attributs (déclinaisons)**.
Catalogue des attributs
### Caractéristiques et valeurs
Chaque caractéristique ou groupe d'attributs est listé avec son nombre de valeurs et de produits. Dépliez une ligne pour voir les valeurs, leur nombre de produits et, pour les attributs, de déclinaisons. Les valeurs utilisées par aucun produit apparaissent en orange.
- **Renommer** : choisissez la langue, modifiez les noms directement dans les champs, puis cliquez sur **Enregistrer les modifications**. Seule la langue choisie est modifiée. Pour un groupe d'attributs, le nom public suit le nom s'il était identique.
- **Fusionner** : cochez au moins deux valeurs d'une même caractéristique ou d'un même groupe, cliquez sur **Fusionner les valeurs sélectionnées** et choisissez la valeur à conserver. Les produits des autres valeurs reçoivent la valeur conservée, puis les autres valeurs sont supprimées. Pour les attributs, une déclinaison qui deviendrait identique à une autre est supprimée et son stock ajouté à l'autre.
- **Supprimer la sélection** : supprime les caractéristiques, groupes ou valeurs cochés. Côté attributs, les déclinaisons utilisant une valeur supprimée sont supprimées, et un groupe supprimé est retiré des déclinaisons avec fusion des déclinaisons identiques.
- **Supprimer les valeurs inutilisées** : nettoie en une fois les valeurs qu'aucun produit ou aucune déclinaison n'utilise.
Les suppressions et les fusions faites depuis cette page ne sont pas annulables. Faites une sauvegarde de la base avant un grand nettoyage.
Catalogue des caractéristiques et renommage
Fusion de valeurs en doublon
### Création en masse
Collez une ligne par caractéristique ou par groupe d'attributs, suivie de deux-points et des valeurs séparées par le séparateur choisi (point-virgule par défaut) :
```
Matière : Coton; Lin; Laine
Taille : S; M; L; XL
```
Une caractéristique ou un groupe portant déjà ce nom dans la langue choisie reçoit uniquement les valeurs manquantes. Les nouveaux noms sont enregistrés dans toutes les langues, à traduire ensuite depuis l'onglet précédent. Les nouveaux groupes d'attributs sont créés en liste déroulante. Utilisez le séparateur barre verticale si vos valeurs contiennent des points-virgules.
Création en masse de caractéristiques
### Historique
L'historique liste les opérations par date, avec l'employé, le détail des opérations, le nombre de produits concernés et le bouton d'annulation quand il est disponible. Les opérations faites depuis la page catalogue y figurent avec la mention Irréversible.
Historique des opérations
### Paramètres
- **Déclencher actionProductUpdate pour chaque produit modifié** : à activer si un module de flux, de marketplace ou d'ERP doit être prévenu des changements. Désactivé par défaut, car plus lent sur les grandes sélections.
- **Opérations conservées dans l'historique** : 100 par défaut, entre 10 et 1000. Les plus anciennes sont supprimées au-delà.
Réglages du module
## Ce que le module met à jour
- Les produits modifiés sont marqués à réindexer pour la recherche PrestaShop.
- Le cache des blocs du module de navigation à facettes (ps_facetedsearch) est vidé.
- Les déclinaisons sont créées et supprimées via les classes natives PrestaShop, ce qui déclenche les hooks habituels des déclinaisons.
- Les autres modules peuvent écouter le hook `actionDfBulkFeatureProductsUpdated`, qui reçoit la liste des produits modifiés.
Fiche technique sur la page produit
## Dépannage
### Les entrées n'apparaissent pas dans le menu Actions groupées
Le menu Actions groupées ne s'active qu'une fois au moins un produit coché. Vérifiez ensuite que le profil de l'employé a le droit de modifier les produits et le droit « Voir » sur le module, puis videz le cache de PrestaShop.
### « Le serveur a renvoyé une réponse inattendue »
La session a expiré ou le profil n'a pas les droits nécessaires. Rechargez la page de la liste produits et recommencez.
### Des déclinaisons sont comptées comme ignorées
La déclinaison qui résulterait de l'opération existe déjà sur le produit. Le module ne crée jamais deux déclinaisons portant exactement les mêmes attributs.
### Les filtres de la boutique affichent encore une ancienne valeur
Relancez l'indexation des attributs et des caractéristiques depuis la page de configuration du module de navigation à facettes, puis videz le cache de PrestaShop.
## Compatibilité
- PrestaShop 8.0 à 9.x, le même ZIP couvre les deux branches. Testé sur 8.2.1 et 9.2.0.
- PHP 7.2 et plus.
- Multiboutique et multilingue.
- Interface disponible en français, anglais, espagnol, allemand, italien, néerlandais, polonais et portugais.