# Módulo Comparador de Produtos: instalação e configuração

> Instalar e configurar o módulo Comparador de Produtos para PrestaShop 8 e 9: botões automáticos, barra flutuante, página lado a lado, destaque do melhor preço e linhas comparadas.

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

## Apresentação

O módulo **Comparador de Produtos** (`dfcomparator`) acrescenta à sua loja PrestaShop um comparador lado a lado completo. Botões « Comparar » aparecem automaticamente na página de produto e nas listagens, e uma página dedicada alinha os produtos selecionados em colunas: preço, características, disponibilidade, etc.

O comparador está escrito em JavaScript vanilla, sem jQuery nem dependência externa. Funciona logo à instalação, sem configuração adicional.

## Compatibilidade

- PrestaShop 8.0 a 9.x
- Monoloja e multiloja
- 5 idiomas: FR, EN, ES, DE, IT (o português traduz-se em Internacional > Traduções)
- Nenhuma dependência (nem Composer nem framework)

## Instalação

1. No back-office, abra **Módulos > Gestor de módulos**.
2. Clique em **Instalar um módulo** e selecione o ficheiro `dfcomparator.zip`.
3. Depois de instalado, clique em **Configurar**.

O módulo regista automaticamente os seus hooks (`actionFrontControllerSetMedia`, `displayProductAdditionalInfo`, `displayFooter`) e cria a sua tabela de armazenamento na instalação. A desinstalação elimina essa tabela.

## Configuração

### Geral

- **Número máximo de produtos**: de 2 a 6 colunas comparáveis (4 por defeito).
- **Designação do botão**: texto apresentado no botão « Comparar ».
- **Cor de destaque**: cor dos botões, badges e elementos destacados.
- **Abrir num novo separador**: abre a página de comparação num separador separado.

### Locais dos botões

- **Mostrar na página de produto**: acrescenta o botão na ficha de produto.
- **Mostrar nas listagens**: acrescenta o botão nas miniaturas das listagens (categorias, pesquisa).
- **Barra flutuante**: mostra a barra de comparação persistente com miniaturas e contador.

Nas listagens, os botões são reinjetados automaticamente depois de cada filtragem Ajax (navegação por facetas, paginação, ordenação).

### Página de comparação

- **Destaque do melhor preço**: destaca a coluna com o preço mais baixo com um badge.
- **Linha de preço**: mostra ou oculta a linha de preço.
- **Botão de adição ao carrinho**: acrescenta um botão de carrinho em cada coluna.
- **Colunas fixas (sticky)**: fixa o cabeçalho e a primeira coluna ao deslocar.
- **Apenas as diferenças por defeito**: ativa desde logo a ocultação das linhas idênticas.

### Linhas comparadas

Cada linha pode ser ativada ou desativada individualmente: referência, marca, estado, disponibilidade, peso, dimensões e descrição curta. As características do produto (« Features » do PrestaShop) são acrescentadas automaticamente, uma linha por característica, pela ordem definida no catálogo. Uma linha é marcada como « idêntica » quando o seu valor é o mesmo em todos os produtos comparados.

## Funcionamento e persistência

A seleção é conservada do lado do cliente por um token de navegador (cookie `dfcmp_token`) reforçado por um espelho em `localStorage` para uma renderização instantânea. Para um cliente autenticado, as seleções feitas em vários dispositivos são fundidas. Um URL partilhável (por identificadores de produtos, `?ids=...`) permite enviar ou recuperar uma comparação.

O cookie `dfcmp_token` é um cookie funcional ligado a uma ação explícita do visitante (adicionar um produto à comparação). Mencione-o mesmo assim na sua política de cookies, ao lado dos outros cookies do site.

## Desempenho

O módulo só carrega os seus scripts quando necessário e só faz chamadas Ajax numa ação (adição, eliminação, abertura). A renderização inicial da barra assenta na cache local, sem esperar pelo servidor.

## FAQ e resolução de problemas

### O botão « Comparar » não aparece

Verifique que a apresentação na página de produto / nas listagens está ativada na configuração, e limpe depois a cache do PrestaShop (**Parâmetros avançados > Desempenho**). Num tema muito personalizado, o botão das listagens insere-se na miniatura do produto: certifique-se de que o tema expõe o identificador do produto na miniatura.

### A barra flutuante fica vazia

A barra só aparece depois de pelo menos um produto ser adicionado à comparação. Verifique também que a opção « Barra flutuante » está ativa.

### O melhor preço não é destacado

Ative as opções « Destaque do melhor preço » e « Linha de preço ». O destaque compara os preços finais com IVA apresentados dos produtos da comparação.