# dfbulkcategory — Affectation de catégories en masse
> Présentation dfbulkcategory ajoute deux actions groupées dans la liste produit du back-office PrestaShop : Ajouter à une catégorie et Retirer d'une catégorie. Sélectionnez vos produits avec les cases à cocher…
- Page:
- Langue: fr
- Mis à jour le: 2026-07-02
- Autres langues: [en](https://www.datafirefly.com/en/documentation/dfbulkcategory/index.md), [es](https://www.datafirefly.com/es/documentation/dfbulkcategory/index.md), [de](https://www.datafirefly.com/de/documentation/dfbulkcategory/index.md), [it](https://www.datafirefly.com/it/documentation/dfbulkcategory/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfbulkcategory/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfbulkcategory/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfbulkcategory/index.md)
- Index:
## Présentation
dfbulkcategory ajoute deux actions groupées dans la liste produit du back-office PrestaShop : **Ajouter à une catégorie** et **Retirer d'une catégorie**. Sélectionnez vos produits avec les cases à cocher natives, choisissez une ou plusieurs catégories dans une modale avec arbre et recherche, confirmez — l'opération s'exécute en AJAX sans rechargement de page.
Le module est compatible **PrestaShop 8.0.0 à 9.99.99** et fonctionne en multiboutique. Il ne crée aucune table SQL et ne modifie aucun fichier core.
## Installation
1. Téléchargez le fichier ZIP du module depuis votre compte DataFirefly.
2. Dans le back-office PrestaShop, allez dans **Modules → Gestionnaire de modules → Installer un module**.
3. Glissez-déposez le fichier `dfbulkcategory.zip` et validez.
4. Le module est prêt immédiatement : aucune configuration n'est requise.
À l'installation, le module enregistre un onglet admin caché nécessaire aux contrôles d'accès de PrestaShop 9. Aucune entrée visible n'est ajoutée à votre menu back-office.
### Mise à jour depuis la version 1.0.0
Remplacez simplement le module par la nouvelle version via **Installer un module** (ou le bouton Mettre à jour). Un script d'upgrade s'exécute automatiquement et installe l'onglet admin requis par PrestaShop 9 sur les installations existantes. Aucune action manuelle n'est nécessaire.
## Utilisation
### Ajouter des produits à des catégories
1. Ouvrez **Catalogue → Produits**.
2. Cochez les produits à modifier (la case d'en-tête sélectionne toute la page).
3. Ouvrez le menu **Actions groupées** et cliquez sur **Ajouter à une catégorie**.
4. Dans la modale, cochez une ou plusieurs catégories dans l'arbre, puis cliquez sur **Appliquer**.
Les catégories cochées sont ajoutées aux catégories existantes de chaque produit — rien n'est écrasé.
### Retirer des produits de catégories
Même principe avec l'onglet **Retirer d'une catégorie** de la modale. Les catégories cochées sont retirées de chaque produit sélectionné.
La catégorie par défaut d'un produit n'est jamais supprimée : si elle fait partie des catégories à retirer, le module la conserve automatiquement pour que le produit garde toujours une catégorie principale.
### Mode combiné (ajouter et retirer en une opération)
L'onglet **Les deux** affiche deux panneaux côte à côte : à gauche les catégories à ajouter, à droite celles à retirer. C'est le mode idéal pour déplacer des produits d'une catégorie vers une autre en une seule confirmation.
### Recherche et navigation dans l'arbre
Le champ de recherche filtre l'arbre en temps réel et déplie automatiquement les branches contenant des résultats. Les boutons **Déployer tout** et **Réduire tout** permettent de naviguer rapidement dans les grandes arborescences.
### Catégories désactivées
Par défaut, seules les catégories actives sont affichées. Activez l'interrupteur **Afficher les catégories désactivées** en haut de la modale pour les inclure — utile pendant une restructuration de catalogue. Les catégories désactivées sont signalées par un badge.
## Multiboutique
Chaque opération s'exécute dans le contexte de la boutique active en back-office :
- L'arbre de catégories affiché est celui de la boutique en cours.
- Le module vérifie que chaque produit sélectionné appartient bien à cette boutique avant modification.
- Les associations de catégories des autres boutiques ne sont pas affectées.
En contexte « Toutes les boutiques », sélectionnez d'abord une boutique précise dans le sélecteur multiboutique pour cibler correctement les associations.
## Compatibilité PrestaShop 9
Depuis la version 1.1.0, le module est entièrement compatible PrestaShop 9 :
- Les URLs AJAX sont générées côté serveur selon le mécanisme attendu par PrestaShop 9 (jeton inclus).
- Un onglet admin caché est enregistré pour satisfaire les contrôles d'accès renforcés — les employés non super-administrateurs peuvent utiliser le module dès lors qu'ils ont accès au catalogue.
- Le fonctionnement sur PrestaShop 8.0, 8.1 et 8.2 reste inchangé.
## Dépannage
### Les boutons n'apparaissent pas dans le menu Actions groupées
Videz le cache PrestaShop (**Paramètres avancés → Performances → Vider le cache**) et rechargez la page produits avec Ctrl+F5. Vérifiez aussi que le module est bien installé et activé dans le Gestionnaire de modules.
### Erreur « Accès refusé » lors de l'application
Sur PrestaShop 9, cette erreur indique généralement que l'onglet admin du module est manquant (installation antérieure à la 1.1.0). Réinstallez le module ou appliquez la mise à jour : le script d'upgrade recrée l'onglet automatiquement.
### Un produit n'a pas été modifié
Le message de résultat détaille les produits ignorés. Les causes habituelles : le produit n'est pas associé à la boutique active (multiboutique), ou il a été supprimé entre la sélection et la confirmation.
## Changelog
### 1.1.0 — 2 juillet 2026
- Compatibilité PrestaShop 9 (plage supportée : 8.0.0 — 9.99.99)
- URLs AJAX générées côté serveur (conformes PS9)
- Onglet admin caché enregistré à l'installation pour les contrôles d'accès de PrestaShop 9
- Script de mise à jour automatique pour les installations 1.0.0 existantes
- Libellés de catégories systématiquement filtrés par boutique
- Affichage sécurisé des messages d'erreur dans la modale
### 1.0.0 — 11 février 2026
- Première version publique
- Actions groupées Ajouter / Retirer dans la liste produit
- Modale avec arbre de catégories, recherche en temps réel, mode combiné
- Option catégories désactivées, gestion multiboutique, préservation de la catégorie par défaut