# DataFirefly Allergens & Ingredients — Guide complet > Présentation DataFirefly Allergens & Ingredients met votre boutique PrestaShop 8 ou 9 en conformité avec le règlement (UE) 1169/2011 (INCO) : affichage des 14 allergènes de l'Annexe II, liste d'ingrédients… - Page: - Langue: fr - Mis à jour le: 2026-07-02 - Autres langues: [en](https://www.datafirefly.com/en/documentation/dfallergens/index.md), [es](https://www.datafirefly.com/es/documentation/dfallergens/index.md), [de](https://www.datafirefly.com/de/documentation/dfallergens/index.md), [it](https://www.datafirefly.com/it/documentation/dfallergens/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfallergens/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfallergens/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfallergens/index.md) - Index: ## Présentation DataFirefly Allergens & Ingredients met votre boutique PrestaShop 8 ou 9 en conformité avec le règlement (UE) 1169/2011 (INCO) : affichage des 14 allergènes de l'Annexe II, liste d'ingrédients structurée avec mise en évidence automatique des allergènes (article 21), et information disponible avant l'achat comme l'exige l'article 14 pour la vente à distance. Le module ajoute également deux différenciateurs : un profil allergènes personnel pour chaque client avec alerte en temps réel sur les fiches produits, et un enrichissement Schema.org JSON-LD automatique pour le référencement. ## Prérequis et compatibilité - PrestaShop 8.0.0 à 9.99.99 - PHP 8.0 minimum - MySQL 5.7+ ou MariaDB 10.3+ - Compatible multi-boutique et multi-langue - Langues fournies : français, anglais, espagnol, allemand ## Installation 1. Dans le back-office, ouvrez **Modules → Gestionnaire de modules**. 2. Cliquez sur **Installer un module** et sélectionnez le fichier `dfallergens-1.0.0.zip`. 3. Cliquez sur **Installer**. Le module crée 5 tables préfixées `df_` et précharge les 14 allergènes de l'Annexe II dans les 4 langues. 4. Un nouvel onglet **DataFirefly Allergens** apparaît dans le menu Modules pour gérer la taxonomie des allergènes. À l'installation, les 14 allergènes officiels sont préchargés avec leurs icônes SVG et leurs noms en français, anglais, espagnol et allemand. Vous n'avez rien à saisir manuellement. ## Configuration Ouvrez **Modules → Gestionnaire de modules → DataFirefly Allergens & Ingredients → Configurer**. Six réglages sont disponibles : - **Style de mise en évidence** — la façon dont les allergènes sont marqués dans la liste d'ingrédients : gras (recommandé), majuscules, souligné ou couleur. Le gras est le style le plus courant sur les étiquettes physiques. - **Afficher les icônes** — active ou désactive les pictogrammes SVG à côté du nom de chaque allergène. - **Afficher les traces** — affiche ou masque la section « Peut contenir des traces » (article 36 §3). - **Balisage JSON-LD** — injecte le balisage Schema.org dans la balise head des fiches produits concernées. - **Profil client** — active la fonctionnalité de profil allergènes dans l'espace client et les alertes sur fiche produit. - **Position de l'affichage** — onglet dédié sur la fiche produit, après la description, ou après le prix. ## Déclarer les allergènes d'un produit 1. Ouvrez la fiche du produit dans le back-office et rendez-vous dans l'onglet **Modules** (PrestaShop 8) ou la section du module (PrestaShop 9). 2. Dans le panneau **DataFirefly Allergens**, chaque allergène propose trois états : _non applicable_ (par défaut), _Contient_, ou _Traces_. 3. Sélectionnez **Contient** pour les allergènes présents dans la recette, **Traces** pour les contaminations croisées possibles. 4. Renseignez la **liste d'ingrédients** en langage naturel, dans l'ordre décroissant de quantité comme l'exige la réglementation. Le module détecte et met en évidence automatiquement les allergènes et leurs synonymes. 5. Facultativement, renseignez l'**origine** et les **conseils de conservation**. 6. Enregistrez le produit. Les champs ingrédients, origine et conservation sont enregistrés par langue et par boutique : passez d'une langue à l'autre avec le sélecteur de langue de la fiche produit pour saisir chaque version. ## Détection automatique par synonymes La mise en évidence ne se limite pas au nom officiel de l'allergène. Le dictionnaire interne reconnaît les variantes courantes dans les quatre langues : - **Lait** → lait, beurre, crème, caséine, lactosérum, lactose - **Gluten** → blé, épeautre, orge, seigle, avoine, kamut, malt - **Sulfites** → SO2, anhydride sulfureux, E220 à E228 - **Fruits à coque** → amande, noisette, noix, cajou, pécan, pistache, macadamia La détection utilise des limites de mots compatibles Unicode : « blé » est détecté dans « farine de blé » mais pas dans « établi ». ## Profil allergènes client Lorsque l'option est activée, chaque client connecté dispose d'une section **Mes allergènes** dans son espace client. Il y sélectionne ses allergènes et un niveau de gravité : à éviter, intolérance, sévère ou anaphylactique. Sur chaque fiche produit, le module compare les allergènes déclarés du produit au profil du client. En cas de conflit, un bandeau d'alerte rouge s'affiche au-dessus du prix, indiquant l'allergène concerné et le niveau de gravité enregistré. Le profil client est un service d'aide à la décision. Il ne remplace ni l'étiquetage réglementaire ni la vigilance du consommateur : affichez toujours la liste complète des allergènes sur chaque fiche. ## Balisage Schema.org JSON-LD Quand un produit possède au moins un allergène déclaré ou une liste d'ingrédients, le module injecte automatiquement un script JSON-LD dans la balise head contenant : - `ingredients` — la liste d'ingrédients en texte plein - `suitableForDiet` — les régimes compatibles inférés (par exemple GlutenFreeDiet si aucun allergène gluten n'est déclaré) - `additionalProperty` — chaque allergène avec le propertyID INCO-1169-2011 et son niveau (contient ou traces) Le balisage est généré côté serveur en PHP, sans template, avec protection contre les injections. ## Gérer la taxonomie des allergènes Le menu **DataFirefly Allergens** du back-office permet de modifier les noms et descriptions des 14 allergènes dans chaque langue, de les activer ou désactiver individuellement, et d'ajuster leur ordre d'affichage. L'ordre par défaut suit la numérotation de l'Annexe II. ## Dépannage - **Le bloc allergènes ne s'affiche pas** — vérifiez que le produit a au moins un allergène déclaré ou une liste d'ingrédients, et que la position d'affichage configurée correspond à un hook supporté par votre thème. - **Tous les allergènes apparaissent en « Contient »** — assurez-vous d'utiliser la version 1.0.0 finale du module ; nettoyez les données du produit de test en repassant tous les sélecteurs sur « non applicable » puis en enregistrant. - **La mise en évidence ne fonctionne pas sur un terme** — le terme est peut-être absent du dictionnaire de synonymes ; utilisez le nom officiel de l'allergène dans la liste d'ingrédients. - **Le JSON-LD n'apparaît pas** — vérifiez que l'option est activée dans la configuration et inspectez le code source de la fiche produit (recherchez INCO-1169-2011). ## Désinstallation La désinstallation supprime les 5 tables du module et toutes les données allergènes, ingrédients et profils clients associés. Exportez vos données avant si nécessaire. ## Responsabilité légale Le module fournit les outils techniques d'affichage. Conformément à l'article 8 du règlement INCO, la responsabilité de l'exactitude des informations sur les denrées alimentaires incombe à l'exploitant du secteur alimentaire, c'est-à-dire au commerçant.