Nährwertkennzeichnung nach LMIV
Das Plugin verwaltet die Nährwerte, Zutaten, Allergene, den Nutri-Score und den Inverkehrbringer je Produkt. Die Angaben werden auf der Produktdetailseite, in der Produktliste und als PDF ausgegeben. Die Werte werden manuell gepflegt oder per EAN aus Open Food Facts übernommen.
Plugin-Einstellungen
Die Grundeinstellungen befinden sich in der Plugin-Konfiguration im Bereich "Grundeinstellungen". Mit den Optionen "Nutri-Score Filter ausblenden", "Allergene Filter ausblenden" und "Alkoholiker Filter ausblenden" wird festgelegt, welche Filter in der Produktliste der Storefront nicht angezeigt werden. Die Option "Nährwertangaben herunterladen" steuert, ob der PDF-Download auf der Produktdetailseite angeboten wird (Standard: aktiv). Die Option "Nährwertangaben wie eingetragen anzeigen" gibt eingetragene Werte unverändert aus (Standard: aktiv). Mit "Nachkommastelle der Nährwertangaben" wird die Anzahl der Dezimalstellen festgelegt (Standard: 2).
KI-Zuordnung
Die Einstellungen der KI-Zuordnung befinden sich in der Plugin-Konfiguration im Bereich "KI-Zuordnung". Die KI-Zuordnung ist optional. Die KI ordnet die Werte aus Open Food Facts den Eigenschaften zu. Ohne eingerichteten KI-Anbieter erfolgt die Zuordnung manuell. Im Feld "KI-Anbieter" werden Anthropic (Claude), ein OpenAI-kompatibler Dienst oder Azure OpenAI gewählt. Über "API-Key", "Modell bzw. Deployment-Name" und "Basis-URL" werden Zugang und Modell festgelegt. Mit dem Verbindungstest werden Schlüssel, Modell und Basis-URL geprüft. Die Anfragen werden über den Zugang beim gewählten Anbieter abgerechnet. Übertragen werden nur Schlüsselnamen, Einheiten und Stammdaten der Eigenschaften, keine Produktwerte.
Eigenschaften verwalten
Eigenschaften sind die Felder, denen die Werte eines Nährwerteintrags zugeordnet werden, zum Beispiel Brennwert oder Fett. Die Verwaltung erfolgt auf der Seite "Eigenschaften für Nährwerte verwalten", die über die Übersicht Nährwerte erreichbar ist. Eine Eigenschaft umfasst Bezeichnung, technischen Namen, Einheit und Position. Jede Eigenschaft gehört zu einer Gruppe (Nährwerte, Allergene oder Sonstiges). Der technische Name wird für Produktexporte benötigt. Die Position bestimmt die Reihenfolge in der Darstellung.
Nährwerte verwalten
Die Nährwerte werden im Menüpunkt "Nährwerte" verwaltet. Die Übersicht zeigt alle Einträge und ist durchsuchbar. Über "Neuer Nährwert" wird ein Eintrag angelegt und einem Produkt zugeordnet. Neue Einträge werden in der Standardsprache angelegt. Die Detailseite gliedert sich in Stammdaten (interne Bezeichnung, Produktname für die Storefront, Aktiv, Nutri-Score und Anzeige des Nutri-Scores), Zusätzliche Informationen, Zutaten, Allergene, Sonstiges und Inverkehrbringer. Die Werte werden pro Einheit und optional pro Portion eingetragen. Das Feld Portion ist nur auszufüllen, wenn die automatische Umrechnung von den Rundungsleitlinien abweicht. Ein E-Label kann als Bild hinterlegt werden. Über "Duplizieren" wird ein Eintrag als Kopie für ein ausgewähltes Produkt angelegt. Ein Eintrag kann entfernt werden.
Inverkehrbringer
Der Inverkehrbringer besteht aus Name und Adresse. Im Nährwerteintrag wird er über eine Auswahl zugeordnet. Ein neuer Inverkehrbringer wird über den Anlagedialog der Auswahl erstellt. Die Angaben werden im Reiter auf der Produktdetailseite und im PDF ausgegeben.
Nährwerte im Produkt
Im Produkt steht der Reiter "Lebensmittelinformations-Verordnung (LMIV)" zur Verfügung. Über ihn werden die Nährwertangaben des Produkts eingesehen und gepflegt.
Open Food Facts Import
Der Import übernimmt Produktdaten anhand der EAN aus der Datenbank Open Food Facts. Die Schaltfläche "Open Food Facts Import" ist im Nährwerteintrag verfügbar, sofern am Produkt eine EAN hinterlegt ist. Beim ersten Import wird die Bestätigung der Nutzungsbedingungen von Open Food Facts einmalig gespeichert. Anschließend werden Nährwerte, Allergene, Nutri-Score, Zutaten, Produktname und Marke geladen und in einer Vorschau angezeigt. Die Zuordnung zu den Eigenschaften erfolgt per KI, sofern eingerichtet, sonst manuell. Vorschläge können geändert oder entfernt werden. Gespeichert wird erst mit "Übernehmen". Der Inverkehrbringer wird anhand der Marke vorgeschlagen und ist zu prüfen. Open Food Facts stellt die Daten unter der Open Database License (ODbL) bereit. Die Daten werden von Freiwilligen erfasst und können fehlerhaft oder unvollständig sein. Laut Open Food Facts gilt eine Ratenbegrenzung von 15 Anfragen pro Minute und IP-Adresse.
Nährwerte auf der Produktdetailseite
Auf der Produktdetailseite erscheint der Reiter "Nährwerte und Produktdetails", sofern dem Produkt ein aktiver Nährwerteintrag zugeordnet ist. Die Angaben sind in die Gruppen Nährwerte, Portion, Allergene, Sonstige Angaben, Zutaten, Zusätzliche Informationen und Nutri-Score gegliedert. Leere Werte werden nicht angezeigt. Außerdem werden der Inverkehrbringer und, sofern hinterlegt, das E-Label angezeigt. Die Schaltfläche "Nährwertangaben herunterladen" wird angezeigt, sofern die Option in der Plugin-Konfiguration aktiv ist.
Nutri-Score
Der Nutri-Score wird als Badge in der Produktkarte und als Anzeige auf der Produktdetailseite ausgegeben. Voraussetzung ist, dass der Nährwerteintrag aktiv ist, ein Nutri-Score hinterlegt ist und "Nutri-Score anzeigen" aktiviert ist. Ohne hinterlegten Wert wird nichts angezeigt. Der Filter Nutri-Score in der Produktliste kann über die Plugin-Konfiguration ausgeblendet werden.
Nährwertangaben als PDF
Die Nährwertangaben stehen als PDF zum Download bereit. Der Abruf erfolgt über die Schaltfläche auf der Produktdetailseite. Das Dokument basiert auf denselben Angaben wie der Reiter und enthält das E-Label, sofern hinterlegt. Die Fußzeile übernimmt die Angaben zum Unternehmen aus den Dokumenteinstellungen des Shops.
Filter in der Produktliste
In der Produktliste stehen die Filter Nutri-Score, Allergene und Alkoholika zur Verfügung. Jeder Filter kann über die Plugin-Konfiguration ausgeblendet werden. Beim Allergen-Filter werden über "Allergene ausschließen" mehrere Allergene gewählt, Produkte mit diesen Allergenen werden dann ausgeschlossen. Bei aktiver Elasticsearch-Anbindung werden die Filterwerte im Index gepflegt.
Produktexport
Die Nährwertdaten sind in Produktexporten verfügbar. Die Erweiterung hängt die Nährwertdaten an den Export-Kriteriensatz an, sodass die Felder im Export-Template über product.extensions.gbmed_lmiv abgefragt werden können. Das folgende Beispiel zeigt Nutri-Score sowie Eigenschaften mit technischem Namen.
nutriscore:
{%- if product.extensions.gbmed_lmiv.first.nutriscore is defined and product.extensions.gbmed_lmiv.first.nutriscoreActive -%}<nutriscore>{{ product.extensions.gbmed_lmiv.first.nutriscore }}</nutriscore>{%- endif -%}{#- -#}
properties:
{%- if product.extensions.gbmed_lmiv.first.properties.[technical_name] is defined -%}<technical_name>{{ product.extensions.gbmed_lmiv.first.properties.[technical_name].inputValue }}</technical_name>{%- endif -%}{#- -#}
{%- if product.extensions.gbmed_lmiv.first.properties.calorific_value_kj is defined -%}<kj>{{ product.extensions.gbmed_lmiv.first.properties.calorific_value_kj.inputValue }}</kj>{%- endif -%}{#- -#}