Nutri-Score e valores nutricionais: guia completo
Instalar e configurar o Nutri-Score no PrestaShop 8 e 9: introdução dos valores nutricionais na ficha de produto, cálculo segundo o algoritmo de 2023, forçagem manual, logótipo, emblema nas listagens e dados schema.org.
Enquadramento em Portugal. A declaração nutricional é obrigatória ao abrigo do Regulamento (UE) n.º 1169/2011, aplicável em todos os Estados-Membros e fiscalizado em Portugal pela ASAE. O Nutri-Score, esse, é um rótulo frontal voluntário: Portugal não o adotou oficialmente, ao contrário de França, onde o algoritmo revisto de 2023 foi tornado oficial pela portaria de 15 de março de 2025. Pode utilizá-lo livremente na sua loja, desde que respeite o algoritmo publicado e não o apresente como uma menção obrigatória ou oficial em Portugal.
Apresentação
O módulo Nutri-Score e valores nutricionais (dfnutriscore) mostra o logótipo Nutri-Score e uma tabela nutricional estruturada nas suas fichas de produto. Introduz os valores da sua declaração nutricional na ficha do produto; o módulo calcula a letra segundo o algoritmo revisto de 2023 e apresenta-a na ficha de produto e nas miniaturas das suas listagens. É gerado um bloco de dados estruturados schema.org NutritionInformation para os motores de pesquisa.
O módulo é compatível com PrestaShop 8.0 a 9.x, funciona com o tema Classic e os seus derivados e inclui as traduções em francês e inglês.
O pacote de traduções não inclui o português: traduza as cadeias do back-office e do front-office em Internacional > Traduções, caso contrário os títulos da tabela nutricional aparecem em inglês ao visitante.
Instalação
- No back-office, abra Módulos > Gestor de módulos.
- Clique em Carregar um módulo e coloque o arquivo ZIP do módulo.
- Terminada a instalação, clique em Configurar.
Na instalação, o módulo cria a tabela dfnutriscore_product, que guarda os valores nutricionais de cada produto, e regista-se nos hooks de apresentação necessários. Não é usado qualquer override do tema.
Configuração do módulo
A página de configuração tem quatro interruptores independentes:
- Logótipo Nutri-Score na ficha de produto: mostra o logótipo oficial junto às informações do produto.
- Separador de valores nutricionais na ficha de produto: acrescenta um separador «Valores nutricionais» com a tabela.
- Emblema nas listagens de produtos: mostra um emblema compacto nas miniaturas (categorias, página inicial, pesquisa, promoções…).
- Dados estruturados schema.org (JSON-LD): injeta um bloco NutritionInformation nas fichas de produto.
Introdução dos valores nutricionais
Abra uma ficha de produto e vá ao separador Módulos, ao painel do módulo. A introdução faz-se por 100 g (ou 100 ml no caso das bebidas). Os dados são gravados ao guardar o produto.
Mostrar o Nutri-Score para este produto
Este seletor ativa ou desativa a apresentação para o produto em causa, sem apagar os valores introduzidos. Útil para produtos não alimentares ou a aguardar validação.
Categoria de produto
A categoria determina a grelha aplicada pelo algoritmo:
- Alimento geral: caso padrão.
- Queijo: os pontos de proteínas são sempre contados, mesmo quando a componente negativa é elevada.
- Produto à base de carne vermelha: pontos de proteínas limitados a 2.
- Matérias gordas, óleos, frutos de casca rija e sementes: a energia é calculada a partir dos ácidos gordos saturados e a componente de saturados usa o rácio saturados/lípidos totais.
- Bebida: limiares reforçados (energia, açúcares), penalização de 4 pontos em caso de edulcorantes e grelha específica para a fruta. O leite e as bebidas vegetais pertencem a esta categoria.
- Água: classificada A automaticamente, sem cálculo.
Valores obrigatórios
Os sete valores da declaração nutricional: energia (kJ e kcal), lípidos, ácidos gordos saturados, hidratos de carbono, açúcares, proteínas e sal. Se preencher apenas um dos dois valores de energia, o outro é deduzido automaticamente (1 kcal = 4,184 kJ).
Valores opcionais
Fibra alimentar, ácidos gordos monoinsaturados e polinsaturados, polióis, amido e dimensão da porção. Estes valores só aparecem na tabela do front-office se estiverem preenchidos. A fibra participa no cálculo da pontuação.
Fruta, legumes e leguminosas (%)
Esta percentagem serve apenas para o cálculo da pontuação (componente positiva). Desde a revisão de 2023, só a fruta, os legumes, as leguminosas e as ervas aromáticas são tidos em conta; os frutos de casca rija e a maioria dos óleos ficam excluídos.
Edulcorantes (bebidas)
Para as bebidas com edulcorantes não nutritivos, ative este seletor: o algoritmo acrescenta 4 pontos desfavoráveis, em conformidade com a revisão de 2023.
Forçagem manual
O seletor Forçagem manual permite impor uma letra (A a E) que substitui a pontuação calculada, por exemplo quando o seu Nutri-Score foi determinado por um laboratório ou por um organismo terceiro. Deixe em «Automático (calculado)» para usar o algoritmo.
Pré-visualização em direto
Um painel no fundo do formulário mostra a letra e a pontuação recalculadas em tempo real durante a introdução, ainda antes de gravar. O valor definitivo é registado ao guardar o produto.
Algoritmo de cálculo
O módulo implementa o algoritmo Nutri-Score revisto em 2022/2023. Uma componente negativa (energia, açúcares até 15 pontos, ácidos gordos saturados, sal até 20 pontos em escalões de 0,2 g) é reduzida por uma componente positiva (proteínas até 7 pontos, fibra, fruta e legumes). Regras específicas: as proteínas não são contadas quando a componente negativa atinge 11 pontos ou mais (7 no caso das matérias gordas), exceto para os queijos; as bebidas não podem obter a letra A, reservada à água. O motor de cálculo é validado contra os casos de teste oficiais da Santé publique France, entidade responsável pelo algoritmo.
Apresentação no front-office
- Ficha de produto: o logótipo oficial é apresentado em SVG no bloco de informações adicionais, e a tabela nutricional no separador «Valores nutricionais», pela ordem regulamentar e apenas com os valores preenchidos.
- Listagens: aparece um emblema compacto nas miniaturas das categorias, da página inicial, da pesquisa e das páginas de promoções.
- Dados estruturados: é injetado um bloco JSON-LD schema.org NutritionInformation no cabeçalho da ficha de produto (calorias, lípidos, ácidos gordos saturados, hidratos de carbono, açúcares, fibra, proteínas e sódio convertido a partir do sal).
Multi-idioma e temas
A interface do back-office e as etiquetas do front-office são fornecidas em francês e inglês; todas as cadeias são traduzíveis em Internacional > Traduções. O módulo usa os hooks padrão (displayProductAdditionalInfo, displayProductExtraContent, displayProductPriceBlock) e funciona com o tema Classic e com qualquer tema compatível com 1.7+. O CSS é leve e facilmente sobreponível no seu tema.
Desinstalação
A desinstalação elimina a tabela dfnutriscore_product e toda a configuração. Exporte previamente os seus valores se quiser conservá-los.
Perguntas frequentes
A pontuação apresentada não corresponde à da minha ferramenta anterior
Confirme que a sua ferramenta aplica mesmo o algoritmo revisto de 2023: muitos produtos mudam de letra face ao cálculo anterior, sobretudo por causa dos açúcares, do sal e da fibra. Verifique também a categoria de produto selecionada e o âmbito da percentagem de fruta e legumes (os óleos e os frutos de casca rija passaram a estar excluídos).
Não aparece qualquer logótipo na ficha de produto
Certifique-se de que o interruptor correspondente está ativo na configuração, de que a apresentação está ativa para o produto e de que foram introduzidos valores suficientes (ou de que existe uma letra forçada manualmente). Limpe depois a cache do PrestaShop.
Posso mostrar a tabela sem o Nutri-Score?
Sim. Desative o logótipo e o emblema na configuração e mantenha o separador da tabela: a declaração nutricional continua visível sem a letra. É a configuração mais frequente numa loja portuguesa que quer cumprir o Regulamento (UE) n.º 1169/2011 sem adotar o rótulo frontal.
O módulo suporta multiloja?
Os valores nutricionais são guardados por produto e partilhados entre lojas; as quatro opções de apresentação configuram-se por loja através do contexto multiloja padrão do PrestaShop.
Os dados schema.org são reconhecidos pelo Google?
O módulo gera um bloco JSON-LD NutritionInformation conforme ao vocabulário schema.org, legível pelos motores de pesquisa e pelos assistentes de IA. A apresentação de resultados enriquecidos fica ao critério do Google.