PS PrestaShop PrestaShop Iniciante

Live Search Inteligente: guia completo

Instalar, configurar e explorar o DFLiveSearch: pesquisa live, sugestões, sinónimos, tolerância a erros de escrita, relevância, estatísticas e alertas para PrestaShop 8 e 9.

Atualizado Versão do módulo 1.4.0

Apresentação e pré-requisitos

O DFLiveSearch substitui a pesquisa nativa do PrestaShop por um motor live em AJAX: um painel de resultados abre-se logo nos primeiros caracteres, com a imagem, o nome, o preço e os selos promocionais de cada produto. O módulo acrescenta também um motor de pesquisa inteligente (sinónimos, tolerância a erros de escrita, relevância ponderada), carrosséis de sugestões (pesquisas populares e produtos recomendados), um painel analítico completo e alertas por e-mail sobre as pesquisas sem resultado.

  • Compatível com PrestaShop 8.0 a 9.x, tema Classic e temas derivados.
  • PHP 8.1 e superior.
  • Multiloja e multilingue (FR/EN/ES/DE/IT).
  • Nenhum override de ficheiros: apenas hooks nativos.

O módulo assenta nos hooks displayHeader, displayTop, displaySearch, displayBackOfficeHeader e actionOrderStatusPostUpdate. Cria seis tabelas: dflivesearch_stats, dflivesearch_log, dflivesearch_alerts, dflivesearch_popular, dflivesearch_synonyms e dflivesearch_lexicon.

Instalação

Instale o módulo como qualquer módulo PrestaShop:

  1. Descarregue o arquivo dflivesearch.zip a partir da sua conta de cliente.
  2. No back-office, vá a Módulos > Gestor de módulos.
  3. Clique em Instalar um módulo e carregue o arquivo.
  4. Depois de instalado, clique em Configurar.

Na instalação, o módulo regista os seus hooks, cria as suas tabelas e pré-preenche um texto de sugestão (placeholder) traduzido nos cinco idiomas. Alguns grupos de sinónimos correntes são igualmente pré-preenchidos e o dicionário de correção de erros é construído a partir do seu catálogo. O campo de pesquisa live fica imediatamente ativo na sua loja.

Os grupos de sinónimos pré-preenchidos estão em francês, inglês, espanhol, alemão e italiano. Numa loja em português, preencha o separador de idioma pt do editor de sinónimos com os seus próprios grupos (por exemplo telemóvel, telefone, smartphone ou portátil, computador portátil, laptop), e traduza o placeholder e as cadeias do front-office em Internacional > Traduções.

Atualização

A atualização é feita normalmente a partir do Gestor de módulos. O script de upgrade integrado cria as novas tabelas, aplica os valores por defeito das novas opções (sinónimos, relevância, tolerância a erros, aparência da barra) sem tocar na sua configuração existente, e reconstrói depois o dicionário de correção. Não é necessária nenhuma ação manual. Depois da atualização, limpe a cache do PrestaShop e regenere os assets para purgar o JavaScript antigo.

Depois de uma importação de catálogo importante, lembre-se de reconstruir o dicionário de correção (ver a secção « Pesquisa inteligente ») para que a correção de erros reflita o seu catálogo atualizado.

Configuração geral

A página de configuração reúne as definições do comportamento da pesquisa:

  • Ativar o módulo: ativa ou desativa o campo de pesquisa live na loja.
  • Texto de sugestão (placeholder): texto apresentado no campo, traduzível por idioma.
  • Número mínimo de caracteres: limiar de ativação da pesquisa (2 por defeito).
  • Número máximo de produtos: limite de resultados apresentados no painel.
  • Pesquisas populares e pesquisas recentes: apresentação dos carrosséis de sugestões antes da escrita.
  • Preenchimento automático: sugestões de termos (produtos, categorias, pesquisas populares) durante a escrita, com navegação por teclado (setas cima/baixo, Enter, Esc) e realce do termo introduzido. O número máximo de sugestões é configurável.
  • Adição rápida ao carrinho e seletor de quantidade: opções que permitem adicionar um produto diretamente a partir dos resultados.
  • Produtos personalizados: tem em conta o histórico do cliente autenticado para as recomendações automáticas.

Aparência

A secção Aparência permite adaptar a pesquisa à sua identidade gráfica:

  • Cor principal: cor dos botões e dos destaques (por defeito #2196F3).
  • Cor principal (ao passar o rato): cor ao passar o rato nos botões (por defeito #1976D2).
  • Largura máxima da janela: largura máxima do painel de pesquisa. Aceita um valor CSS como 900px, 1200px ou 100%.
  • Tamanho da barra de pesquisa (desde a versão 1.4.0): Small, Medium ou Large. Ajusta a altura, o tamanho do texto e o do ícone da barra apresentada no seu cabeçalho.
  • Largura da barra de pesquisa: largura máxima da própria barra (400px, 50%, 30rem…). Deixe o campo vazio para ocupar toda a largura do contentor do tema.
  • Arredondamento dos cantos da barra: de 0 (cantos retos) a 50 px (forma de pílula).
  • Atalho de teclado: abre a pesquisa com Ctrl+K (Cmd+K no Mac) ou a tecla / a partir de qualquer sítio da página. Um badge indicativo (« Ctrl K » ou « ⌘K ») aparece na barra em desktop. A opção pode ser desativada.

Estes valores são injetados em CSS no front-office. Para uma barra em estilo « pílula » ao gosto do Algolia, escolha um arredondamento de 50 e um tamanho Large. Para uma janela de largura total em telemóvel e em desktop, introduza 100% na largura da janela.

Desde a versão 1.4.0, a janela de pesquisa é inteiramente acessível por teclado: a barra é focável e abre-se com Enter ou Espaço, o foco fica dentro da janela durante a navegação com Tab, Esc fecha a janela e o foco volta à barra. Um botão de limpeza aparece no campo assim que é introduzido texto, e as animações respeitam a preferência de sistema prefers-reduced-motion.

Produtos recomendados

Os produtos recomendados aparecem em carrossel logo à abertura do campo de pesquisa. Estão disponíveis dois modos através da definição Fonte dos produtos recomendados:

  • Automático: o módulo seleciona os mais vendidos (e tem em conta o histórico do cliente se a opção « Produtos personalizados » estiver ativada).
  • Manual: escolhe precisamente os produtos destacados.

Em modo manual, aparece um seletor dedicado: pesquise um produto por nome ou referência, clique para o acrescentar, e reorganize depois as miniaturas por arrastar e largar. A ordem definida é respeitada na apresentação do lado da loja.

Só os produtos ativos e visíveis são propostos no seletor. A ordem das miniaturas determina a ordem de aparição no carrossel.

Comportamento da pesquisa

Pesquisa por palavras

A pesquisa funciona por palavras: cada palavra introduzida deve ser encontrada (no nome, na referência, no código EAN ou na descrição curta), em qualquer ordem. Um pedido como « estetoscópio simples campânula » encontra portanto o produto mesmo que essas palavras não se sigam no nome. Desde a versão 1.2.0, cada palavra é também estendida aos seus sinónimos e a pesquisa cobre as referências de declinações (ver a secção « Pesquisa inteligente »).

Produtos com declinações

Para um produto com declinações, o botão de adição ao carrinho é substituído por um botão « Ver as opções » que remete para a ficha de produto, para que o cliente escolha a sua declinação antes da adição. Quando o cliente pesquisou a referência exata de uma declinação, esse botão leva diretamente à variante em causa.

Disponibilidade e stock

Os produtos esgotados continuam apresentados nos resultados e têm um selo « Esgotado ». Este selo não aparece para os produtos cuja encomenda sem stock é autorizada (definição « Aceitar encomendas » do PrestaShop): esses continuam a poder ser adicionados ao carrinho.

Se introduzir uma quantidade superior ao stock disponível de um produto não encomendável sem stock, o módulo não adiciona o produto e mostra uma mensagem a indicar a quantidade restante.

Pesquisa inteligente: sinónimos, erros de escrita e relevância

Desde a versão 1.2.0, o DFLiveSearch integra um motor de pesquisa inteligente. Todas estas definições encontram-se na secção Pesquisa inteligente da página de configuração.

Sinónimos

O dicionário de sinónimos liga termos equivalentes: um cliente que procure « tv » encontra também os produtos chamados « televisão » ou « televisor ». O editor é multilingue (um separador por idioma). Introduza um grupo por linha, com os termos separados por vírgulas:

tv, televisão, televisor
computador, pc, portátil, laptop
auscultadores, headphones, fones

Todos os termos de uma mesma linha são considerados equivalentes: procurar um deles estende automaticamente o pedido aos outros. Ative ou desative a funcionalidade através da opção Ativar os sinónimos. Alguns grupos correntes são pré-preenchidos na instalação; adapte-os ao seu catálogo.

Os sinónimos são guardados por loja e por idioma. Lembre-se de preencher cada separador de idioma para cobrir o conjunto da sua clientela.

Tolerância a erros de escrita

Quando uma pesquisa não devolve nenhum resultado, o módulo tenta automaticamente corrigir o erro a partir de um dicionário construído com base no seu catálogo (nomes de produtos, referências, categorias). Se a correção der resultados, são apresentados diretamente com a menção « Resultados para… » e uma ligação que permite voltar à escrita de origem.

  • Tolerância a erros de escrita: ativa ou desativa a correção automática.
  • Distância de correção máx.: número máximo de caracteres diferentes tolerado (1 a 3; 2 recomendado). Um valor mais elevado corrige mais erros mas aumenta o risco de falsos positivos.
  • Mostrar « Queria dizer? »: mostra a faixa de correção. Desativada, a correção aplica-se silenciosamente.

A correção assenta numa pré-seleção fonética (SOUNDEX) seguida de um cálculo de distância de Levenshtein: encontra por exemplo « televisor » a partir de « telivisor ». As palavras com menos de três caracteres não são corrigidas; as equivalências curtas (como « tv ») pertencem aos sinónimos.

O SOUNDEX foi concebido para o inglês e não modela bem os sons do português (nh, lh, ç, ã). A correção continua eficaz nos erros de digitação (letra trocada ou em falta), mas pode falhar em erros puramente fonéticos; nesses casos, um grupo de sinónimos é a solução mais fiável.

Dicionário de correção

O dicionário de correção (tabela dflivesearch_lexicon) é construído na instalação e pode depois ser reconstruído a qualquer momento através do botão Reconstruir o dicionário da página de configuração. A zona de informação mostra o número de palavras indexadas e a data da última reconstrução.

Reconstrua o dicionário depois de uma importação de catálogo importante ou de uma alteração massiva de nomes de produtos, para que a correção de erros reflita o seu catálogo atualizado. Pode também automatizar essa reconstrução através de uma tarefa agendada.

Relevância dos resultados

Os resultados são classificados por uma pontuação de relevância ponderada: correspondência exata do nome (pontuação mais elevada), nome que começa pelo pedido, pedido contido no nome, e depois referência e EAN. Dois boosts completam esta classificação:

  • Boost de produtos em stock: com relevância comparável, os produtos disponíveis sobem ao topo da lista.
  • Boost de mais vendidos: favorece os produtos mais vendidos, a partir das estatísticas de vendas do PrestaShop.

Estas duas opções podem ser ativadas de forma independente na secção Pesquisa inteligente.

Pesquisa por referência de declinação

A pesquisa cobre agora os identificadores próprios das declinações: referência, EAN, UPC e referência de fornecedor de cada variante. Escrever a referência ou o código de barras de uma declinação faz portanto subir o produto pai. Quando o pedido se assemelha a um código, o resultado aponta diretamente para a declinação certa (ligação para a variante exata) e o cartão mostra a referência e o preço dessa variante.

As referências puramente alfabéticas (sem algarismos) continuam encontráveis mas abrem a ficha na declinação por defeito. As referências que contêm algarismos (EAN, a maioria dos SKU) desencadeiam a ligação direta para a variante exata.

Painel e estatísticas

O módulo regista cada pesquisa (termo introduzido, número de resultados, eventual clique num produto, conversão em encomenda). O painel do back-office apresenta:

  • o total das pesquisas e o número de pesquisas únicas;
  • as taxas de sucesso, de clique e de conversão;
  • um gráfico de evolução das pesquisas por dia;
  • o top 20 das pesquisas com cliques e conversões;
  • o top 20 das pesquisas sem resultado;
  • uma exportação CSV do conjunto dos dados.

O acompanhamento das conversões é feito através do hook actionOrderStatusPostUpdate: uma encomenda feita depois de um clique nos resultados de pesquisa é contabilizada como convertida. Desde a versão 1.3.0, cada encomenda só é contabilizada uma vez, quaisquer que sejam as mudanças de estado posteriores.

Alertas por e-mail

O sistema de alerta vigia os termos que não devolvem nenhum resultado. Assim que um termo ultrapassa o limiar configurável (5 por defeito), é enviado um alerta por e-mail para o endereço à sua escolha e aparece uma notificação no cabeçalho do back-office. Cada alerta pode ser marcado como lido ou eliminado. Os modelos de e-mail são fornecidos nos cinco idiomas (FR/EN/ES/DE/IT) e o assunto é enviado no idioma por defeito da loja. Estas pesquisas sem resultado são uma fonte preciosa para detetar as lacunas do catálogo, os erros de escrita frequentes ou os sinónimos em falta a acrescentar.

Retenção dos dados

Os registos de pesquisa são conservados 90 dias por defeito (duração configurável). Um botão de limpeza manual está disponível no back-office, e desde a versão 1.3.0 aplica-se uma purga automática contínua segundo a duração de retenção configurada.

FAQ e resolução de problemas

Como configurar os sinónimos?

Na secção « Pesquisa inteligente » da configuração, introduza um grupo de sinónimos por linha (termos separados por vírgulas) no separador de cada idioma, e guarde. Verifique que a opção « Ativar os sinónimos » está ativa.

Como mudar o tamanho ou a forma da barra de pesquisa?

Na secção « Aparência », escolha o tamanho (Small / Medium / Large), a largura máxima e o arredondamento dos cantos da barra. Um arredondamento de 50 dá uma barra em forma de pílula. Estas definições dizem respeito apenas à barra apresentada no cabeçalho; a janela de resultados regula-se através de « Largura máxima da janela ».

Como desativar o atalho Ctrl+K?

Na secção « Aparência », passe a opção « Atalho de teclado » a Não. O badge desaparece da barra e as teclas Ctrl+K, Cmd+K e / deixam de desencadear a abertura da pesquisa.

Uma pesquisa com um erro devolve uma página vazia

Verifique que a opção « Tolerância a erros de escrita » está ativada e que o dicionário de correção contém palavras (zona de informação da configuração). Depois de uma importação importante, clique em « Reconstruir o dicionário ». Pode também aumentar a « Distância de correção máx. ».

A pesquisa não encontra uma referência de declinação

A pesquisa por referência de variante (ref., EAN, UPC, ref. de fornecedor) está disponível desde a versão 1.2.0. Atualize, limpe a cache e regenere os assets. Para obter a ligação direta para a variante exata, o pedido deve assemelhar-se a um código (conter pelo menos um algarismo).

A pesquisa não devolve nada para várias palavras

A pesquisa funciona por palavras independentes da ordem. Se acabou de atualizar, limpe a cache do PrestaShop e regenere os assets para carregar o novo JavaScript.

O painel de preenchimento automático oculta os resultados

O preenchimento automático fecha-se automaticamente quando o campo perde o foco ou com a tecla Esc. Certifique-se de que usa a última versão e limpe a cache se o comportamento antigo persistir.

Aparece um selo « esgotado » num produto encomendável

O módulo lê a definição « Aceitar encomendas » em Quantidades da ficha de produto (guardada do lado do StockAvailable no PrestaShop 8). Verifique essa definição: se autorizar a encomenda, não será apresentado nenhum selo.

O que acontece na desinstalação?

A desinstalação elimina de forma limpa os hooks, as variáveis de configuração e as seis tabelas do módulo. Não fica nenhum dado residual na base de dados.

Esta página foi útil?

Ainda com dúvidas? Contacte o suporte