DataFirefly Allergens & Ingredients — Guía completa

Presentación

DataFirefly Allergens & Ingredients pone tu tienda PrestaShop 8 o 9 en conformidad con el Reglamento (UE) 1169/2011 (INCO): visualización de los 14 alérgenos del Anexo II, lista de ingredientes estructurada con énfasis automático de los alérgenos (artículo 21), e información disponible antes de la compra como exige el artículo 14 para la venta a distancia.

El módulo añade además dos diferenciadores: un perfil de alérgenos personal para cada cliente con alertas en tiempo real en las fichas de producto, y un enriquecimiento Schema.org JSON-LD automático para el SEO.

Requisitos y compatibilidad

• PrestaShop 8.0.0 a 9.99.99
• PHP 8.0 mínimo
• MySQL 5.7+ o MariaDB 10.3+
• Compatible multitienda y multilenguaje
• Idiomas incluidos: francés, inglés, español, alemán

Instalación

1. En el back office, abre Módulos → Gestor de módulos.
2. Haz clic en Subir un módulo y selecciona el archivo dfallergens-1.0.0.zip.
3. Haz clic en Instalar. El módulo crea 5 tablas con el prefijo df_ y precarga los 14 alérgenos del Anexo II en los 4 idiomas.
4. Una nueva pestaña DataFirefly Allergens aparece en el menú Módulos para gestionar la taxonomía de alérgenos.

Configuración

Abre Módulos → Gestor de módulos → DataFirefly Allergens & Ingredients → Configurar. Hay seis ajustes disponibles:

• Estilo de énfasis — cómo se marcan los alérgenos en la lista de ingredientes: negrita (recomendado), mayúsculas, subrayado o color. La negrita es el estilo más habitual en las etiquetas físicas.
• Mostrar iconos — activa o desactiva los pictogramas SVG junto al nombre de cada alérgeno.
• Mostrar trazas — muestra u oculta la sección «Puede contener trazas» (artículo 36 apartado 3).
• Marcado JSON-LD — inyecta el marcado Schema.org en la etiqueta head de las fichas de producto correspondientes.
• Perfil de cliente — activa la funcionalidad de perfil de alérgenos en el área de cliente y las alertas en las fichas de producto.
• Posición de visualización — pestaña dedicada en la ficha de producto, después de la descripción, o después del precio.

Declarar los alérgenos de un producto

1. Abre la ficha del producto en el back office y ve a la pestaña Módulos (PrestaShop 8) o a la sección del módulo (PrestaShop 9).
2. En el panel DataFirefly Allergens, cada alérgeno ofrece tres estados: no aplicable (por defecto), Contiene, o Trazas.
3. Selecciona Contiene para los alérgenos presentes en la receta, Trazas para las posibles contaminaciones cruzadas.
4. Introduce la lista de ingredientes en lenguaje natural, en orden decreciente de cantidad como exige la normativa. El módulo detecta y enfatiza automáticamente los alérgenos y sus sinónimos.
5. Opcionalmente, rellena el origen y las instrucciones de conservación.
6. Guarda el producto.

Detección automática por sinónimos

El énfasis no se limita al nombre oficial del alérgeno. El diccionario interno reconoce las variantes comunes en los cuatro idiomas:

• Leche → leche, mantequilla, nata, caseína, lactosuero, lactosa
• Gluten → trigo, espelta, cebada, centeno, avena, kamut, malta
• Sulfitos → SO2, dióxido de azufre, E220 a E228
• Frutos de cáscara → almendra, avellana, nuez, anacardo, pacana, pistacho, macadamia

La detección utiliza límites de palabra compatibles con Unicode: «trigo» se detecta en «harina de trigo» pero no dentro de palabras más largas no relacionadas.

Perfil de alérgenos del cliente

Cuando la opción está activada, cada cliente conectado dispone de una sección Mis alérgenos en su área de cliente. Allí selecciona sus alérgenos y un nivel de gravedad: evitar, intolerancia, grave o anafiláctico.

En cada ficha de producto, el módulo compara los alérgenos declarados del producto con el perfil del cliente. En caso de conflicto, aparece una alerta roja encima del precio, indicando el alérgeno afectado y el nivel de gravedad registrado.

Marcado Schema.org JSON-LD

Cuando un producto tiene al menos un alérgeno declarado o una lista de ingredientes, el módulo inyecta automáticamente un script JSON-LD en la etiqueta head que contiene:

• ingredients — la lista de ingredientes en texto plano
• suitableForDiet — los regímenes compatibles inferidos (por ejemplo GlutenFreeDiet si no se declara ningún alérgeno de gluten)
• additionalProperty — cada alérgeno con el propertyID INCO-1169-2011 y su nivel (contiene o trazas)

El marcado se genera en el servidor en PHP, sin plantilla, con protección contra inyecciones.

Gestionar la taxonomía de alérgenos

El menú DataFirefly Allergens del back office permite modificar los nombres y descripciones de los 14 alérgenos en cada idioma, activarlos o desactivarlos individualmente, y ajustar su orden de visualización. El orden por defecto sigue la numeración del Anexo II.

Resolución de problemas

• El bloque de alérgenos no se muestra — comprueba que el producto tiene al menos un alérgeno declarado o una lista de ingredientes, y que la posición de visualización configurada corresponde a un hook soportado por tu tema.
• Todos los alérgenos aparecen como «Contiene» — asegúrate de usar la versión 1.0.0 final del módulo; limpia los datos del producto de prueba volviendo a poner todos los selectores en «no aplicable» y guardando.
• El énfasis no funciona en un término — puede que el término no esté en el diccionario de sinónimos; usa el nombre oficial del alérgeno en la lista de ingredientes.
• El JSON-LD no aparece — verifica que la opción está activada en la configuración e inspecciona el código fuente de la ficha de producto (busca INCO-1169-2011).

Desinstalación

La desinstalación elimina las 5 tablas del módulo y todos los datos de alérgenos, ingredientes y perfiles de clientes asociados. Exporta tus datos antes si es necesario.

Responsabilidad legal

El módulo proporciona las herramientas técnicas de visualización. Conforme al artículo 8 del reglamento INCO, la responsabilidad de la exactitud de la información alimentaria corresponde al operador de la empresa alimentaria, es decir, al comerciante.