PS PrestaShop Anfänger

Nutri-Score & INCO-Nährwertangaben — Komplettanleitung

Nutri-Score auf PrestaShop 8 und 9 installieren und konfigurieren: INCO-Erfassung im Produktdatenblatt, Berechnung nach dem Algorithmus 2023, manuelle Übersteuerung, Logo, Listing-Badge und schema.org-Daten.

Aktualisiert Modulversion 1.0.0

Überblick

Das Modul Nutri-Score & INCO-Nährwertangaben (dfnutriscore) zeigt das Nutri-Score-Logo und eine strukturierte Nährwerttabelle auf Ihren Produktseiten. Sie erfassen die Werte Ihrer INCO-Nährwertdeklaration im Produktdatenblatt; das Modul berechnet den Buchstaben nach dem überarbeiteten Algorithmus 2023, der in Frankreich durch den Erlass vom 15. März 2025 offiziell wurde, und zeigt ihn auf der Produktseite sowie auf den Listing-Miniaturen an. Ein strukturierter Datenblock schema.org NutritionInformation wird für Suchmaschinen generiert.

Das Modul ist mit PrestaShop 8.0 bis 9.x kompatibel, funktioniert mit dem Classic-Theme und seinen Derivaten und enthält französische und englische Übersetzungen.

Installation

  1. Öffnen Sie im Backoffice Module > Modul-Manager.
  2. Klicken Sie auf Modul hochladen und legen Sie das ZIP-Archiv des Moduls ab.
  3. Klicken Sie nach der Installation auf Konfigurieren.

Bei der Installation erstellt das Modul die Tabelle dfnutriscore_product, die die Nährwerte jedes Produkts speichert, und registriert die erforderlichen Anzeige-Hooks. Es wird kein Theme-Override verwendet.

Modulkonfiguration

Die Konfigurationsseite bietet vier unabhängige Schalter:

  • Nutri-Score-Logo auf der Produktseite: zeigt das offizielle Logo neben den Produktinformationen.
  • Nährwert-Tab auf der Produktseite: fügt einen Tab mit der INCO-Tabelle hinzu.
  • Badge in Produktlistings: zeigt ein kompaktes Badge auf den Miniaturen (Kategorien, Startseite, Suche, Angebote…).
  • Strukturierte schema.org-Daten (JSON-LD): fügt einen NutritionInformation-Block auf Produktseiten ein.

Erfassung der Nährwerte

Öffnen Sie ein Produktdatenblatt und wechseln Sie zum Tab Module, dann zum Modul-Panel. Die Werte werden pro 100 g (bzw. 100 ml bei Getränken) erfasst. Die Daten werden beim Speichern des Produkts gesichert.

Nutri-Score für dieses Produkt anzeigen

Dieser Schalter aktiviert oder deaktiviert die Anzeige für das aktuelle Produkt, ohne die erfassten Werte zu löschen. Nützlich für Non-Food-Produkte oder Produkte in Prüfung.

Produktkategorie

Die Kategorie bestimmt die vom Algorithmus angewendete Skala:

  • Allgemeines Lebensmittel: Standardfall.
  • Käse: Proteinpunkte werden immer gezählt, auch bei hoher negativer Komponente.
  • Produkt aus rotem Fleisch: Proteinpunkte auf 2 gedeckelt.
  • Fette, Öle, Nüsse und Samen: Die Energie wird aus den gesättigten Fettsäuren berechnet, die Saturates-Komponente nutzt das Verhältnis gesättigte Fettsäuren/Gesamtfett.
  • Getränk: strengere Schwellen (Energie, Zucker), 4-Punkte-Malus bei Süßstoffen und eigene Obst-Skala. Milch und pflanzliche Drinks gehören in diese Kategorie.
  • Wasser: automatisch mit A bewertet, ohne Berechnung.

Pflichtwerte

Die sieben Werte der INCO-Nährwertdeklaration: Energie (kJ und kcal), Fett, gesättigte Fettsäuren, Kohlenhydrate, Zucker, Eiweiß und Salz. Geben Sie nur einen der beiden Energiewerte an, wird der andere automatisch abgeleitet (1 kcal = 4,184 kJ).

Optionale Werte

Ballaststoffe, einfach und mehrfach ungesättigte Fettsäuren, Polyole, Stärke und Portionsgröße. Diese Werte erscheinen nur in der Frontoffice-Tabelle, wenn sie ausgefüllt sind. Ballaststoffe fließen in die Score-Berechnung ein.

Obst, Gemüse und Hülsenfrüchte (%)

Dieser Prozentsatz dient ausschließlich der Score-Berechnung (positive Komponente). Seit der Revision 2023 zählen nur Obst, Gemüse, Hülsenfrüchte und Kräuter; Nüsse und die meisten Öle sind ausgeschlossen.

Süßstoffe (Getränke)

Aktivieren Sie diesen Schalter für Getränke mit nicht-nutritiven Süßstoffen: Der Algorithmus vergibt 4 ungünstige Punkte, gemäß der Revision 2023.

Manuelle Übersteuerung

Der Schalter Manuelle Übersteuerung erzwingt einen Buchstaben (A bis E), der den berechneten Score ersetzt — etwa wenn Ihr Nutri-Score von einem Labor oder Dritten ermittelt wurde. Belassen Sie ihn auf Automatisch (berechnet), um den Algorithmus zu nutzen.

Live-Vorschau

Ein Panel am Formularende zeigt Buchstabe und Score in Echtzeit während der Eingabe, noch vor dem Speichern. Der endgültige Wert wird beim Speichern des Produkts gesichert.

Berechnungsalgorithmus

Das Modul implementiert den überarbeiteten Nutri-Score-Algorithmus 2022/2023 (Erlass vom 15. März 2025). Eine negative Komponente (Energie, Zucker bis 15 Punkte, gesättigte Fettsäuren, Salz bis 20 Punkte in 0,2-g-Schritten) wird um eine positive Komponente (Eiweiß bis 7 Punkte, Ballaststoffe, Obst und Gemüse) verringert. Sonderregeln: Proteinpunkte werden nicht gezählt, wenn die negative Komponente 11 Punkte oder mehr erreicht (7 bei Fetten), außer bei Käse; Getränke können nie die Note A erhalten, die dem Wasser vorbehalten ist. Die Berechnungs-Engine ist gegen die offiziellen Testfälle von Santé publique France validiert.

Frontoffice-Anzeige

  • Produktseite: Das offizielle Logo erscheint als SVG im Zusatzinformationsblock, die INCO-Tabelle im Nährwert-Tab in vorgeschriebener Reihenfolge — nur mit den ausgefüllten Werten.
  • Listings: Ein kompaktes Badge erscheint auf Miniaturen in Kategorien, Startseite, Suche und Angebotsseiten.
  • Strukturierte Daten: Ein JSON-LD-Block schema.org NutritionInformation wird im Head der Produktseite eingefügt (Kalorien, Fett, gesättigte Fettsäuren, Kohlenhydrate, Zucker, Ballaststoffe, Eiweiß, Natrium aus Salz umgerechnet).

Sprachen und Themes

Backoffice-Oberfläche und Frontoffice-Beschriftungen werden auf Französisch und Englisch geliefert; alle Strings sind über International > Übersetzungen übersetzbar. Das Modul nutzt Standard-Hooks (displayProductAdditionalInfo, displayProductExtraContent, displayProductPriceBlock) und funktioniert mit dem Classic-Theme und jedem 1.7+-kompatiblen Theme. Das leichtgewichtige CSS ist im Theme einfach zu überschreiben.

Deinstallation

Die Deinstallation entfernt die Tabelle dfnutriscore_product und die gesamte Konfiguration. Exportieren Sie Ihre Werte vorher, wenn Sie sie behalten möchten.

FAQ

Der angezeigte Score weicht von meinem bisherigen Tool ab

Prüfen Sie, ob Ihr Tool den überarbeiteten Algorithmus 2023 anwendet: Viele Produkte wechseln gegenüber der alten Berechnung den Buchstaben (insbesondere Zucker, Salz und Ballaststoffe). Prüfen Sie auch die gewählte Produktkategorie und den Geltungsbereich des Obst-und-Gemüse-Prozentsatzes (Öle und Nüsse sind jetzt ausgeschlossen).

Stellen Sie sicher, dass der entsprechende Schalter in der Konfiguration aktiviert ist, die Anzeige für das Produkt aktiviert ist und genügend Werte erfasst wurden (oder ein Buchstabe manuell erzwungen ist). Leeren Sie anschließend den PrestaShop-Cache.

Kann ich die Tabelle ohne den Nutri-Score anzeigen?

Ja. Deaktivieren Sie Logo und Badge in der Konfiguration und behalten Sie den Tabellen-Tab: Die Nährwertdeklaration bleibt ohne Buchstaben sichtbar.

Unterstützt das Modul Multishop?

Die Nährwerte werden pro Produkt gespeichert und zwischen Shops geteilt; die vier Anzeigeoptionen werden pro Shop über den Standard-Multishop-Kontext von PrestaShop konfiguriert.

Werden die schema.org-Daten von Google erkannt?

Das Modul generiert einen JSON-LD-NutritionInformation-Block gemäß dem schema.org-Vokabular, lesbar für Suchmaschinen und KI-Assistenten. Ob Rich Snippets angezeigt werden, liegt im Ermessen von Google.

War diese Seite hilfreich?

Immer noch nicht weiter? Support kontaktieren