# Módulo Produtos em Tendência e Pesquisas Populares: guia completo > Apresentação O DF Trending acrescenta à sua loja PrestaShop 8 ou 9 um widget de tendências composto por três secções independentes: as pesquisas populares do momento (nuvem de etiquetas clicáveis),… - Página: - Idioma: pt - Atualizado em: 2026-09-09 - Outros idiomas: [fr](https://www.datafirefly.com/documentation/dftrending/index.md), [en](https://www.datafirefly.com/en/documentation/dftrending/index.md), [es](https://www.datafirefly.com/es/documentation/dftrending/index.md), [de](https://www.datafirefly.com/de/documentation/dftrending/index.md), [it](https://www.datafirefly.com/it/documentation/dftrending/index.md), [pl](https://www.datafirefly.com/pl/documentation/dftrending/index.md), [nl](https://www.datafirefly.com/nl/documentation/dftrending/index.md) - Índice: ## Apresentação O DF Trending acrescenta à sua loja PrestaShop 8 ou 9 um widget de tendências composto por três secções independentes: as **pesquisas populares** do momento (nuvem de etiquetas clicáveis), os **produtos em subida** (deteção por velocidade de vendas) e uma secção **«neste momento»** gerada automaticamente, que combina consultas de fichas de produto e vendas recentes. Um separador dedicado no back-office dá a leitura analítica destes três fluxos. ## Instalação 1. No back-office, abra **Módulos > Gestor de módulos** e clique em **Carregar um módulo**. 2. Selecione o arquivo `dftrending.zip` e confirme. 3. O módulo cria as suas tabelas de dados, os valores de configuração predefinidos e o separador **Estatísticas de tendências**, e liga-se automaticamente à página inicial. Sem dependências Composer nem framework externo: o arquivo é autónomo e funciona da mesma forma do PrestaShop 8.0 ao 9.x, em loja única ou em multiloja. ## Configuração Abra a configuração do módulo a partir do Gestor de módulos. Definições disponíveis: - **Mostrar as pesquisas populares**: ativa ou oculta a nuvem de etiquetas. - **Mostrar os produtos em subida**: ativa ou oculta a secção de velocidade. - **Mostrar a secção «neste momento»**: ativa ou oculta a secção combinada de visualizações e vendas. - **Número de pesquisas a mostrar**: dimensão da nuvem de etiquetas (8 por predefinição). - **Número de produtos em subida** e **número de produtos «neste momento»**: dimensão das duas grelhas de produtos (4 por predefinição). - **Janela analisada (dias)**: duração da janela recente comparada com a janela anterior de igual duração (7 dias por predefinição). - **Vendas mínimas para ser elegível**: limiar abaixo do qual um produto nunca é considerado em subida (2 por predefinição). - **Tempo de vida da cache (segundos)**: período durante o qual os cálculos de tendências são reutilizados sem nova consulta (3600 por predefinição). Cada gravação das definições limpa automaticamente a cache interna: os novos valores ficam visíveis de imediato no front-office. ## Funcionamento ### Pesquisas populares O módulo escuta o motor de pesquisa nativo do PrestaShop. Cada consulta é normalizada (minúsculas, espaços reduzidos, comprimento entre 2 e 64 caracteres) e depois agregada por dia, por idioma e por loja. A nuvem mostra as consultas mais frequentes na janela analisada; cada etiqueta remete para a respetiva página de resultados. Como a agregação é feita por idioma, a nuvem portuguesa só se enche com o tráfego da versão portuguesa da loja: numa loja recém-traduzida, conte alguns dias antes de a secção ter dados suficientes para aparecer. ### Produtos em subida As quantidades vendidas na janela recente são comparadas com as da janela anterior de igual duração. Só as encomendas válidas são contabilizadas. A pontuação de classificação pondera o crescimento pelo volume recente: um produto que passa de 50 para 90 vendas fica à frente de um produto que passa de 2 para 4. Os produtos inativos ou invisíveis ficam excluídos. ### Secção «neste momento» Cada ficha de produto consultada envia um sinal leve a partir do navegador, uma única vez por produto e por sessão. Esta contagem do lado do cliente mantém-se exata mesmo por trás de uma cache de página completa. A pontuação combina visualizações e vendas recentes (uma venda pesa cinco vezes mais do que uma visualização); os produtos já presentes na secção «em subida» são automaticamente removidos das duplicações. ## Colocação do widget Por predefinição, o widget aparece na página inicial (hook `displayHome`). O módulo implementa a interface de widget do PrestaShop: em **Aspeto > Posições**, pode ligá-lo a qualquer hook de apresentação do seu tema. Os produtos são apresentados com as miniaturas nativas do tema, numa grelha autónoma que não depende dos seus estilos. ## Painel do back-office O separador **Estatísticas de tendências** (em Módulos) apresenta três painéis: o topo das pesquisas a 30 dias com o respetivo número de ocorrências, os produtos em subida com vendas recentes, vendas anteriores e percentagem de crescimento, e os produtos mais consultados na janela analisada. Cada produto tem ligação direta para a sua ficha de edição. ## Dados e privacidade O módulo não guarda qualquer dado pessoal: nem identificador de cliente, nem endereço IP, nem cookie de seguimento. São armazenados apenas contadores diários anónimos (consulta + número, produto + número), e todos os dados com mais de 90 dias são eliminados automaticamente. ## Resolução de problemas - **O widget não mostra nada**: é normal numa loja sem histórico. Cada secção fica oculta enquanto não tiver dados relevantes. Confirme também que as secções estão ativas na configuração. - **Os produtos empilham-se na vertical**: limpe a cache do PrestaShop e force o recarregamento das folhas de estilo (Ctrl+F5) depois de uma atualização do módulo. - **As visualizações não são contadas**: confirme que nenhum bloqueador filtra o ficheiro `front.js` do módulo e que o controlador de front `track` responde corretamente (é esperada uma resposta JSON). ## Registo de versões - **1.0.2** (2026-07-12): versão inicial pública com pesquisas populares, velocidade de vendas, secção «neste momento», painel de estatísticas, cache interna e limpeza automática.