Food products module

Der Verkauf von Lebensmitteln online erfordert Angaben zur Zusammensetzung, zu Nährwerten, Allergenen und zur Herkunft des Produkts (EU-Verordnung Nr. 1169/2011). Polski for WooCommerce bietet ein komplettes Modul zur Verwaltung dieser Daten.

Rechtliche Anforderungen

Die LMIV-Verordnung verpflichtet Lebensmittelverkäufer, folgende Informationen anzugeben:

Information	Erforderlich	Rechtsgrundlage
Bezeichnung des Lebensmittels	Ja	Art. 9 Abs. 1 Buchst. a
Verzeichnis der Zutaten	Ja	Art. 9 Abs. 1 Buchst. b
Allergene	Ja	Art. 9 Abs. 1 Buchst. c
Menge der Zutaten	Bedingt	Art. 9 Abs. 1 Buchst. d
Nettofüllmenge	Ja	Art. 9 Abs. 1 Buchst. e
Mindesthaltbarkeitsdatum	Ja	Art. 9 Abs. 1 Buchst. f
Aufbewahrungsbedingungen	Bedingt	Art. 9 Abs. 1 Buchst. g
Angaben zum Hersteller	Ja	Art. 9 Abs. 1 Buchst. h
Herkunftsland	Bedingt	Art. 9 Abs. 1 Buchst. i
Nährwert	Ja	Art. 9 Abs. 1 Buchst. l

Beim Fernabsatz (Onlineshop) müssen die meisten dieser Informationen vor dem Kauf verfügbar sein - mit Ausnahme des Mindesthaltbarkeitsdatums, das bei der Lieferung angegeben werden kann.

Bestandteile des Moduls

Das Lebensmittel-Modul besteht aus mehreren Untermodulen, die unabhängig voneinander aktiviert werden können:

Nährwerte

Nährwerttabelle pro 100 g oder 100 ml des Produkts. Enthält Energie (kJ/kcal), Fett, Kohlenhydrate, Eiweiß, Salz und weitere Nährstoffe.

Details: Nährwerte

Allergene

System zur Allergendeklaration auf Basis der WordPress-Taxonomie. 14 Hauptallergene gemäß Anhang II der LMIV-Verordnung.

Details: Allergene

Nutri-Score

Anzeige von Nutri-Score-Kennzeichnungen (A-E) mit den passenden Farben und CSS-Klassen.

Details: Nutri-Score

Zutaten (Verzeichnis)

Textfeld für das vollständige Zutatenverzeichnis des Produkts. Allergene im Verzeichnis werden gemäß den LMIV-Anforderungen automatisch fett hervorgehoben.

Alkohol

Felder zur Verwaltung von Informationen über alkoholische Produkte:

Feld	Beschreibung
Alkoholgehalt (% vol.)	Prozentualer Alkoholgehalt
Warnhinweis	Hinweis auf das Verkaufsverbot an Minderjährige
Altersverifizierung	Checkbox zur Bestätigung der Volljährigkeit beim Hinzufügen zum Warenkorb

Bei Getränken mit einem Alkoholgehalt über 1,2 % vol. ist die Angabe des Alkoholgehalts auf dem Etikett erforderlich (Art. 28 LMIV).

Herkunftsland

Feld für Angaben zum Herkunftsland oder Herkunftsort. Erforderlich für:

Fleisch (Rind, Schwein, Geflügel, Lamm)
Obst und Gemüse
Fisch
Olivenöl
Honig
Produkte, bei denen das Fehlen der Information den Verbraucher irreführen könnte

Konfiguration

Aktivieren des Moduls

Gehen Sie zu WooCommerce > Einstellungen > Polski > Food und aktivieren Sie das Modul sowie die von Ihnen benötigten Untermodule.

Globale Einstellungen

Einstellung	Beschreibung
Bezugseinheit	Standardeinheit: pro 100 g oder pro 100 ml
Position auf der Produktseite	Wo die Informationen angezeigt werden (Tab, unter der Beschreibung, Seitenleiste)
Anzeige in der Auflistung	Ob verkürzte Informationen auf Kategorieseiten angezeigt werden
Automatische Allergen-Hervorhebung	Allergennamen im Zutatenverzeichnis fett hervorheben

Position auf der Produktseite

Informationen zu Lebensmittelprodukten können an mehreren Stellen angezeigt werden:

Neuer Tab (empfohlen) - separater Tab “Lebensmittelinformationen” neben Beschreibung und Bewertungen
Unter der Beschreibung - direkt unter der Produktbeschreibung
In den Metadaten - im Bereich SKU/Kategorien
Benutzerdefiniert - mit Shortcodes an beliebiger Stelle

Produkteditor

Nach der Aktivierung des Lebensmittel-Moduls erscheint im Produkteditor ein neuer Tab “Food” mit folgenden Abschnitten:

Nährwerte - Tabelle mit Feldern für alle Nährstoffe
Zutaten - Textfeld (WYSIWYG) für das Zutatenverzeichnis
Allergene - Checkbox-Liste der Allergene
Nutri-Score - Auswahl der Stufe A-E
Alkohol - Felder zu alkoholischen Getränken
Herkunft - Herkunftsland und Herkunftsort

CSV-Import

Alle Lebensmitteldaten können per CSV in großer Menge importiert werden:

CSV-Spalte	Beschreibung	Format
`polski_nutrients`	Nährwerte	JSON
`polski_ingredients`	Zutatenverzeichnis	Text
`polski_allergens`	Allergene	Durch Kommas getrennte Slugs
`polski_nutri_score`	Nutri-Score	Buchstabe A-E
`polski_alcohol_content`	Alkoholgehalt	Zahl (z. B. `5.0`)
`polski_country_of_origin`	Herkunftsland	Text

Beispiel:

"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

Schema.org-Kompatibilität

Das Modul generiert automatisch Schema.org-konforme strukturierte Daten:

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

Programmatische Erweiterungen

Hinzufügen eines benutzerdefinierten Lebensmittelfeldes

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

Filter für die Anzeige von Lebensmittelinformationen

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

Häufige Probleme

Der Tab “Food” erscheint nicht im Produkteditor

Prüfen Sie, ob das Lebensmittel-Modul in den Einstellungen aktiviert ist
Vergewissern Sie sich, dass das Produkt nicht vom Typ “extern/Affiliate” ist (das Modul unterstützt diesen Typ nicht)
Leeren Sie den Browser-Cache und laden Sie den Admin-Bereich neu

Allergene werden im Zutatenverzeichnis nicht fett dargestellt

Stellen Sie sicher, dass die Option “Automatische Allergen-Hervorhebung” aktiviert ist und dass die Allergennamen im Verzeichnis mit den Namen in der Taxonomie übereinstimmen.

Nährwerte werden falsch angezeigt

Prüfen Sie das Datenformat - die Werte müssen Zahlen sein (mit einem Punkt als Dezimaltrennzeichen in der Datenbank). Das Plugin formatiert die Anzeige automatisch gemäß den polnischen Regionaleinstellungen (Komma).