Модуль харчових продуктів

Продаж харчування онлайн вимагає інформації про склад, харчову цінність, алергени та походження продукту (регламент ЄС nr 1169/2011). Плагін Polski for WooCommerce надає повний модуль для управління цими даними.

Правові вимоги

Регламент FIC зобов’язує продавців харчових продуктів надавати таку інформацію:

Інформація	Обов’язкова	Правова підстава
Назва харчового продукту	Так	Ст. 9 п. 1 літ. a
Перелік інгредієнтів	Так	Ст. 9 п. 1 літ. b
Алергени	Так	Ст. 9 п. 1 літ. c
Кількість інгредієнтів	Умовно	Ст. 9 п. 1 літ. d
Маса нетто	Так	Ст. 9 п. 1 літ. e
Мінімальний термін придатності	Так	Ст. 9 п. 1 літ. f
Умови зберігання	Умовно	Ст. 9 п. 1 літ. g
Дані виробника	Так	Ст. 9 п. 1 літ. h
Країна походження	Умовно	Ст. 9 п. 1 літ. i
Харчова цінність	Так	Ст. 9 п. 1 літ. l

У випадку дистанційного продажу (інтернет-магазин) більшість цієї інформації повинна бути доступна перед покупкою - за винятком мінімального терміну придатності, який може бути вказаний при доставці.

Компоненти модуля

Модуль харчування складається з кількох підмодулів, які можна вмикати незалежно:

Харчова цінність

Таблиця харчової цінності на 100 г або 100 мл продукту. Включає енергію (кДж/ккал), жири, вуглеводи, білок, сіль та інші поживні речовини.

Детальніше: Харчова цінність

Алергени

Система декларування алергенів на основі таксономії WordPress. 14 основних алергенів відповідно до додатку II регламенту FIC.

Детальніше: Алергени

Nutri-Score

Відображення позначки Nutri-Score (A-E) з відповідними кольорами та CSS-класами.

Детальніше: Nutri-Score

Інгредієнти (перелік)

Текстове поле для повного переліку інгредієнтів продукту. Алергени у переліку автоматично виділяються жирним шрифтом відповідно до вимог FIC.

Алкоголь

Поля для управління інформацією про алкогольну продукцію:

Поле	Опис
Вміст алкоголю (% об.)	Процентний вміст алкоголю
Попередження	Повідомлення про заборону продажу неповнолітнім
Верифікація віку	Чекбокс підтвердження повноліття при додаванні до кошика

Для напоїв з вмістом алкоголю понад 1,2% об. вимагається вказання вмісту алкоголю на етикетці (ст. 28 FIC).

Країна походження

Поле для інформації про країну походження або місце провенієнції. Обов’язково для:

• м’яса (яловичина, свинина, птиця, баранина)
• фруктів та овочів
• риби
• оливкової олії
• меду
• продуктів, де відсутність інформації могла б ввести споживача в оману

Налаштування

Увімкнення модуля

Перейдіть до WooCommerce > Налаштування > Polski > Харчування та активуйте модуль і виберіть потрібні підмодулі.

Глобальні налаштування

Налаштування	Опис
Одиниця виміру	Одиниця за замовчуванням: на 100 г або на 100 мл
Позиція на сторінці продукту	Де відображати інформацію (вкладка, під описом, у бічній панелі)
Відображати у лістингу	Чи показувати скорочену інформацію на сторінках категорій
Автоматичне виділення алергенів	Жирний шрифт для назв алергенів у переліку інгредієнтів

Позиція на сторінці продукту

Інформація про харчовий продукт може відображатися у кількох місцях:

1. Нова вкладка (рекомендовано) - окрема вкладка “Інформація про харчування” поряд з описом та відгуками
2. Під описом - безпосередньо під описом продукту
3. У метаданих - у секції SKU/категорії
4. Власна - за допомогою shortcode у будь-якому місці

Редактор продукту

Після активації модуля харчування в редакторі продукту з’являється нова вкладка “Харчування” з такими секціями:

• Харчова цінність - таблиця з полями для всіх поживних речовин
• Інгредієнти - текстове поле (WYSIWYG) для переліку інгредієнтів
• Алергени - список чекбоксів алергенів
• Nutri-Score - вибір рівня A-E
• Алкоголь - поля для алкогольних напоїв
• Походження - країна походження та місце провенієнції

Імпорт CSV

Усі дані про харчування можна імпортувати масово через CSV:

Колонка CSV	Опис	Формат
polski_nutrients	Харчова цінність	JSON
polski_ingredients	Перелік інгредієнтів	Текст
polski_allergens	Алергени	Slug-и через кому
polski_nutri_score	Nutri-Score	Літера A-E
polski_alcohol_content	Вміст алкоголю	Число (наприклад, 5.0)
polski_country_of_origin	Країна походження	Текст

Приклад:

"Sok pomarańczowy 1L",'{"energy_kj":180,"energy_kcal":43,"fat":0.1,"carbohydrates":9.8,"sugars":8.4,"protein":0.7,"salt":0.01}',,"",B,,Hiszpania

Сумісність з Schema.org

Модуль автоматично генерує структуровані дані, сумісні з Schema.org:

{
    "@type": "Product",
    "additionalProperty": [
        {
            "@type": "PropertyValue",
            "name": "Wartość energetyczna",
            "value": "250 kcal / 1046 kJ"
        }
    ],
    "hasAllergen": ["gluten", "mleko"],
    "countryOfOrigin": {
        "@type": "Country",
        "name": "Polska"
    }
}

Програмні розширення

Додавання власного поля харчування

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

    return $fields;
});

Фільтр відображення інформації про харчування

add_filter('polski/food/display_html', function (string $html, int $product_id): string {
    // Модифікація HTML перед відображенням
    return $html;
}, 10, 2);

Найпоширеніші проблеми

Вкладка “Харчування” не з’являється в редакторі продукту

1. Перевірте, чи модуль харчування увімкнено в налаштуваннях
2. Перевірте, чи продукт не є типу “зовнішній/афіліатний” (модуль не підтримує цей тип)
3. Очистіть кеш браузера та перезавантажте адміністративну панель

Алергени не виділені жирним у переліку інгредієнтів

Переконайтеся, що опція “Автоматичне виділення алергенів” увімкнена і що назви алергенів у переліку відповідають назвам у таксономії.

Харчова цінність відображається неправильно

Перевірте формат даних - значення повинні бути числами (з крапкою як десятковим роздільником у базі даних). Плагін автоматично форматує відображення відповідно до польських регіональних налаштувань (кома).

Пов’язані ресурси

• Харчова цінність
• Алергени
• Nutri-Score
• Повідомити про проблему

Ця сторінка має виключно інформаційний характер і не є юридичною консультацією. Перед впровадженням зверніться до юриста. Polski for WooCommerce - це програмне забезпечення з відкритим кодом (GPLv2), що надається без гарантій.