Módulo Comparador de Produtos: instalação e configuração
Instalação, configuração e funcionamento do módulo Comparador de Produtos.
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
- No back-office, abra Módulos > Gestor de módulos.
- Clique em Instalar um módulo e selecione o ficheiro
dfcomparator.zip. - 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.