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 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.

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.

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.