# 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…

- Strona: <https://www.datafirefly.com/pl/documentation/dfnutriscore/>
- Język: pl
- Zaktualizowano: 2026-07-31
- Inne języki: [fr](https://www.datafirefly.com/documentation/dfnutriscore/index.md), [en](https://www.datafirefly.com/en/documentation/dfnutriscore/index.md), [es](https://www.datafirefly.com/es/documentation/dfnutriscore/index.md), [de](https://www.datafirefly.com/de/documentation/dfnutriscore/index.md), [it](https://www.datafirefly.com/it/documentation/dfnutriscore/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfnutriscore/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfnutriscore/index.md)
- Indeks: <https://www.datafirefly.com/pl/documentation/llms.txt>

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

Zakres prawny: obowiązkowa deklaracja żywieniowa wynika z rozporządzenia UE nr 1169/2011 (INCO) i obowiązuje w całej Unii, w tym w Polsce. Sam Nutri-Score pozostaje systemem dobrowolnym, a wersja algorytmu wdrożona w module odpowiada francuskiemu rozporządzeniu z 15 marca 2025 i przypadkom testowym Santé publique France. Przed publikacją oznaczeń w polskim sklepie skonsultuj się z prawnikiem lub doradcą ds. prawa żywnościowego w zakresie obowiązujących u Ciebie zasad znakowania i komunikacji marketingowej.

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