DataFirefly Allergens & Ingredients: volledige gids

Presentatie

DataFirefly Allergens & Ingredients brengt uw PrestaShop 8- of 9-webshop in overeenstemming met verordening (EU) 1169/2011 (INCO): weergave van de 14 allergenen uit bijlage II, een gestructureerde ingrediëntenlijst met automatische markering van de allergenen (artikel 21), en informatie die vóór de aankoop beschikbaar is, zoals artikel 14 voor verkoop op afstand vereist.

De module voegt ook twee onderscheidende functies toe: een persoonlijk allergenenprofiel voor elke klant met een waarschuwing in real time op de productpagina’s, en een automatische Schema.org JSON-LD-verrijking voor uw vindbaarheid.

Vereisten en compatibiliteit

• PrestaShop 8.0.0 tot 9.99.99
• PHP 8.0 minimum
• MySQL 5.7+ of MariaDB 10.3+
• Compatibel met multistore en meertaligheid
• Meegeleverde talen: Frans, Engels, Spaans, Duits

Installatie

1. Open in de backoffice Modules → Modulebeheer.
2. Klik op Een module installeren en selecteer het bestand dfallergens-1.0.0.zip.
3. Klik op Installeren. De module maakt 5 tabellen met het voorvoegsel df_ aan en laadt de 14 allergenen uit bijlage II alvast in de 4 talen.
4. Er verschijnt een nieuw tabblad DataFirefly Allergens in het menu Modules om de allergenentaxonomie te beheren.

Configuratie

Open Modules → Modulebeheer → DataFirefly Allergens & Ingredients → Configureren. Er zijn zes instellingen:

• Markeringsstijl: de manier waarop de allergenen in de ingrediëntenlijst worden aangeduid: vet (aanbevolen), hoofdletters, onderstreept of in kleur. Vet is de gangbaarste stijl op fysieke etiketten.
• Pictogrammen tonen: schakelt de SVG-pictogrammen naast de naam van elk allergeen in of uit.
• Sporen tonen: toont of verbergt de sectie “Kan sporen bevatten” (artikel 36 § 3).
• JSON-LD-opmaak: voegt de Schema.org-opmaak in het head-element van de betrokken productpagina’s in.
• Klantprofiel: activeert de functie voor het allergenenprofiel in het klantenaccount en de waarschuwingen op de productpagina.
• Weergavepositie: een apart tabblad op de productpagina, na de beschrijving, of na de prijs.

De allergenen van een product aangeven

1. Open de productpagina in de backoffice en ga naar het tabblad Modules (PrestaShop 8) of de sectie van de module (PrestaShop 9).
2. In het paneel DataFirefly Allergens heeft elk allergeen drie standen: niet van toepassing (standaard), Bevat of Sporen.
3. Kies Bevat voor allergenen die in het recept zitten en Sporen voor mogelijke kruisbesmetting.
4. Vul de ingrediëntenlijst in gewone taal in, in afnemende volgorde van hoeveelheid zoals de regelgeving vraagt. De module herkent en markeert de allergenen en hun synoniemen automatisch.
5. Vul desgewenst de herkomst en het bewaaradvies in.
6. Sla het product op.

Automatische detectie via synoniemen

De markering blijft niet beperkt tot de officiële naam van het allergeen. Het interne woordenboek herkent de gangbare varianten in de vier talen:

• Melk → melk, boter, room, caseïne, wei, lactose
• Gluten → tarwe, spelt, gerst, rogge, haver, kamut, mout
• Sulfieten → SO2, zwaveldioxide, E220 tot E228
• Noten → amandel, hazelnoot, walnoot, cashew, pecan, pistache, macadamia

De detectie gebruikt woordgrenzen die met Unicode overweg kunnen: “tarwe” wordt herkend in “tarwebloem” maar niet in een woord waarin de letters toevallig voorkomen.

Allergenenprofiel van de klant

Staat de optie aan, dan krijgt elke ingelogde klant een sectie Mijn allergenen in zijn klantenaccount. Daar kiest hij zijn allergenen en een ernstniveau: te vermijden, intolerantie, ernstig of anafylactisch.

Op elke productpagina vergelijkt de module de aangegeven allergenen van het product met het profiel van de klant. Bij een conflict verschijnt boven de prijs een rode waarschuwingsbalk met het betrokken allergeen en het geregistreerde ernstniveau.

Schema.org JSON-LD-opmaak

Heeft een product minstens één aangegeven allergeen of een ingrediëntenlijst, dan voegt de module automatisch een JSON-LD-script in het head-element in met:

• ingredients: de ingrediëntenlijst als volledige tekst
• suitableForDiet: de afgeleide geschikte diëten (bijvoorbeeld GlutenFreeDiet wanneer geen enkel glutenallergeen is aangegeven)
• additionalProperty: elk allergeen met de propertyID INCO-1169-2011 en het niveau (bevat of sporen)

De opmaak wordt aan de serverzijde in PHP gegenereerd, zonder template en met bescherming tegen injectie.

De allergenentaxonomie beheren

Via het menu DataFirefly Allergens in de backoffice kunt u de namen en beschrijvingen van de 14 allergenen in elke taal aanpassen, ze afzonderlijk in- of uitschakelen, en hun volgorde van weergave bijstellen. De standaardvolgorde volgt de nummering van bijlage II.

Probleemoplossing

• Het allergenenblok verschijnt niet: controleer of het product minstens één aangegeven allergeen of een ingrediëntenlijst heeft, en of de ingestelde weergavepositie overeenkomt met een hook die uw thema ondersteunt.
• Alle allergenen verschijnen als “Bevat”: controleer of u de definitieve versie 1.0.0 van de module gebruikt; maak de gegevens van het testproduct schoon door alle keuzes op “niet van toepassing” te zetten en opnieuw op te slaan.
• De markering werkt niet op een bepaalde term: die term staat misschien niet in het synoniemenwoordenboek; gebruik dan de officiële naam van het allergeen in de ingrediëntenlijst.
• De JSON-LD verschijnt niet: controleer of de optie in de configuratie geactiveerd is en bekijk de broncode van de productpagina (zoek naar INCO-1169-2011).

Verwijdering

Bij het verwijderen worden de 5 tabellen van de module gewist, samen met alle gegevens over allergenen, ingrediënten en klantprofielen. Exporteer uw gegevens vooraf als u ze nodig hebt.

Wettelijke verantwoordelijkheid

De module levert de technische middelen voor de weergave. Conform artikel 8 van de INCO-verordening ligt de verantwoordelijkheid voor de juistheid van de informatie over levensmiddelen bij de exploitant van het levensmiddelenbedrijf, dus bij de handelaar.