Popularidade no Carrinho: documentação
Instalar e configurar o módulo de contagem de carrinhos na ficha de produto.
O módulo Popularidade no Carrinho mostra na ficha de produto um emblema de prova social com o número de carrinhos que contêm o produto, por exemplo «Em mais de 20 carrinhos». Este guia cobre a instalação, a configuração de cada definição, o funcionamento da contagem e a resolução de problemas.
Instalação
O módulo instala-se como qualquer módulo PrestaShop, sem dependências externas.
- No back-office, abra Módulos > Gestor de módulos.
- Clique em Carregar um módulo e selecione o ficheiro
dfcartpopularity.zip. - Terminada a instalação, clique em Configurar.
Compatível com PrestaShop 8.0 a 9.x. Não é necessária qualquer dependência Composer nem biblioteca JavaScript externa.
Configuração
A página de configuração reúne todas as definições de apresentação e de contagem.
Texto apresentado
A mensagem mostrada no emblema, traduzível por idioma. Use o marcador {count} para inserir dinamicamente o número. Exemplo: Em mais de {count} carrinhos. As traduções francesa, inglesa, espanhola, alemã e italiana são fornecidas por predefinição.
O pacote não inclui o português. Escreva você mesmo a mensagem no campo do idioma português, mantendo o marcador {count}, caso contrário o visitante verá o texto do idioma de recurso.
Limiar de apresentação
Número mínimo de carrinhos a partir do qual o emblema aparece. Abaixo desse limiar não é mostrado nada, o que evita expor um número pouco favorável. Valor predefinido: 20.
Modo de apresentação do número
- Escalão arredondado: o contador é arredondado por defeito segundo um escalão (por exemplo, 23 carrinhos mostram «mais de 20»). Ideal para um efeito credível que evolui por patamares.
- Número exato: é apresentado o número real, para as lojas que preferem total transparência.
Escalão de arredondamento
Utilizado apenas no modo escalão. Determina o patamar de arredondamento: um escalão de 10 transforma 23 em «mais de 20» e 37 em «mais de 30».
Janela temporal (horas)
Conta apenas os carrinhos atualizados dentro desta janela. Por exemplo, 168 = 7 dias. Defina 0 para não impor qualquer limite de tempo.
Apenas carrinhos ativos
Com esta opção ativa, os carrinhos já transformados em encomenda ficam excluídos da contagem. Reflete assim apenas a procura ativa.
Localização
Escolha onde o emblema aparece na ficha: por baixo do bloco de adição ao carrinho (informações adicionais) ou junto aos botões de compra.
Duração da cache (segundos)
Período de conservação da contagem antes do recálculo. Por predefinição, 600 segundos (10 minutos). Defina 0 para recalcular a cada apresentação, o que é desaconselhado em produção.
A cada gravação das definições, a cache de contagem é limpa automaticamente para aplicar de imediato os novos parâmetros.
Como funciona a contagem
O módulo conta os carrinhos reais que contêm o produto. A contagem é desduplicada por carrinho, ou seja, um mesmo carrinho nunca é contado duas vezes, e está limitada à loja atual em contexto multiloja. A janela temporal e a opção «apenas carrinhos ativos» afinam esta contagem para que reflita a procura relevante.
O número apresentado corresponde a carrinhos efetivamente existentes na base de dados, o que torna a alegação defensável perante a ASAE ao abrigo do regime das práticas comerciais desleais (Decreto-Lei n.º 57/2008, alterado pelo Decreto-Lei n.º 109-G/2021). O modo de escalão arredondado continua a ser fiel, porque arredonda sempre por defeito. Evite, em contrapartida, inflacionar artificialmente o limiar ou o escalão para sugerir uma procura que não existe.
Desempenho e cache
Para evitar uma consulta de contagem em cada visualização de produto, o resultado é guardado numa tabela de cache dedicada, com um tempo de vida configurável. A contagem só é recalculada quando a cache expira, o que preserva o desempenho mesmo em lojas com muito tráfego.
Multiloja e multi-idioma
Em multiloja, a contagem é limitada à loja consultada. Do lado dos idiomas, o texto do emblema é totalmente traduzível: define-se de forma independente para cada idioma ativo da loja, com o marcador {count} para o número.
Integração no tema
O emblema é gerado do lado do servidor através de um modelo do módulo. Se quiser reposicioná-lo com precisão no seu tema, a variável Smarty {$dfcp_message} contém a mensagem pronta a usar e pode ser inserida num override da ficha de produto.
Resolução de problemas
O emblema não aparece
Confirme que o número real de carrinhos com o produto atinge o limiar definido. Se o limiar estiver em 20 mas o produto estiver apenas em 5 carrinhos, não aparece qualquer emblema: é o comportamento esperado. Reduza temporariamente o limiar para testar a apresentação.
O número não é atualizado de imediato
É o efeito da cache. Aguarde o fim do período configurado, ou grave as definições para forçar uma limpeza imediata da cache.
O contador parece demasiado baixo
Se a opção «apenas carrinhos ativos» estiver ativa e a janela temporal for curta, só são contados os carrinhos recentes e ainda não encomendados. Alargue a janela temporal ou desative a opção para uma contagem mais inclusiva.