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 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.

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.

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é.

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.