Allergens

Die EU-Vorschriften verlangen die Kennzeichnung von 14 Allergenen auf den Etiketten von Lebensmittelprodukten. In einem Onlineshop müssen die Allergeninformationen vor dem Kauf sichtbar sein. Polski for WooCommerce verwaltet Allergene über eine WordPress-Taxonomie.

14 Hauptallergene

Gemäß Anhang II der LMIV-Verordnung umfasst die Pflichtdeklaration:

Nr	Allergen	Taxonomie-Slug	Symbol
1	Glutenhaltiges Getreide	`gluten`	gluten
2	Krebstiere	`crustaceans`	crustaceans
3	Eier	`eggs`	eggs
4	Fisch	`fish`	fish
5	Erdnüsse	`peanuts`	peanuts
6	Sojabohnen	`soy`	soy
7	Milch (Laktose)	`milk`	milk
8	Schalenfrüchte (Nüsse)	`nuts`	nuts
9	Sellerie	`celery`	celery
10	Senf	`mustard`	mustard
11	Sesamsamen	`sesame`	sesame
12	Schwefeldioxid und Sulfite	`sulphites`	sulphites
13	Lupinen	`lupin`	lupin
14	Weichtiere	`molluscs`	molluscs

Die Taxonomie polski_allergen

Das Plugin registriert die Taxonomie polski_allergen, die dem Beitragstyp product zugeordnet ist. Bei der Aktivierung des Plugins wird die Taxonomie automatisch mit den 14 Hauptallergenen befüllt.

Allergene verwalten

Gehen Sie zu Produkte > Allergene, um die Allergenliste zu verwalten. Die standardmäßigen 14 Allergene werden automatisch erstellt. Sie können eigene Allergene hinzufügen, die für Ihr Sortiment spezifisch sind.

Jedes Allergen enthält:

Feld	Beschreibung
Name	Angezeigter Allergenname (z. B. “Milch und Milchprodukte”)
Slug	URL-Kennung (z. B. `milk`)
Beschreibung	Zusätzliche Informationen zum Allergen
Symbol	Optionales Symbol (Taxonomie-Miniaturbild)

Allergene einem Produkt zuweisen

Kreuzen Sie im Produkteditor, im Reiter “Lebensmittel” oder im seitlichen Bereich “Allergene”, die entsprechenden Allergene aus der Checkbox-Liste an.

Es stehen drei Deklarationsmodi zur Verfügung:

Modus	Beschreibung	Beispiel
Enthält	Das Produkt enthält das Allergen	“Enthält: Milch, Eier”
Kann enthalten	Risiko einer Kreuzkontamination	“Kann Nüsse enthalten”
Enthält nicht	Ausdrückliche Abwesenheitsdeklaration (optional)	“Enthält kein Gluten”

Modus “Kann enthalten”

Der Modus “Kann enthalten” dient dazu, das Risiko von Spuren eines Allergens anzugeben, die aus den Produktionsprozessen resultieren. Im Produkteditor kann jedes Allergen markiert werden als:

Enthält - Allergen ist eine Zutat des Produkts
Kann enthalten - Risiko von Spuren

Konfiguration

Gehen Sie zu WooCommerce > Einstellungen > Polski > Lebensmittel und konfigurieren Sie den Abschnitt “Allergene”.

Einstellung	Standard	Beschreibung
Allergen-Deklaration aktivieren	Ja	Aktiviert das Allergensystem
In Zutaten hervorheben	Ja	Automatische Fettschrift der Allergene in der Zutatenliste
Symbole anzeigen	Nein	Zeigt Allergen-Symbole an
Position auf der Seite	Reiter Lebensmittel	Wo die Allergene angezeigt werden
Modus “Kann enthalten”	Ja	Aktiviert die Option zur Spuren-Deklaration
Anzeigeformat	Liste	`list`, `icons`, `inline`

Automatische Hervorhebung in den Zutaten

Gemäß Artikel 21 der LMIV-Verordnung müssen Allergene in der Zutatenliste hervorgehoben werden - üblicherweise durch Fettschrift oder Großbuchstaben. Das Plugin durchsucht das Feld “Zutaten” automatisch nach Allergennamen und umschließt sie mit einem <strong>-Tag.

Beispiel:

Eingabetext:

Wheat flour, sugar, butter, chicken eggs, skimmed milk powder, salt

Angezeigter Text:

Wheat flour (gluten), sugar, butter (milk), chicken eggs, skimmed milk powder, salt

Mit HTML-Hervorhebung:

<strong>Wheat</strong> flour (<strong>gluten</strong>), sugar, butter (<strong>milk</strong>),
<strong>eggs</strong>, <strong>milk</strong> powder, salt

Konfiguration der Hervorhebung

Das Plugin durchsucht die Zutatenliste nach Allergen-Synonymen. Die Synonymliste ist konfigurierbar:

add_filter('polski/allergens/synonyms', function (array $synonyms): array {
    $synonyms['gluten'] = ['pszenica', 'pszenna', 'żyto', 'żytnia', 'owies', 'owsiana', 'jęczmień', 'orkisz'];
    $synonyms['milk'] = ['mleko', 'mleczny', 'mleczna', 'masło', 'śmietana', 'jogurt', 'ser', 'laktoza'];
    $synonyms['eggs'] = ['jaja', 'jajka', 'jajeczny', 'jajeczna'];

    return $synonyms;
});

Shortcode

Verwenden Sie den Shortcode [polski_allergens], um die Allergen-Deklaration anzuzeigen.

Parameter

Parameter	Typ	Standard	Beschreibung
`product_id`	int	aktuell	Produkt-ID
`format`	string	`list`	Format: `list`, `icons`, `inline`, `table`
`show_may_contain`	bool	`true`	Ob der Abschnitt “Kann enthalten” angezeigt wird
`show_icons`	bool	`false`	Ob Allergen-Symbole angezeigt werden
`label`	string	`"Allergens: "`	Beschriftung vor der Liste
`wrapper`	string	`div`	Umschließendes HTML-Element

Anwendungsbeispiele

Grundlegende Allergenliste:

[polski_allergens]

Ergebnis:

Allergens: milk, eggs, gluten
May contain: nuts

Inline-Format mit Symbolen:

[polski_allergens format="inline" show_icons="true"]

Ohne Abschnitt “Kann enthalten”:

[polski_allergens show_may_contain="false"]

Tabellenformat:

[polski_allergens format="table"]

Für ein bestimmtes Produkt:

[polski_allergens product_id="456"]

In einer PHP-Vorlage:

echo do_shortcode('[polski_allergens product_id="' . $product->get_id() . '"]');

Programmatischer Zugriff

Allergene eines Produkts abrufen

// Allergene "Enthält"
$allergens = wp_get_object_terms($product_id, 'polski_allergen');

foreach ($allergens as $allergen) {
    echo $allergen->name; // z. B. "Milch und Milchprodukte"
}

// Allergene "Kann enthalten"
$may_contain = get_post_meta($product_id, '_polski_may_contain_allergens', true);
if ($may_contain) {
    $may_contain_terms = get_terms([
        'taxonomy' => 'polski_allergen',
        'slug'     => $may_contain,
    ]);
}

Allergene programmatisch zuweisen

// Allergene "Enthält" setzen
wp_set_object_terms($product_id, ['gluten', 'milk', 'eggs'], 'polski_allergen');

// Allergene "Kann enthalten" setzen
update_post_meta($product_id, '_polski_may_contain_allergens', ['nuts', 'soy']);

Prüfen, ob ein Produkt ein Allergen enthält

if (has_term('gluten', 'polski_allergen', $product_id)) {
    // Produkt enthält Gluten
}

CSV-Import

Allergene können per CSV importiert werden:

CSV-Spalte	Beschreibung	Format
`polski_allergens`	Allergene “Enthält”	Durch Kommas getrennte Slugs
`polski_may_contain`	Allergene “Kann enthalten”	Durch Kommas getrennte Slugs