PS PrestaShop PrestaShop Iniciante

Módulo Produtos em Tendência e Pesquisas Populares: guia completo

Instalação, configuração e funcionamento do widget de tendências: pesquisas populares, produtos em subida e secção «neste momento».

Atualizado Versão do módulo 1.0.2

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.
Esta página foi útil?

Ainda com dúvidas? Contacte o suporte