DataFirefly Allergens & Ingredients — Guida completa

Panoramica

DataFirefly Allergens & Ingredients rende il tuo negozio PrestaShop 8 o 9 conforme al Regolamento (UE) 1169/2011 (INCO): visualizzazione dei 14 allergeni dell’Allegato II, lista degli ingredienti strutturata con evidenziazione automatica degli allergeni (articolo 21) e informazioni disponibili prima dell’acquisto come richiede l’articolo 14 per la vendita a distanza.

Il modulo aggiunge inoltre due elementi distintivi: un profilo allergeni personale per ogni cliente con avvisi in tempo reale sulle schede prodotto e un arricchimento Schema.org JSON-LD automatico per la SEO.

Requisiti e compatibilità

• PrestaShop 8.0.0 a 9.99.99
• PHP 8.0 minimo
• MySQL 5.7+ o MariaDB 10.3+
• Compatibile multinegozio e multilingua
• Lingue incluse: francese, inglese, spagnolo, tedesco

Installazione

1. Nel back office, apri Moduli → Gestore moduli.
2. Fai clic su Carica un modulo e seleziona il file dfallergens-1.0.0.zip.
3. Fai clic su Installa. Il modulo crea 5 tabelle con prefisso df_ e precarica i 14 allergeni dell’Allegato II nelle 4 lingue.
4. Una nuova scheda DataFirefly Allergens appare nel menu Moduli per gestire la tassonomia degli allergeni.

Configurazione

Apri Moduli → Gestore moduli → DataFirefly Allergens & Ingredients → Configura. Sono disponibili sei impostazioni:

• Stile di evidenziazione — come vengono contrassegnati gli allergeni nella lista degli ingredienti: grassetto (consigliato), maiuscolo, sottolineato o colore. Il grassetto è lo stile più comune sulle etichette fisiche.
• Mostra icone — attiva o disattiva i pittogrammi SVG accanto al nome di ogni allergene.
• Mostra tracce — mostra o nasconde la sezione «Può contenere tracce» (articolo 36 paragrafo 3).
• Markup JSON-LD — inietta il markup Schema.org nel tag head delle schede prodotto interessate.
• Profilo cliente — attiva la funzionalità di profilo allergeni nell’area cliente e gli avvisi sulle schede prodotto.
• Posizione di visualizzazione — scheda dedicata sulla pagina prodotto, dopo la descrizione o dopo il prezzo.

Dichiarare gli allergeni di un prodotto

1. Apri la scheda del prodotto nel back office e vai alla scheda Moduli (PrestaShop 8) o alla sezione del modulo (PrestaShop 9).
2. Nel pannello DataFirefly Allergens, ogni allergene offre tre stati: non applicabile (predefinito), Contiene o Tracce.
3. Seleziona Contiene per gli allergeni presenti nella ricetta, Tracce per le possibili contaminazioni incrociate.
4. Inserisci la lista degli ingredienti in linguaggio naturale, in ordine decrescente di quantità come richiede la normativa. Il modulo rileva ed evidenzia automaticamente gli allergeni e i loro sinonimi.
5. Facoltativamente, compila l’origine e le istruzioni di conservazione.
6. Salva il prodotto.

Rilevamento automatico tramite sinonimi

L’evidenziazione non si limita al nome ufficiale dell’allergene. Il dizionario interno riconosce le varianti comuni nelle quattro lingue:

• Latte → latte, burro, panna, caseina, siero di latte, lattosio
• Glutine → grano, farro, orzo, segale, avena, kamut, malto
• Solfiti → SO2, anidride solforosa, da E220 a E228
• Frutta a guscio → mandorla, nocciola, noce, anacardo, noce pecan, pistacchio, macadamia

Il rilevamento utilizza limiti di parola compatibili con Unicode: «grano» viene rilevato in «farina di grano» ma non all’interno di parole più lunghe non correlate.

Profilo allergeni cliente

Quando l’opzione è attivata, ogni cliente connesso dispone di una sezione I miei allergeni nella sua area cliente. Lì seleziona i suoi allergeni e un livello di gravità: da evitare, intolleranza, grave o anafilattico.

Su ogni scheda prodotto, il modulo confronta gli allergeni dichiarati del prodotto con il profilo del cliente. In caso di conflitto, un banner di avviso rosso appare sopra il prezzo, indicando l’allergene interessato e il livello di gravità registrato.

Markup Schema.org JSON-LD

Quando un prodotto ha almeno un allergene dichiarato o una lista di ingredienti, il modulo inietta automaticamente uno script JSON-LD nel tag head contenente:

• ingredients — la lista degli ingredienti in testo semplice
• suitableForDiet — le diete compatibili dedotte (per esempio GlutenFreeDiet se non è dichiarato alcun allergene glutine)
• additionalProperty — ogni allergene con il propertyID INCO-1169-2011 e il suo livello (contiene o tracce)

Il markup viene generato lato server in PHP, senza template, con protezione contro le iniezioni.

Gestire la tassonomia degli allergeni

Il menu DataFirefly Allergens del back office permette di modificare i nomi e le descrizioni dei 14 allergeni in ogni lingua, attivarli o disattivarli individualmente e regolare il loro ordine di visualizzazione. L’ordine predefinito segue la numerazione dell’Allegato II.

Risoluzione dei problemi

• Il blocco allergeni non viene visualizzato — verifica che il prodotto abbia almeno un allergene dichiarato o una lista di ingredienti e che la posizione di visualizzazione configurata corrisponda a un hook supportato dal tuo tema.
• Tutti gli allergeni appaiono come «Contiene» — assicurati di utilizzare la versione 1.0.0 finale del modulo; pulisci i dati del prodotto di prova riportando tutti i selettori su «non applicabile» e salvando.
• L’evidenziazione non funziona su un termine — il termine potrebbe mancare nel dizionario dei sinonimi; usa il nome ufficiale dell’allergene nella lista degli ingredienti.
• Il JSON-LD non appare — verifica che l’opzione sia attivata nella configurazione ed esamina il codice sorgente della scheda prodotto (cerca INCO-1169-2011).

Disinstallazione

La disinstallazione rimuove le 5 tabelle del modulo e tutti i dati di allergeni, ingredienti e profili clienti associati. Esporta i tuoi dati prima, se necessario.

Responsabilità legale

Il modulo fornisce gli strumenti tecnici di visualizzazione. Conformemente all’articolo 8 del regolamento INCO, la responsabilità dell’esattezza delle informazioni alimentari spetta all’operatore del settore alimentare, cioè al commerciante.