# Guias de compra PrestaShop 8 e 9: documentação

> Apresentação O módulo cria páginas de guia de compra a partir do seu catálogo. Cada guia responde a uma pergunta do cliente, por exemplo «Que robot aspirador escolher para um…

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

## Apresentação

O módulo cria páginas de guia de compra a partir do seu catálogo. Cada guia responde a uma pergunta do cliente, por exemplo «Que robot aspirador escolher para um apartamento com animais?». Escolhe os produtos comparados e os critérios, o módulo calcula uma pontuação de 0 a 100 para cada produto, indica três escolhas e gera a classificação, a tabela comparativa, as estatísticas e a FAQ. A classificação é recalculada quando o catálogo muda.

## Instalação

1. Em **Módulos > Gestor de módulos**, clique em **Carregar um módulo** e selecione `dfbuyingguide-1.1.0.zip`.
2. A instalação cria o separador **Catálogo > Guias de compra**, as tabelas do módulo e a pasta `img/dfbuyingguide/` para as imagens de capa.
3. O botão **Configurar** do módulo abre diretamente esse separador.

A partir da versão 1.0.0, basta carregar o ZIP 1.1.0: o script de atualização acrescenta as colunas e as tabelas de estatísticas sem alterar os seus guias.

## Definições gerais

O painel **Definições**, sob a lista de guias, contém:

- **Prefixo do URL**: `guides` por defeito. Os guias ficam em `/guides/url-do-guia` e o índice de todos os guias em `/guides`.
- **Idade máxima de uma classificação**: 12 horas por defeito. Depois desse prazo, a classificação é recalculada na visita seguinte mesmo sem alteração do catálogo, o que acompanha as promoções programadas.
- **Produtos analisados por guia**: 300 por defeito. Os produtos mais vendidos do âmbito são analisados primeiro. Aumente o valor para categorias grandes, até 5000.
- **Mostrar o selo do guia nas páginas de produto**: os produtos com uma escolha ou um lugar no top 3 mostram uma ligação para o guia.
- **Mostrar os guias nas páginas de categoria**: um bloco no fundo das categorias lista os guias cujo âmbito contém a categoria.
- **Medir audiência e vendas**: ativa as estatísticas e o cookie de atribuição `dfbg_attr` (ver abaixo).

## Criar um guia

Clique em **Adicionar um guia de compra**. Os campos principais:

- **Título**: escreva-o como a pergunta do cliente. Um guia só é publicado nos idiomas em que tem título.
- **URL amigável**: gerado a partir do título se ficar vazio.
- **Imagem de capa**: mostrada no topo do guia, na página de guias e nas partilhas em redes sociais. Formato horizontal, pelo menos 1200 px de largura. É redimensionada para 1600 px de largura no máximo.
- **Autor** e **Função do autor**: mostrados sob o título e incluídos nos dados estruturados.
- **Introdução**: a quem se destina o guia e o que conta para essa utilização.
- **Produtos comparados**: as categorias do âmbito. Nenhuma categoria marcada significa todo o catálogo. **Incluir subcategorias** está ativo por defeito.
- **Preço mínimo** e **Preço máximo**: 0 significa sem limite. O preço é o que os visitantes veem, na moeda por defeito. Útil para um guia como «os melhores modelos abaixo de 300 €».
- **Apenas produtos em stock**: exclui os produtos esgotados quando a gestão de stock está ativa.
- **Produtos na classificação**: de 1 a 20, 5 por defeito. As escolhas são sempre mostradas, mesmo fora dessa classificação.
- **Limiar da escolha orçamento reduzido**: 50% por defeito (ver «As três escolhas»).
- **Permitir que os visitantes adaptem a classificação**, **Mostrar a tabela comparativa**, **Mostrar as perguntas frequentes**.
- **Perguntas adicionais**: uma pergunta por linha, no formato `Pergunta | Resposta`. São acrescentadas depois das perguntas geradas.
- **Conclusão**, **Meta título** e **Meta descrição**: o título e o início da introdução servem de valores por defeito.
- **Publicado**: um guia não publicado pode ser pré-visualizado a partir do back-office.

Clique em **Guardar e ficar**: os painéis de critérios, classificação atual, audiência e histórico aparecem sob o formulário.

## Os critérios

Sem critérios, os produtos são ordenados por vendas. Clique em **Adicionar um critério** e escolha um tipo.

### Tipos de critérios

- **Característica: valores preferidos**: atribui de 0 a 100 pontos a cada valor de uma característica, por exemplo Material: aço inoxidável 100, alumínio 70, plástico 30. Depois da primeira gravação, o formulário mostra todos os valores da característica com um cursor e botões para preencher todos os valores de uma vez. Um produto com vários valores fica com o melhor.
- **Característica: valor numérico**: o módulo lê o número contido no valor («90 min», «1200 W», «2,5 kg») e compara os produtos. Escolha em **Valores preferidos** se é melhor o mais alto ou o mais baixo. **Valor mínimo** e **Valor máximo** excluem os produtos fora do intervalo ou sem valor. **Unidade** é acrescentada aos números das estatísticas.
- **Preço (mais baixo é melhor)**.
- **Vendas (popularidade)**: com base nas quantidades vendidas.
- **Produtos recentes**: com base na data de criação do produto.

### Peso, obrigatoriedade e textos

- **Peso**: de 0 a 10. O peso 0 mostra o critério na tabela comparativa sem o usar na pontuação.
- **Obrigatório** (critérios de característica): os produtos sem essa característica, ou cujo valor tem 0 pontos, ficam fora do guia.
- **Etiqueta mostrada aos visitantes**: se ficar vazia, é usado o nome da característica.
- **Conselho de compra**: explica porque é que o critério conta. Aparece na secção «Como escolher», por cima das estatísticas do catálogo.

As setas da lista de critérios mudam a sua ordem de apresentação na tabela comparativa e na secção «Como escolher».

## Cálculo da pontuação

Para cada critério, os valores dos produtos são convertidos para uma escala de 0 a 100: nos critérios numéricos, preço, vendas e novidade, o melhor produto do âmbito obtém 100 e o mais fraco 0; nos critérios de valores aplicam-se os pontos que atribuiu. A pontuação global é a média das pontuações ponderada pelo peso dos critérios. Os preços são comparados na moeda por defeito.

O painel **Classificação atual** mostra os 20 primeiros produtos com a pontuação global, o preço, a escolha e uma coluna de pontuação por critério. Use-o para afinar os pesos antes de publicar.

## As três escolhas

- **Melhor escolha global**: o produto classificado em primeiro lugar.
- **Melhor relação qualidade-preço**: entre os produtos mais baratos do que a melhor escolha e cuja pontuação atinge pelo menos 60% da sua, aquele com a melhor relação entre pontuação e preço.
- **Melhor com orçamento reduzido**: o produto mais barato que atinge a percentagem definida em **Limiar da escolha orçamento reduzido** da pontuação da melhor escolha, se for mais barato do que as outras duas escolhas.

Uma escolha só aparece se algum produto cumprir a condição. Os pontos fortes de um produto são os critérios com 70 ou mais (3 no máximo), os pontos a considerar os que têm 30 ou menos (2 no máximo).

## Atualização das classificações

A alteração de um produto, de um preço específico, de um valor de característica ou de uma categoria marca as classificações para recalcular. Uma alteração de stock só marca os guias configurados com «Apenas produtos em stock». O recálculo acontece:

- na visita seguinte ao guia;
- pela tarefa cron, se a programar;
- com o botão **Recalcular agora** de um guia ou **Recalcular agora todas as classificações** da lista.

### Tarefa cron

O URL do cron é mostrado por cima da lista de guias. Chame-o de hora a hora para que os visitantes nunca esperem por um recálculo. Acrescente `&force=1` para recalcular todos os guias. O botão **Novo token** substitui o token e o URL antigo deixa de funcionar. Exemplo:

```
0 * * * * curl -s "https://a-sua-loja.pt/index.php?fc=module&module=dfbuyingguide&controller=cron&token=O_SEU_TOKEN" > /dev/null
```

### Data mostrada e histórico

A data «Classificação atualizada em» que os visitantes veem só muda se mudarem os primeiros lugares ou as escolhas. O painel **Histórico das recomendações** lista essas alterações com os 5 primeiros produtos em cada data.

Os hooks de um módulo não são executados para um funcionário cujo perfil não tenha a permissão «Ver» sobre o módulo. Se a sua equipa alterar o catálogo com um perfil assim, a tarefa cron e a idade máxima das classificações servem de rede de segurança.

## A página do guia

Por ordem: título, autor, número de produtos comparados e data de atualização, imagem de capa, introdução, índice, escolhas, classificação, tabela comparativa, secção «Como escolher», conclusão, FAQ, uma nota sobre o método e os guias relacionados (guias publicados que partilham uma categoria).

### Adaptar a classificação

Quando a opção está ativa e o guia tem pelo menos 2 critérios com peso, um painel acima da classificação oferece um cursor de importância por critério e um cursor de orçamento máximo. A classificação é recalculada no navegador entre os 20 melhores produtos, sem recarregar, e uma ligação repõe a classificação do guia. Sem JavaScript, o painel fica oculto. Os motores de busca veem sempre a classificação do guia.

### Adicionar ao carrinho

Os produtos que se adicionam diretamente ao carrinho, sem combinação a escolher, mostram um botão **Adicionar ao carrinho** que usa a função de carrinho do tema. Os restantes mostram **Ver o produto**. Em modo catálogo, não é mostrado nenhum botão de carrinho.

### Pré-visualização de um guia não publicado

O botão **Pré-visualizar o guia** abre a página com uma faixa de pré-visualização. A ligação contém um token próprio do guia, a página fica em `noindex` e as estatísticas não são contadas.

### Personalizar as cores

As cores são definidas por variáveis CSS que o seu tema pode substituir: `--dfbg-accent`, `--dfbg-accent-soft`, `--dfbg-muted`, `--dfbg-line`, `--dfbg-surface`, `--dfbg-low` e `--dfbg-radius`. Os tipos de letra são os do tema.

## Localizações e SEO

- **Índice dos guias**: `/guides`, com a imagem de capa ou o produto classificado em primeiro lugar de cada guia.
- **Páginas de categoria**: hook `displayFooterCategory`.
- **Páginas de produto**: hook `displayProductAdditionalInfo`, selo de escolha ou «Posição n.º X» com ligação para o guia.
- **Localização livre**: `{hook h='displayDfBuyingGuides' id_category=12}` num template do tema. Sem `id_category`, são listados todos os guias.
- **Sitemap**: se o módulo nativo gsitemap estiver instalado, o índice e os guias são acrescentados com a data da última alteração de recomendação.
- **Dados estruturados**: Article (com autor e imagem), ItemList da classificação e FAQPage. As etiquetas Open Graph são acrescentadas no head.
- **Multilingue**: canonical, hreflang para cada idioma em que o guia tem título e redirecionamento 301 quando um URL é aberto noutro idioma.

## Audiência e vendas

A lista de guias mostra as visualizações e a receita dos últimos 30 dias, e quatro indicadores globais no topo. Cada guia tem um painel **Audiência e vendas** para 30 dias e desde o início:

- **Visualizações**: uma por visitante, por guia e por dia, sem robôs.
- **Cliques em produtos** e taxa de cliques face às visualizações.
- **Cliques em adicionar ao carrinho** a partir da classificação.
- **Visitantes que adaptaram a classificação**.
- **Encomendas** e taxa de conversão face às visualizações.
- **Receita sem impostos**: montante sem impostos dos produtos vindos do guia, convertido para a moeda por defeito.

### Atribuição das vendas

Quando um visitante clica num produto a partir de um guia, o cookie próprio `dfbg_attr` memoriza o produto e o guia durante 30 dias. Quando o produto entra no carrinho, a atribuição é copiada para o carrinho. Na validação da encomenda, incluindo por webhook de pagamento, a encomenda e o montante sem impostos desse produto são atribuídos ao guia. Só contam as encomendas validadas (estado pago ou equivalente).

O cookie `dfbg_attr` é criado no clique sem passar pelo seu gestor de consentimento. Indique-o na sua política de cookies ou desative a opção **Medir audiência e vendas**.

## Duplicar um guia

A ação **Duplicar** da lista copia o guia com os critérios, os pontos por valor, as lojas e a imagem. A cópia é criada não publicada, com um URL com sufixo, e abre logo para edição.

## Multiloja

Cada guia é associado às lojas escolhidas no seu formulário. As classificações, o histórico e as estatísticas são calculados loja a loja.

## Resolução de problemas

- **«Nenhum produto corresponde a este guia»**: verifique as categorias, o intervalo de preços, a opção de stock e os critérios obrigatórios ou com limites.
- **Falta um produto esperado**: tem de estar ativo, visível no catálogo e entre os produtos analisados. Aumente «Produtos analisados por guia» para categorias grandes.
- **O guia devolve um erro 404**: não está publicado, não tem título neste idioma ou não está associado a esta loja.
- **A classificação não reflete uma alteração**: clique em «Recalcular agora» e programe a tarefa cron.
- **A imagem de capa é recusada**: verifique se a pasta `img/dfbuyingguide/` tem permissão de escrita.