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
Section titled “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
Section titled “Componentes del módulo”El módulo de alimentos consta de varios submódulos que pueden activarse de forma independiente:
Valores nutricionales
Section titled “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
Section titled “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
Section titled “Nutri-Score”Visualización de las etiquetas Nutri-Score (A-E) con los colores y las clases CSS adecuados.
Detalles: Nutri-Score
Ingredientes (lista)
Section titled “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
Section titled “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
Section titled “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
Section titled “Configuración”Activación del módulo
Section titled “Activación del módulo”Vaya a WooCommerce > Ajustes > Polski > Food y active el módulo, seleccionando los submódulos que necesite.
Ajustes globales
Section titled “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
Section titled “Posición en la página del producto”La información de los productos alimenticios puede mostrarse en varios lugares:
- Nueva pestaña (recomendado) - pestaña independiente “Información alimentaria” junto a la descripción y las valoraciones
- Debajo de la descripción - directamente debajo de la descripción del producto
- En los metadatos - en la sección de SKU/categorías
- Personalizada - mediante shortcodes en cualquier lugar
Editor de productos
Section titled “Editor de productos”Tras activar el módulo de alimentos, aparece una nueva pestaña “Food” en el editor de productos con las siguientes secciones:
- Valores nutricionales - tabla con campos para todos los nutrientes
- Ingredientes - campo de texto (WYSIWYG) para la lista de ingredientes
- Alérgenos - lista de alérgenos con casillas de verificación
- Nutri-Score - selección del nivel A-E
- Alcohol - campos relacionados con las bebidas alcohólicas
- Origen - país de origen y lugar de procedencia
Importación CSV
Section titled “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_allergens | Alérgenos | Slugs separados por comas |
polski_nutri_score | Nutri-Score | Letra A-E |
polski_alcohol_content | Contenido de alcohol | Número (p. ej. 5.0) |
polski_country_of_origin | País de origen | 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,,SpainCompatibilidad con Schema.org
Section titled “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
Section titled “Extensiones programáticas”Añadir un campo de alimento personalizado
Section titled “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
Section titled “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
Section titled “Problemas frecuentes”La pestaña “Food” no aparece en el editor de productos
Section titled “La pestaña “Food” no aparece en el editor de productos”- Compruebe que el módulo de alimentos está activado en los ajustes
- Verifique que el producto no es del tipo “externo/afiliado” (el módulo no admite este tipo)
- Borre la caché del navegador y vuelva a cargar el panel de administración
Los alérgenos no aparecen en negrita en la lista de ingredientes
Section titled “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
Section titled “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).