Food products module

La venta de alimentos en línea requiere facilitar información sobre la composición, los valores nutricionales, los alérgenos y el origen del producto (Reglamento UE n.º 1169/2011). Polski for WooCommerce ofrece un módulo completo para gestionar estos datos.

Requisitos legales

El Reglamento de información alimentaria (FIC) obliga a los vendedores de alimentos a facilitar la siguiente información:

Información	Obligatoria	Base legal
Denominación del alimento	Sí	Art. 9, apdo. 1, letra a
Lista de ingredientes	Sí	Art. 9, apdo. 1, letra b
Alérgenos	Sí	Art. 9, apdo. 1, letra c
Cantidad de ingredientes	Condicional	Art. 9, apdo. 1, letra d
Cantidad neta	Sí	Art. 9, apdo. 1, letra e
Fecha de duración mínima	Sí	Art. 9, apdo. 1, letra f
Condiciones de conservación	Condicional	Art. 9, apdo. 1, letra g
Datos del productor	Sí	Art. 9, apdo. 1, letra h
País de origen	Condicional	Art. 9, apdo. 1, letra i
Valor nutricional	Sí	Art. 9, apdo. 1, letra l

En la venta a distancia (tienda en línea), la mayor parte de esta información debe estar disponible antes de la compra - salvo la fecha de duración mínima, que puede facilitarse en el momento de la entrega.

Componentes del módulo

El módulo de alimentos consta de varios submódulos que pueden activarse de forma independiente:

Valores nutricionales

Tabla de información nutricional por 100 g o 100 ml de producto. Incluye energía (kJ/kcal), grasas, hidratos de carbono, proteínas, sal y otros nutrientes.

Detalles: Valores nutricionales

Alérgenos

Sistema de declaración de alérgenos basado en la taxonomía de WordPress. 14 alérgenos principales según el anexo II del Reglamento FIC.

Detalles: Alérgenos

Nutri-Score

Visualización de las etiquetas Nutri-Score (A-E) con los colores y las clases CSS adecuados.

Detalles: Nutri-Score

Ingredientes (lista)

Campo de texto para la lista completa de ingredientes del producto. Los alérgenos de la lista se resaltan automáticamente en negrita según los requisitos del FIC.

Alcohol

Campos para gestionar la información sobre productos alcohólicos:

Campo	Descripción
Contenido de alcohol (% vol.)	Contenido porcentual de alcohol
Advertencia	Mensaje sobre la prohibición de venta a menores
Verificación de edad	Casilla para confirmar la mayoría de edad al añadir al carrito

Para las bebidas con un contenido de alcohol superior al 1,2 % vol., es obligatorio indicar el contenido de alcohol en la etiqueta (art. 28 FIC).

País de origen

Campo para la información sobre el país de origen o el lugar de procedencia. Obligatorio para:

• carne (vacuno, porcino, aves, cordero)
• frutas y hortalizas
• pescado
• aceite de oliva
• miel
• productos en los que la ausencia de información podría inducir a error al consumidor

Configuración

Activación del módulo

Vaya a Polski > Ajustes > Contenido y confianza y active el módulo, seleccionando los submódulos que necesite.

Ajustes globales

Ajuste	Descripción
Unidad de referencia	Unidad predeterminada: por 100 g o por 100 ml
Posición en la página del producto	Dónde mostrar la información (pestaña, debajo de la descripción, barra lateral)
Mostrar en el listado	Si se muestra información resumida en las páginas de categoría
Resaltado automático de alérgenos	Poner en negrita los nombres de los alérgenos en la lista de ingredientes

Posición en la página del producto

La información de los productos alimenticios puede mostrarse en varios lugares:

1. Nueva pestaña (recomendado) - pestaña independiente “Información alimentaria” junto a la descripción y las valoraciones
2. Debajo de la descripción - directamente debajo de la descripción del producto
3. En los metadatos - en la sección de SKU/categorías
4. Personalizada - mediante shortcodes en cualquier lugar

Editor de productos

No hay una pestaña “Food” aparte en el editor de productos. Los alérgenos son el único campo de alimentos que se edita ahí: el módulo registra la taxonomía polski_allergen en los productos, así que en la columna lateral del editor aparece una caja Alérgenos donde marca los términos que correspondan.

El resto de los valores (tabla nutricional, lista de ingredientes, Nutri-Score, contenido de alcohol, lugar de origen, distribuidor, contenido neto) se guarda como meta del producto y se establece mediante las columnas CSV de abajo, o programáticamente.

Importación CSV

Todos los datos de alimentos pueden importarse de forma masiva mediante CSV:

Columna CSV	Descripción	Formato
polski_nutrients	Valores nutricionales	JSON
polski_ingredients	Lista de ingredientes	Texto
polski_nutri_score	Nutri-Score	Letra A-E
polski_alcohol_content	Contenido de alcohol	Número (p. ej. 5.0)
polski_place_of_origin	País o lugar de origen	Texto
polski_food_distributor	Distribuidor	Texto
polski_net_filling	Contenido neto	Texto

Ejemplo:

"Orange juice 1L",'{"energy_kj":180,"energy_kcal":43,"fat":0.1,"carbohydrates":9.8,"sugars":8.4,"protein":0.7,"salt":0.01}',,"",B,,Spain

Compatibilidad con Schema.org

El módulo genera automáticamente datos estructurados conformes con Schema.org:

{
    "@type": "Product",
    "additionalProperty": [
        {
            "@type": "PropertyValue",
            "name": "Energy value",
            "value": "250 kcal / 1046 kJ"
        }
    ],
    "hasAllergen": ["gluten", "milk"],
    "countryOfOrigin": {
        "@type": "Country",
        "name": "Poland"
    }
}

Extensiones programáticas

Añadir un campo de alimento personalizado

add_filter('polski/food/custom_fields', function (array $fields): array {
    $fields['organic_certified'] = [
        'label'   => 'Organic certificate',
        'type'    => 'select',
        'options' => [
            ''       => 'None',
            'eu_bio' => 'EU Bio',
            'demeter' => 'Demeter',
        ],
    ];

    return $fields;
});

Filtro de visualización de la información alimentaria

add_filter('polski/food/display_html', function (string $html, int $product_id): string {
    // Modify HTML before display
    return $html;
}, 10, 2);

Problemas frecuentes

Los datos de alimentos no aparecen en la página del producto

1. Compruebe que el módulo de alimentos está activado en Polski > Módulos, ese es el interruptor que lee el bloque de la tienda
2. Compruebe los interruptores de cada campo en el mismo módulo (Mostrar ingredientes, Mostrar alérgenos, Mostrar tabla nutricional y los demás)
3. Confirme que el producto lleva realmente los datos. Aparte de los alérgenos no hay ninguna pestaña “Food” donde escribirlos, los valores llegan por importación CSV. El tipo de producto no influye: la pestaña de datos de producto del plugin se muestra igual para productos simples, variables y externos

Los alérgenos no aparecen en negrita en la lista de ingredientes

Asegúrese de que la opción “Resaltado automático de alérgenos” está activada y de que los nombres de los alérgenos de la lista coinciden con los nombres de la taxonomía.

Los valores nutricionales se muestran incorrectamente

Compruebe el formato de los datos - los valores deben ser números (con un punto como separador decimal en la base de datos). El plugin formatea automáticamente la visualización según la configuración regional polaca (coma).

Recursos relacionados

• Valores nutricionales
• Alérgenos
• Nutri-Score
• Informar de un problema

Esta página tiene únicamente carácter informativo y no constituye asesoramiento legal. Consulte a un abogado antes de la implementación. Polski for WooCommerce es software de código abierto (GPLv2) que se proporciona sin garantía.