Nutri-Score i wartości odżywcze INCO: kompletny przewodnik

Wprowadzenie

Moduł Nutri-Score i wartości odżywcze INCO (dfnutriscore) wyświetla logo Nutri-Score oraz uporządkowaną tabelę wartości odżywczych na kartach produktów. Wpisujesz wartości ze swojej deklaracji żywieniowej INCO w karcie produktu, a moduł wylicza literę według zrewidowanego algorytmu 2023, uznanego za oficjalny we Francji na mocy rozporządzenia z 15 marca 2025, i wyświetla ją na karcie produktu oraz na miniaturach listingów. Dla wyszukiwarek generowany jest blok danych strukturalnych schema.org NutritionInformation.

Moduł jest zgodny z PrestaShop 8.0 do 9.x, działa z motywem Classic i motywami pochodnymi oraz zawiera tłumaczenia francuskie i angielskie.

Instalacja

1. W panelu administracyjnym otwórz Moduły > Menedżer modułów.
2. Kliknij Zainstaluj moduł i wgraj archiwum ZIP modułu.
3. Po zakończeniu instalacji kliknij Konfiguruj.

Przy instalacji moduł tworzy tabelę dfnutriscore_product, w której przechowuje wartości odżywcze każdego produktu, i rejestruje się na potrzebnych hookach wyświetlania. Nie używa żadnych nadpisań motywu.

Konfiguracja modułu

Strona konfiguracji zawiera cztery niezależne przełączniki:

• Logo Nutri-Score na karcie produktu: wyświetla oficjalne logo obok informacji o produkcie.
• Zakładka wartości odżywczych na karcie produktu: dodaje zakładkę „Wartości odżywcze” z tabelą INCO.
• Plakietka na listach produktów: wyświetla kompaktową plakietkę na miniaturach (kategorie, strona główna, wyszukiwarka, promocje).
• Dane strukturalne schema.org (JSON-LD): wstrzykuje blok NutritionInformation na kartach produktów.

Wpisywanie wartości odżywczych

Otwórz kartę produktu i przejdź do zakładki Moduły, a następnie do sekcji modułu. Wartości podaje się na 100 g (albo 100 ml dla napojów). Dane są zapisywane przy zapisie produktu.

Wyświetlaj Nutri-Score dla tego produktu

Ten selektor włącza albo wyłącza wyświetlanie dla bieżącego produktu, bez kasowania wpisanych wartości. Przydatny dla produktów nieżywnościowych albo oczekujących na weryfikację.

Kategoria produktu

Kategoria decyduje o skali stosowanej przez algorytm:

• Żywność ogólna: przypadek standardowy.
• Ser: punkty za białko są zawsze liczone, nawet gdy składowa negatywna jest wysoka.
• Produkt z czerwonego mięsa: punkty za białko ograniczone do 2.
• Tłuszcze, oleje, orzechy i nasiona: energia jest wyliczana z kwasów tłuszczowych nasyconych, a składowa nasyconych korzysta ze stosunku kwasów nasyconych do tłuszczów ogółem.
• Napój: zaostrzone progi (energia, cukry), kara 4 punktów za słodziki, osobna skala dla owoców. Mleko i napoje roślinne należą do tej kategorii.
• Woda: klasyfikowana z urzędu jako A, bez wyliczania.

Wartości obowiązkowe

Siedem wartości deklaracji żywieniowej INCO: energia (kJ i kcal), tłuszcz, kwasy tłuszczowe nasycone, węglowodany, cukry, białko i sól. Jeśli podasz tylko jedną z dwóch wartości energii, druga zostanie wyliczona automatycznie (1 kcal = 4,184 kJ).

Wartości opcjonalne

Błonnik pokarmowy, kwasy tłuszczowe jednonienasycone i wielonienasycone, poliole, skrobia oraz wielkość porcji. Te wartości pojawiają się w tabeli na froncie tylko wtedy, gdy zostały wypełnione. Błonnik bierze udział w wyliczaniu wyniku.

Owoce, warzywa i rośliny strączkowe (%)

Ten procent służy wyłącznie do wyliczenia wyniku (składowa pozytywna). Od rewizji 2023 liczą się tylko owoce, warzywa, rośliny strączkowe i zioła; orzechy oraz większość olejów są z niego wyłączone.

Słodziki (napoje)

Dla napojów zawierających słodziki nieodżywcze włącz ten selektor: algorytm dolicza 4 punkty niekorzystne, zgodnie z rewizją 2023.

Ręczne nadpisanie

Selektor Ręczne nadpisanie pozwala narzucić literę (A do E), która zastępuje wyliczony wynik, na przykład wtedy, gdy Twój Nutri-Score został ustalony przez laboratorium albo podmiot zewnętrzny. Pozostaw „Automatycznie (wyliczane)”, aby korzystać z algorytmu.

Podgląd na żywo

Sekcja na dole formularza pokazuje literę i wynik przeliczane w czasie rzeczywistym podczas wpisywania, jeszcze przed zapisem. Wartość ostateczna zapisuje się przy zapisie produktu.

Algorytm wyliczania

Moduł implementuje zrewidowany algorytm Nutri-Score 2022/2023 (rozporządzenie z 15 marca 2025). Składowa negatywna (energia, cukry do 15 punktów, kwasy tłuszczowe nasycone, sól do 20 punktów co 0,2 g) jest pomniejszana o składową pozytywną (białko do 7 punktów, błonnik, owoce i warzywa). Zasady szczególne: białko nie jest liczone, gdy składowa negatywna osiąga 11 punktów albo więcej (7 dla tłuszczów), z wyjątkiem serów; napoje nie mogą otrzymać litery A, zarezerwowanej dla wody. Silnik wyliczeń jest zwalidowany na oficjalnych przypadkach testowych Santé publique France.

Wyświetlanie na froncie

• Karta produktu: oficjalne logo wyświetla się w formacie SVG w bloku informacji dodatkowych, a tabela INCO w zakładce „Wartości odżywcze”, w kolejności wymaganej przepisami, wyłącznie z wypełnionymi wartościami.
• Listingi: kompaktowa plakietka pojawia się na miniaturach w kategoriach, na stronie głównej, w wyszukiwarce i na stronach promocji.
• Dane strukturalne: blok JSON-LD schema.org NutritionInformation jest wstrzykiwany w nagłówku karty produktu (kalorie, tłuszcze, kwasy nasycone, węglowodany, cukry, błonnik, białko, sód przeliczany z soli).

Wielojęzyczność i motywy

Interfejs panelu i etykiety na froncie są dostarczane po francusku i angielsku; wszystkie ciągi znaków można tłumaczyć przez Międzynarodowe > Tłumaczenia. Moduł korzysta ze standardowych hooków (displayProductAdditionalInfo, displayProductExtraContent, displayProductPriceBlock) i działa z motywem Classic oraz każdym motywem zgodnym z 1.7+. Lekki arkusz CSS łatwo nadpiszesz we własnym motywie.

Deinstalacja

Deinstalacja usuwa tabelę dfnutriscore_product i całą konfigurację. Wyeksportuj wcześniej swoje wartości, jeśli chcesz je zachować.

FAQ

Wyświetlany wynik nie zgadza się z wynikiem z mojego poprzedniego narzędzia

Sprawdź, czy Twoje narzędzie stosuje zrewidowany algorytm 2023: wiele produktów zmienia literę wobec dawnego wyliczenia (zwłaszcza cukry, sól i błonnik). Zweryfikuj też wybraną kategorię produktu oraz zakres procentu owoców i warzyw (oleje i orzechy są obecnie z niego wyłączone).

Na karcie produktu nie wyświetla się żadne logo

Upewnij się, że odpowiedni przełącznik jest włączony w konfiguracji, że wyświetlanie jest aktywne dla produktu i że wpisano wystarczające wartości (albo że litera została nadpisana ręcznie). Następnie wyczyść pamięć podręczną PrestaShop.

Czy mogę wyświetlać tabelę bez Nutri-Score?

Tak. Wyłącz logo i plakietkę w konfiguracji, a zostaw zakładkę z tabelą: deklaracja żywieniowa pozostanie widoczna bez litery.

Czy moduł obsługuje multisklep?

Wartości odżywcze są zapisywane per produkt i współdzielone między sklepami; cztery opcje wyświetlania konfigurujesz per sklep, przez standardowy kontekst multisklep PrestaShop.

Czy dane schema.org są rozpoznawane przez Google?

Moduł generuje blok JSON-LD NutritionInformation zgodny ze słownikiem schema.org, czytelny dla wyszukiwarek i asystentów AI. Wyświetlanie wyników rozszerzonych pozostaje decyzją Google.