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 Polski > Einstellungen > Inhalt & Vertrauen 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:

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

Produkteditor

Im Produkteditor gibt es keinen eigenen Tab “Food”. Allergene sind das einzige Lebensmittelfeld, das dort bearbeitet wird: Das Modul registriert die Taxonomie polski_allergen für Produkte, sodass in der Seitenspalte des Editors eine Box Allergene erscheint, in der Sie die zutreffenden Begriffe ankreuzen.

Alle übrigen Werte (Nährwerttabelle, Zutatenverzeichnis, Nutri-Score, Alkoholgehalt, Herkunftsort, Vertrieb, Nettofüllmenge) werden als Produkt-Meta gespeichert und über die CSV-Spalten unten oder programmatisch gesetzt.

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_nutri_score	Nutri-Score	Buchstabe A-E
polski_alcohol_content	Alkoholgehalt	Zahl (z. B. 5.0)
polski_place_of_origin	Herkunftsland oder Herkunftsort	Text
polski_food_distributor	Vertrieb	Text
polski_net_filling	Nettofüllmenge	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

Lebensmitteldaten erscheinen nicht auf der Produktseite

1. Prüfen Sie, ob das Lebensmittel-Modul unter Polski > Module aktiviert ist, diesen Schalter liest der Block im Shop aus
2. Prüfen Sie die Schalter der einzelnen Felder im selben Modul (Zutaten anzeigen, Allergene anzeigen, Nährwerttabelle anzeigen und die übrigen)
3. Vergewissern Sie sich, dass das Produkt die Daten wirklich trägt. Außer Allergenen gibt es keinen Tab “Food”, in den man sie eintippen könnte, die Werte kommen per CSV-Import. Der Produkttyp spielt dabei keine Rolle: Der Produktdaten-Tab des Plugins wird für einfache, variable und externe Produkte gleichermaßen gerendert

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).

Verwandte Ressourcen

• Nährwerte
• Allergene
• Nutri-Score
• Ein Problem melden

Diese Seite dient ausschließlich Informationszwecken und stellt keine Rechtsberatung dar. Konsultieren Sie vor der Umsetzung einen Anwalt. Polski for WooCommerce ist Open-Source-Software (GPLv2), die ohne Gewährleistung bereitgestellt wird.