# Tags en caractéristiques pour PrestaShop 8 et 9 : documentation
> Présentation Tags en caractéristiques transforme les tags produits en valeurs de caractéristique. Les tags se saisissent vite, souvent par milliers depuis un fichier fournisseur, mais PrestaShop ne peut pas les…
- Page:
- Langue: fr
- Mis à jour le: 2026-11-02
- Autres langues: [en](https://www.datafirefly.com/en/documentation/dftagfeature/index.md), [es](https://www.datafirefly.com/es/documentation/dftagfeature/index.md), [de](https://www.datafirefly.com/de/documentation/dftagfeature/index.md), [it](https://www.datafirefly.com/it/documentation/dftagfeature/index.md), [pl](https://www.datafirefly.com/pl/documentation/dftagfeature/index.md), [nl](https://www.datafirefly.com/nl/documentation/dftagfeature/index.md), [pt](https://www.datafirefly.com/pt/documentation/dftagfeature/index.md)
- Index:
## Présentation
Tags en caractéristiques transforme les tags produits en valeurs de caractéristique. Les tags se saisissent vite, souvent par milliers depuis un fichier fournisseur, mais PrestaShop ne peut pas les utiliser dans les filtres à facettes, les règles de prix catalogue ni la plupart des modules de vente croisée : ceux-ci reposent sur les caractéristiques. Le module convertit les tags que vous avez déjà, conserve les produits qui les portent et crée une seule valeur par terme, traduite dans chaque langue.
Rien n’est écrit avant que vous appliquiez : l’assistant affiche d’abord l’impact. Chaque modification est enregistrée dans un journal et peut être annulée à l’identique.
## Installation
1. Dans **Modules > Gestionnaire de modules**, cliquez sur **Installer un module** et sélectionnez le fichier ZIP du module.
2. L’installation crée l’onglet **Catalogue > Tags en caractéristiques**, les tables des correspondances et du journal, les réglages par défaut et un jeton secret pour l’URL du cron.
3. Ouvrez **Catalogue > Tags en caractéristiques**. Le module fonctionne de PrestaShop 1.7.8 à 9.x, avec PHP 7.1 à 8.5.
### Mise à jour depuis la version 1.0.0
Envoyez le ZIP 2.0.0 par-dessus le module installé, puis cliquez sur **Mettre à jour** dans le gestionnaire de modules si PrestaShop le demande. La mise à jour ajoute les tables du journal et les nouveaux réglages. Les correspondances enregistrées, les réglages et le jeton cron de la 1.0.0 sont conservés tels quels : une tâche cron existante continue de fonctionner.
## Tableau de bord
L’onglet **Tableau de bord** résume le catalogue : nombre de tags, tags déjà convertis, valeurs de caractéristique gérées par le module, valeurs en attente de synchronisation et opérations des 30 derniers jours. Le bloc **Bilan de santé** signale ce qui demande votre attention : caractéristiques converties absentes des modèles de la recherche à facettes, produits en attente d’indexation, correspondances désynchronisées, dernier appel du cron. Les tags les plus utilisés qui ne sont pas encore convertis sont listés avec un bouton pour les convertir.
Tableau de bord
## Convertir des tags
L’onglet **Convertir** ouvre l’assistant de conversion, en quatre étapes.
### Étape 1 : sélectionner les tags
La liste des tags est paginée côté serveur : elle reste rapide avec des dizaines de milliers de tags. Recherchez par nom, filtrez par langue et par statut (converti ou non), triez par nom ou par nombre de produits. Cochez les tags à convertir, ou utilisez le bouton qui sélectionne tous les résultats de la recherche en cours.
Sélectionnez le tag dans chaque langue : dans une boutique multilingue, un même terme est un tag différent dans chaque langue, et le module regroupe ces traductions en une seule valeur multilingue.
Sélection des tags
### Étape 2 : caractéristique cible et options
- **Nouvelle caractéristique** : saisissez son nom dans chaque langue. Une langue laissée vide reprend le nom de la langue par défaut.
- **Caractéristique existante** : les valeurs dont le nom existe déjà dans la caractéristique sont réutilisées au lieu d’être dupliquées.
- Mode **Ajouter** : les produits gardent leurs valeurs actuelles de la caractéristique et reçoivent aussi la nouvelle. Mode **Remplacer** : les autres valeurs de cette caractéristique sont retirées des produits concernés, seulement une fois les nouvelles valeurs posées.
- **Garder la correspondance et synchroniser** : le tag garde sa valeur de caractéristique, les produits tagués plus tard la reçoivent (voir Correspondances ci-dessous).
- **Supprimer les tags ensuite** : les tags convertis disparaissent des produits et de la boutique. Le journal conserve tout ce qu’il faut pour les restaurer.
- **L’afficher dans la recherche à facettes** : ajoute la caractéristique aux modèles de filtres du module Recherche à facettes une fois la conversion terminée.
Caractéristique cible
### Étape 3 : aperçu de l’impact
Cliquez sur **Prévisualiser l’impact**. Le module calcule, sur le catalogue actuel et sans rien écrire, les produits qui vont changer, les nouvelles affectations, les valeurs créées et réutilisées, les produits portant plusieurs des tags choisis et, en mode remplacement, les valeurs qui seront retirées, avec leurs noms.
Chaque ligne est une future valeur de caractéristique. Avec **Regrouper les traductions automatiquement**, les tags de langues différentes posés sur exactement les mêmes produits forment une seule ligne. Le mode **Presque les mêmes produits (80 % ou plus)** regroupe aussi les tags dont les produits se recoupent à au moins 80 %, pour un taggage incomplet ; ces lignes sont signalées. Vous pouvez aussi **Fusionner avec une autre ligne** ou **Séparer cette ligne** : les chiffres sont recalculés côté serveur.
Aperçu de l'impact
Ouvrez **Traductions de la valeur** pour modifier le nom de la valeur dans chaque langue. Les langues recopiées depuis une autre, faute de tag dans cette langue, sont mises en évidence pour que vous les traduisiez. Rechercher-remplacer et **Majuscule initiale** agissent sur toutes les lignes à la fois. Décochez une ligne pour l’exclure.
Traductions de la valeur
Le nombre de produits d’une ligne ouvre un panneau latéral qui liste chaque produit avec ses valeurs actuelles de la caractéristique et la valeur qu’il va recevoir.
Produits concernés
### Étape 4 : appliquer
Cliquez sur **Appliquer la conversion**. Le travail s’exécute par lots courts avec une barre de progression, phase par phase : aucune requête n’atteint la limite de temps de l’hébergement, quelle que soit la taille de la sélection. Gardez la page ouverte jusqu’à la fin. En cas d’interruption, les changements déjà faits sont dans le journal et peuvent être annulés.
Le résultat affiche les valeurs créées, les affectations ajoutées et retirées, ainsi que les boutons **Annuler cette conversion** et **Ajouter à la recherche à facettes** lorsque la caractéristique n’est encore dans aucun modèle de filtres.
Résultat de la conversion
## Correspondances et synchronisation
Quand **Garder la correspondance et synchroniser** est activé, chaque tag converti reste lié à sa valeur de caractéristique. L’onglet **Correspondances** liste les **Correspondances enregistrées** groupées par caractéristique, avec le nombre de produits à synchroniser pour chaque valeur.
- Un produit créé, modifié ou importé avec un tag associé reçoit la valeur à son enregistrement, si **Synchroniser un produit à son enregistrement** est activé dans les réglages.
- **Synchroniser** sur une valeur, ou **Tout synchroniser**, montre d’abord ce qui sera ajouté (+) et retiré (−), puis l’applique par lots.
- Les valeurs des produits qui ont perdu leur tag sont conservées, sauf si **Retirer aussi la valeur quand le tag est retiré** est activé.
- Supprimer les correspondances d’une valeur ne modifie aucun produit : cela arrête seulement la synchronisation.
Correspondances
## Nettoyage des tags
L’onglet **Nettoyage des tags** range les tags eux-mêmes, avant ou après une conversion.
- **Doublons probables** : tags d’une même langue qui ne diffèrent que par les accents, la casse, les tirets ou les espaces. **Fusionner des tags** déplace les produits vers le tag conservé.
- **Tags inutilisés** : tags posés sur aucun produit, supprimés en un clic.
- La liste complète permet de renommer, fusionner ou supprimer n’importe quel tag. Renommer vers un nom qui existe déjà dans la langue propose de fusionner les deux tags. Seuls des tags de la même langue peuvent être fusionnés.
Chaque modification est enregistrée dans le journal : les tags supprimés, fusionnés ou renommés sont restaurés avec leurs produits et leurs identifiants en cas d’annulation.
Nettoyage des tags
## Journal et annulation
L’onglet **Journal** liste toutes les écritures du module : conversions, synchronisations (manuelles, à l’enregistrement et par cron), fusions, renommages et suppressions de tags, ajouts à la recherche à facettes et annulations. Filtrez par type et par période.
Journal des opérations
Cliquez sur une opération pour voir son détail : chaque changement de produit, les valeurs et caractéristiques créées, les tags concernés. **Exporter en CSV** télécharge la liste complète.
**Annuler l’opération** restaure exactement l’état précédent : les affectations ajoutées sont retirées, les affectations retirées sont remises, les valeurs et caractéristiques créées sont supprimées si plus rien ne les utilise, les tags supprimés reviennent avec leurs produits et leurs identifiants, les correspondances et les modèles de filtres sont restaurés. Si une opération ultérieure a modifié les mêmes produits ou tags, le module vous demande de l’annuler d’abord, en commençant par la plus récente.
Détail d'une opération
## Réglages et cron
Ces réglages s’appliquent à toutes les boutiques.
- **Synchroniser un produit à son enregistrement** (activé par défaut) : désactivé, les tags ajoutés plus tard ne sont convertis qu’à la synchronisation suivante.
- **Retirer aussi la valeur quand le tag est retiré** (désactivé par défaut).
- **Mettre à jour l’index de recherche après chaque opération** (activé par défaut) : les produits modifiés sont réindexés aussitôt, par lots, pour que les nouvelles valeurs soient trouvées par la recherche.
- Options par défaut d’une nouvelle conversion : **Regrouper les traductions automatiquement** et **Majuscule initiale**.
- **Conserver les opérations pendant** : 180 jours par défaut, 0 les garde indéfiniment. Les opérations plus anciennes sont supprimées et ne peuvent plus être annulées.
Le bloc **Tâche planifiée (cron)** affiche l’**URL du cron**, son dernier appel et un exemple de ligne crontab. Le cron est facultatif : il lance une synchronisation complète des correspondances, l’indexation des produits modifiés et le nettoyage du journal. L’URL contient un jeton secret ; générez-en un nouveau si elle a été partagée.
```
0 3 * * * curl -fsS "https://votre-boutique.fr/…URL du cron copiée depuis l’onglet Réglages…" >/dev/null
```
Réglages
## Boutique et recherche à facettes
Les valeurs converties apparaissent dans la fiche technique de la page produit, dans la langue du visiteur.
Fiche technique produit
Une nouvelle caractéristique n’apparaît dans les filtres qu’une fois ajoutée à un modèle de filtres du module Recherche à facettes (ps_facetedsearch 3.x ou 4.x). Le module signale les caractéristiques converties absentes des modèles. **Ajouter aux filtres** ajoute la caractéristique en filtre à cases à cocher, après les filtres existants, dans les modèles que vous choisissez. Le modèle précédent est conservé dans le journal : l’annulation le restaure à l’identique.
Filtres à facettes
## Droits et multiboutique
- Droit **Voir** sur l’onglet : tableau de bord, aperçu, correspondances et journal, en lecture seule.
- **Modifier** : convertir, synchroniser, renommer des tags, annuler, réglages.
- **Supprimer** : supprimer et fusionner des tags.
Chaque action vérifie côté serveur les droits du profil de l’employé. Dans PrestaShop, les tags et les caractéristiques sont communs à toutes les boutiques : une conversion s’applique à tout le catalogue, les nouvelles caractéristiques sont associées à toutes les boutiques et l’index de recherche est mis à jour pour chaque boutique.
## Dépannage
- **La liste des tags est vide** : vos produits n’ont pas encore de tags. Les tags s’ajoutent sur la page produit (onglet Options ou SEO selon la version) ou par import CSV.
- **Un tag manque dans la liste** : il est peut-être déjà converti. Choisissez « Tous » dans le filtre de statut.
- **La nouvelle caractéristique n’apparaît pas dans les filtres** : ajoutez-la à un modèle de filtres avec **Ajouter aux filtres** et vérifiez que le module Recherche à facettes est activé.
- **Les valeurs ne sont pas trouvées par la recherche de la boutique** : activez **Mettre à jour l’index de recherche après chaque opération**, ou cliquez sur **Mettre à jour l’index** dans le tableau de bord.
- **Les produits tagués plus tard ne reçoivent pas la valeur** : vérifiez que la conversion a gardé la correspondance et que **Synchroniser un produit à son enregistrement** est activé, ou lancez **Tout synchroniser**.
- **L’annulation est refusée** : une opération ultérieure a modifié les mêmes produits. Annulez d’abord les opérations ultérieures, en commençant par la plus récente.
- **L’URL du cron renvoie une erreur 403** : le jeton est faux ou a été régénéré. Copiez de nouveau l’URL depuis l’onglet Réglages.