# Contador de Vendas: guia completo

> Apresentação O módulo Contador de Vendas apresenta, na ficha de produto, o número de vezes que um produto já foi vendido. A mensagem é gerada automaticamente a partir das linhas…

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

## Apresentação

O módulo Contador de Vendas apresenta, na ficha de produto, o número de vezes que um produto já foi vendido. A mensagem é gerada automaticamente a partir das linhas de encomenda reais da sua loja: sem introdução manual e sem dados inventados. É uma alavanca de confiança simples e eficaz, que tranquiliza o comprador hesitante ao mostrar-lhe que um artigo já convenceu outros clientes.

O módulo é compatível com o PrestaShop 8 e 9, tanto em loja única como em multiloja, e é multilingue. A renderização é feita do lado do servidor, sem dependências Composer nem JavaScript externo.

## Instalação

1. No back-office, abra **Módulos > Gestor de módulos**.
2. Clique em **Instalar um módulo** e carregue o ficheiro ZIP do módulo.
3. Assim que a instalação terminar, clique em **Configurar**.

Na instalação, o módulo regista as suas definições predefinidas e liga-se aos locais de apresentação da ficha de produto. Não é criado qualquer produto técnico nem tabela adicional: o contador lê diretamente as encomendas existentes.

## Configuração

### Ativar a apresentação

O interruptor **Ativar a apresentação** controla a apresentação global da etiqueta nas fichas de produto. Desative-o para ocultar temporariamente o contador sem desinstalar o módulo.

### Método de contagem

Estão disponíveis dois métodos:

- **Quantidade total vendida**: o módulo soma todas as quantidades encomendadas do produto. Este método destaca o volume escoado.
- **Número de encomendas**: o módulo conta o número de encomendas distintas que incluíram o produto. Este método destaca o número de clientes diferentes convencidos.

### Apenas encomendas válidas

Com esta opção ativada (recomendado), só são contadas as encomendas válidas, ou seja, pagas. Desative-a para contabilizar todas as encomendas, independentemente do estado de pagamento.

### Limiar mínimo de apresentação

Defina um **limiar mínimo** abaixo do qual não é apresentada qualquer etiqueta. Isso evita mostrar um número demasiado baixo e garante uma mensagem sempre valorizadora. O valor 0 apresenta a etiqueta logo a partir da primeira venda.

### Local de apresentação

Escolha onde a etiqueta aparece na ficha de produto:

- **Por baixo do bloco de compra** (informações adicionais do produto).
- **Junto aos botões de compra**.

Os dois locais ficam registados na instalação; apenas o local selecionado faz a renderização, pelo que não é necessário reinstalar o módulo para mudar.

### Texto apresentado

O **texto apresentado** é personalizável e traduzível por idioma. Utilize o marcador `{sales}` para inserir o número no ponto que quiser da frase. Por exemplo: `Já vendido {sales} vezes`. Se o marcador estiver ausente, o número é acrescentado automaticamente no fim do texto.

## Do lado do cliente

Na ficha de produto, a etiqueta aparece no local escolhido, com o texto configurado e o número de vendas calculado. Não é carregado qualquer script do lado do cliente: o conteúdo é gerado no servidor, o que o torna compatível com a colocação das páginas em cache.

## Multiloja

Em contexto multiloja, a contagem é automaticamente restringida à loja atual: cada loja apresenta os seus próprios números de vendas para o mesmo produto.

## Desempenho

O contador assenta numa consulta leve, que utiliza o índice existente sobre o identificador de produto das linhas de encomenda. Em lojas com catálogos grandes, a apresentação mantém-se rápida. Se o seu tráfego for muito elevado, a ativação de uma cache de páginas ao nível do servidor ou do PrestaShop beneficia diretamente o módulo, uma vez que a renderização é inteiramente feita no servidor.

## Desinstalação

A desinstalação do módulo elimina todas as suas definições e retira a etiqueta das fichas de produto. Nenhum dado de encomenda é alterado: o módulo limita-se a ler as vendas existentes.

## FAQ

### Em que dados assenta o contador?

Nas linhas de encomenda reais que contêm o produto. Pode limitar a contagem às encomendas válidas e ela é automaticamente restringida à loja atual em multiloja.

### O módulo conta as quantidades ou as encomendas?

À sua escolha. O modo de quantidade soma todas as quantidades vendidas; o modo de encomendas conta o número de encomendas distintas que incluíram o produto. O modo define-se na configuração.

### Como evitar apresentar um número demasiado baixo?

Defina um limiar mínimo de apresentação: abaixo desse número de vendas, não é apresentada qualquer etiqueta.

### O texto é traduzível?

Sim, na íntegra, por idioma, com o marcador `{sales}` para posicionar o número. São fornecidas as traduções FR, EN, ES, DE e IT. Numa loja portuguesa, escreva o seu próprio texto em português no campo previsto.

### O módulo é compatível com o PrestaShop 9?

Sim, o módulo é compatível com o PrestaShop 8.x e 9.x, tanto em loja única como em multiloja, sem dependências Composer nem JavaScript externo.