# Produto em destaque por categoria: guia de instalação e configuração

> Apresentação O módulo Produto em Destaque por Categoria permite-lhe designar um produto em destaque em cada uma das suas categorias PrestaShop. Esse produto distingue-se por três mecanismos visuais: um contorno…

- Página: <https://www.datafirefly.com/pt/documentation/produit-en-avant-par-categorie/>
- Idioma: pt
- Atualizado em: 2026-09-09
- Outros idiomas: [fr](https://www.datafirefly.com/documentation/produit-en-avant-par-categorie/index.md), [en](https://www.datafirefly.com/en/documentation/produit-en-avant-par-categorie/index.md), [es](https://www.datafirefly.com/es/documentation/produit-en-avant-par-categorie/index.md), [de](https://www.datafirefly.com/de/documentation/produit-en-avant-par-categorie/index.md), [it](https://www.datafirefly.com/it/documentation/produit-en-avant-par-categorie/index.md), [pl](https://www.datafirefly.com/pl/documentation/produit-en-avant-par-categorie/index.md), [nl](https://www.datafirefly.com/nl/documentation/produit-en-avant-par-categorie/index.md)
- Índice: <https://www.datafirefly.com/pt/documentation/llms.txt>

## Apresentação

O módulo **Produto em Destaque por Categoria** permite-lhe designar um produto em destaque em cada uma das suas categorias PrestaShop. Esse produto distingue-se por três mecanismos visuais: um contorno colorido, uma etiqueta promocional do tipo «Boa compra!» e uma posição à cabeça da listagem da categoria.

O módulo é compatível com PrestaShop 8.0 a 9.x e não exige qualquer sobreposição de template: a apresentação assenta inteiramente em CSS injetado no cabeçalho e no hook nativo de listagem de produtos.

## Instalação

No seu back-office, vá a **Módulos > Gestor de módulos**, clique em **Carregar um módulo** e selecione o arquivo ZIP do módulo. A instalação é automática.

Na instalação, o módulo cria a sua tabela de correspondência categoria / produto, regista as suas definições predefinidas (contorno laranja de 3 px, etiqueta «Bon plan !» ativa) e subscreve os hooks displayHeader e filterProductSearch.

## Configuração do aspeto

Abra a configuração do módulo. O primeiro bloco reúne as definições visuais partilhadas por todos os destaques:

- **Espessura do contorno**: de 1 a 50 píxeis.
- **Cor do contorno**: em formato hexadecimal (por exemplo #FFA500) ou por nome de cor CSS (por exemplo orange).
- **Seletor CSS**: o elemento que recebe o contorno. Por predefinição, a miniatura de produto completa.

### Escolher o seletor CSS

Consoante o seu tema, pode visar elementos diferentes. A regra gerada fica sempre automaticamente limitada apenas ao produto em destaque.

- **.product-miniature**: contorna a vinheta completa (valor predefinido).
- **.thumbnail-container**: contorna apenas o contentor da imagem.
- **Seletor personalizado**: modo avançado. Use o marcador {id} para escrever você mesmo o seletor completo, por exemplo o contentor da vinheta dentro da miniatura do produto visado pelo seu atributo data-id-product.

## Configuração da etiqueta «Boa compra!»

O segundo grupo de definições controla o emblema apresentado no produto em destaque:

- **Mostrar uma etiqueta**: ativa ou desativa o emblema.
- **Texto da etiqueta**: introduzido idioma a idioma. O texto aparece automaticamente no idioma do visitante.
- **Cor de fundo** e **cor do texto** da etiqueta.
- **Posição**: superior esquerda, superior direita, inferior esquerda ou inferior direita.

Se o campo Texto da etiqueta ficar vazio no idioma do visitante, o emblema não aparece. Lembre-se de preencher cada idioma ativo, incluindo o português: o texto instalado por predefinição está em francês («Bon plan !»).

Uma etiqueta como «Boa compra!» é uma alegação comercial. Se sugerir uma vantagem de preço, tem de a poder sustentar, e um anúncio de redução obriga a indicar o preço mais baixo praticado nos 30 dias anteriores (Decreto-Lei n.º 66/2021). Para um destaque puramente editorial, prefira uma formulação neutra, como «Sugestão da loja» ou «Seleção da equipa».

## Destacar um produto

No segundo formulário, selecione a **categoria** em causa e procure o **produto** a destacar. O campo de pesquisa aceita o nome ou a referência do produto e sugere resultados automaticamente: clique num deles para o selecionar, sem precisar de saber o ID.

Confirme com **Adicionar / Atualizar**. A tabela de resumo lista todos os destaques ativos, com um botão de eliminação para cada um.

O módulo gere um produto em destaque por categoria. Gravar um novo destaque para uma categoria já associada substitui automaticamente o produto anterior.

## Comportamento no lado da loja

Na página de uma categoria com um destaque, o produto selecionado recebe o contorno e a etiqueta configurados e sobe para a primeira posição da listagem. Se não aparecer na página atual por causa da ordenação ou da paginação, é acrescentado à cabeça da primeira página, apresentado exatamente como os outros produtos.

## Perguntas frequentes

### O produto em destaque tem de pertencer à categoria?

Não é obrigatório para a apresentação na primeira posição, mas é recomendado, por coerência de navegação. Aparece um aviso na gravação se o produto não estiver associado à categoria.

### A definição é própria de cada loja em multiloja?

A configuração do aspeto e as correspondências são globais nesta versão. Uma gestão por loja pode ser acrescentada a pedido.
