# Módulo Preço «A partir de» (dffromprice): documentação

> O módulo dffromprice («A partir de») mostra o preço por quantidade mais baixo diretamente nas suas listagens de produtos, assim que um produto tem um desconto por quantidade. Esta documentação…

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

O módulo **dffromprice** («A partir de») mostra o preço por quantidade mais baixo diretamente nas suas listagens de produtos, assim que um produto tem um desconto por quantidade. Esta documentação cobre a instalação, a configuração completa e a resolução de problemas.

## Apresentação

Quando um produto tem descontos por quantidade (por exemplo «3 comprados = 20 % de poupança»), essa informação só é visível na ficha do produto, no fundo da página. O módulo faz subir uma etiqueta «A partir de X €» para a miniatura do produto, nas categorias, na pesquisa, nos blocos de venda cruzada e de produtos em destaque. O preço apresentado é calculado com o mecanismo nativo do PrestaShop, tendo em conta o grupo de clientes, a moeda, o país e o método de cálculo do imposto.

## Instalação

### Pelo back-office

1. Vá a _Módulos > Gestor de módulos_.
2. Clique em _Carregar um módulo_ e selecione o ficheiro ZIP do módulo.
3. Terminado o carregamento, o módulo instala-se automaticamente e regista os seus hooks.

### Por FTP

1. Descompacte o arquivo e coloque a pasta `dffromprice` no diretório `/modules` da sua loja.
2. Em _Módulos > Gestor de módulos_, procure «A partir de» e clique em _Instalar_.

Depois da instalação, limpe a cache do PrestaShop (_Parâmetros avançados > Desempenho > Limpar cache_) para que o CSS do módulo seja tido em conta.

## Definições

A configuração encontra-se em _Módulos > Gestor de módulos > dffromprice > Configurar_ e está organizada em dois painéis.

### Apresentação

- **Ativar o módulo**: interruptor geral.
- **Mostrar nas listagens de produtos**: categorias, pesquisa, vendas cruzadas, produtos em destaque.
- **Mostrar na ficha do produto**: acrescenta o preço «A partir de» a seguir ao preço principal da ficha.
- **Etiqueta**: texto apresentado antes do preço, traduzível por idioma («A partir de», «From»...).
- **Mostrar a quantidade mínima**: indica a quantidade necessária para obter o melhor preço.
- **Etiqueta de quantidade**: texto que acompanha a quantidade, com a variável `%qty%` (ex.: «a partir de %qty% unidades»).
- **Mostrar a percentagem de poupança**: emblema «-21%» baseado na diferença entre o preço de base e o melhor preço por quantidade.
- **Etiqueta de imposto (com IVA / sem IVA)**: Nunca, Conforme as definições da loja, ou Sempre.
- **Modo de apresentação**: _Substituir o preço normal_ ou _Mostrar além do preço normal_.
- **Seletor(es) CSS a ocultar**: em modo substituição, seletores CSS ocultados quando o preço «A partir de» é apresentado.

### Aspeto e restrições

- **Cor do texto**: seletor de cor, `#f1a019` por predefinição.
- **Poupança mínima para mostrar (%)**: oculta o preço «A partir de» se a poupança for inferior a esta percentagem. 0 = mostrar sempre.
- **IDs de produtos excluídos**: lista de IDs separados por vírgulas.
- **IDs de categorias excluídas**: lista de IDs separados por vírgulas (com base na categoria predefinida do produto).
- **CSS personalizado**: acrescentado em todas as páginas do front, para trabalhar o bloco `.df-fromprice` e os seus filhos.

A etiqueta «A partir de» e a etiqueta de quantidade são campos multi-idioma preenchidos por si: escreva a versão portuguesa em cada campo. Se deixar o campo vazio no idioma português, o visitante verá o texto do idioma predefinido da loja.

## Funcionamento e cálculo do preço

O módulo apoia-se em `SpecificPrice::getQuantityDiscounts()` com os mesmos parâmetros da tabela nativa «Desconto por quantidade» (loja, moeda, país, grupo de clientes, cliente). Para cada escalão de quantidade superior a 1, o preço unitário real é calculado através de `Product::getPriceStatic()`. O preço «A partir de» só é apresentado se esse preço for estritamente inferior ao preço de base. Uma cache estática por produto e por combinação garante um único cálculo por miniatura dentro da mesma página.

## Compatibilidade com temas

O módulo liga-se ao hook `displayProductPriceBlock`, presente em todas as listagens de produtos padrão do PrestaShop. Em modo substituição, o preço normal é ocultado pelo seletor CSS configurável. O valor predefinido cobre os temas baseados no Classic e o tema Falcon:

```
.df-fromprice + .wrapper-price-taxe, .df-fromprice + .price
```

Para outro tema, inspecione o contentor do preço na miniatura e ajuste o seletor em conformidade.

## Resolução de problemas

### O preço «A partir de» não aparece

- Confirme que o produto tem mesmo um desconto por quantidade (escalão de quantidade superior a 1) e que o preço por escalão é inferior ao preço de base.
- Confirme que a apresentação nas listagens de produtos está ativa.
- Verifique o limiar mínimo de poupança: se for demasiado alto, a apresentação pode ficar bloqueada.
- Certifique-se de que o produto ou a sua categoria não constam das exclusões.

### O preço normal continua visível em modo substituição

O seletor CSS de ocultação não corresponde ao contentor de preço do seu tema. Ajuste o campo «Seletor(es) CSS a ocultar» e limpe a cache.

Depois de qualquer alteração às definições ou ao CSS, limpe a cache do PrestaShop e regenere o ficheiro CSS para aplicar as alterações.