Moduł produktów spożywczych

Sprzedaż żywności online wymaga podawania informacji o składzie, wartościach odżywczych, alergenach i pochodzeniu produktu (rozporządzenie UE nr 1169/2011). Wtyczka Polski for WooCommerce daje kompletny moduł do zarządzania tymi danymi.

Wymagania prawne

Sprzedawca żywności musi podać:

Informacja	Wymagana	Podstawa prawna
Nazwa żywności	Tak	Art. 9 ust. 1 lit. a
Wykaz składników	Tak	Art. 9 ust. 1 lit. b
Alergeny	Tak	Art. 9 ust. 1 lit. c
Ilość składników	Warunkowo	Art. 9 ust. 1 lit. d
Ilość netto	Tak	Art. 9 ust. 1 lit. e
Data minimalnej trwałości	Tak	Art. 9 ust. 1 lit. f
Warunki przechowywania	Warunkowo	Art. 9 ust. 1 lit. g
Dane producenta	Tak	Art. 9 ust. 1 lit. h
Kraj pochodzenia	Warunkowo	Art. 9 ust. 1 lit. i
Wartość odżywcza	Tak	Art. 9 ust. 1 lit. l

W sklepie internetowym większość tych informacji musi być dostępna przed zakupem. Wyjątek to data minimalnej trwałości - podajesz ją przy dostawie.

Składniki modułu

Moduł żywności ma kilka podmodułów. Każdy włączasz osobno:

Wartości odżywcze

Tabela wartości odżywczych per 100 g lub 100 ml. Zawiera energię (kJ/kcal), tłuszcze, węglowodany, białko, sól i inne składniki.

Szczegóły: Wartości odżywcze

Alergeny

Deklaracja 14 głównych alergenów oparta na taksonomii WordPress.

Szczegóły: Alergeny

Nutri-Score

Wyświetlanie oznaczenia Nutri-Score (A-E) z odpowiednimi kolorami i klasami CSS.

Szczegóły: Nutri-Score

Składniki (wykaz)

Pole tekstowe na wykaz składników. Alergeny w wykazie są automatycznie pogrubiane.

Alkohol

Pola do zarządzania informacjami o produktach alkoholowych:

Pole	Opis
Zawartość alkoholu (% obj.)	Procentowa zawartość alkoholu
Ostrzeżenie	Komunikat o zakazie sprzedaży osobom nieletnim
Weryfikacja wieku	Checkbox potwierdzenia pełnoletności przy dodaniu do koszyka

Napoje z alkoholem powyżej 1,2% obj. wymagają podania zawartości alkoholu.

Kraj pochodzenia

Pole na informację o kraju pochodzenia lub miejscu proweniencji. Wymagane dla:

• mięsa (wołowina, wieprzowina, drób, baranina)
• owoców i warzyw
• ryb
• oliwy z oliwek
• miodu
• produktów, gdzie brak informacji mógłby wprowadzić konsumenta w błąd

Konfiguracja

Włączenie modułu

Przejdź do WooCommerce > Ustawienia > Polski > Żywność i aktywuj moduł oraz wybierz potrzebne podmoduły.

Ustawienia globalne

Ustawienie	Opis
Jednostka referencyjna	Domyślna jednostka: per 100 g lub per 100 ml
Pozycja na stronie produktu	Gdzie wyświetlać informacje (zakładka, pod opisem, w panelu bocznym)
Wyświetlaj w listingu	Czy pokazywać skrócone informacje na stronach kategorii
Automatyczne wyróżnianie alergenów	Pogrubienie nazw alergenów w wykazie składników

Pozycja na stronie produktu

Dane o żywności wyświetlasz w jednym z miejsc:

1. Nowa zakładka (zalecane) - osobna zakładka “Informacje o żywności” obok opisu i recenzji
2. Pod opisem - bezpośrednio pod opisem produktu
3. W metadanych - w sekcji SKU/kategorie
4. Niestandardowa - za pomocą shortcodów w dowolnym miejscu

Edytor produktu

Po włączeniu modułu w edytorze produktu pojawi się zakładka “Żywność” z sekcjami:

• Wartości odżywcze - tabela z polami na wszystkie składniki
• Składniki - pole tekstowe (WYSIWYG) na wykaz składników
• Alergeny - checkbox lista alergenów
• Nutri-Score - wybór poziomu A-E
• Alkohol - pola związane z napojami alkoholowymi
• Pochodzenie - kraj pochodzenia i miejsce proweniencji

Import CSV

Dane żywnościowe importujesz masowo przez CSV:

Kolumna CSV	Opis	Format
polski_nutrients	Wartości odżywcze	JSON
polski_ingredients	Wykaz składników	Tekst
polski_allergens	Alergeny	Slugi oddzielone przecinkami
polski_nutri_score	Nutri-Score	Litera A-E
polski_alcohol_content	Zawartość alkoholu	Liczba (np. 5.0)
polski_country_of_origin	Kraj pochodzenia	Tekst

Przykład:

"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

Kompatybilność z Schema.org

Moduł automatycznie tworzy dane strukturalne Schema.org:

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

Programistyczne rozszerzenia

Dodanie niestandardowego pola żywnościowego

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;
});

Filtr wyświetlania informacji żywnościowych

add_filter('polski/food/display_html', function (string $html, int $product_id): string {
    // Modyfikacja HTML przed wyświetleniem
    return $html;
}, 10, 2);

Najczęstsze problemy

Zakładka “Żywność” nie pojawia się w edytorze produktu

1. Sprawdź, czy moduł żywności jest włączony w ustawieniach
2. Zweryfikuj, czy produkt nie jest typu “zewnętrzny/afiliacyjny” (moduł nie obsługuje tego typu)
3. Wyczyść cache przeglądarki i przeładuj panel administracyjny

Alergeny nie są pogrubione w wykazie składników

Upewnij się, że opcja “Automatyczne wyróżnianie alergenów” jest włączona i że nazwy alergenów w wykazie odpowiadają nazwom w taksonomii.

Wartości odżywcze wyświetlają się nieprawidłowo

Sprawdź format danych - w bazie wartości używają kropki jako separatora (np. 9.5). Wtyczka automatycznie wyświetla je z polskim przecinkiem (9,5).

Powiązane zasoby

• Wartości odżywcze
• Alergeny
• Nutri-Score
• Zgłoś problem

Ta strona ma wyłącznie charakter informacyjny i nie stanowi porady prawnej. Przed wdrożeniem skonsultuj się z prawnikiem. Polski for WooCommerce jest oprogramowaniem open source (GPLv2) dostarczanym bez gwarancji.