# Popularidade no Carrinho: documentação > Guia de instalação e configuração do módulo Popularidade no Carrinho: emblema de contagem de carrinhos na ficha de produto, limiar, janela temporal, cache e resolução de problemas. - Página: - Idioma: pt - Atualizado em: 2026-09-09 - Outros idiomas: [fr](https://www.datafirefly.com/documentation/popularite-panier/index.md), [en](https://www.datafirefly.com/en/documentation/popularite-panier/index.md), [es](https://www.datafirefly.com/es/documentation/popularite-panier/index.md), [de](https://www.datafirefly.com/de/documentation/popularite-panier/index.md), [it](https://www.datafirefly.com/it/documentation/popularite-panier/index.md), [pl](https://www.datafirefly.com/pl/documentation/popularite-panier/index.md), [nl](https://www.datafirefly.com/nl/documentation/popularite-panier/index.md) - Índice: 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. 1. No back-office, abra **Módulos > Gestor de módulos**. 2. Clique em **Carregar um módulo** e selecione o ficheiro `dfcartpopularity.zip`. 3. 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.