Módulo de Busca Visual (Sem SaaS): O mecanismo de busca inteligente auto-hospedado com a opção Meilisearch.

08/10/2026
v1.4.38

Ao digitar, os resultados aparecem acima, e não abaixo, da mensagem de boas-vindas.

Visto no iogenixdise (PS 8.2) ao pesquisar por "Isolate": com a consulta digitada, o painel continuou mostrando "Pesquisas Populares" e "Mais Vendidos", e os resultados, com a correspondência exata no topo, estavam a aproximadamente 1.580 px do topo.

Antes era uma corrida. Quando o painel abria, o servidor solicitava uma mensagem de boas-vindas e, se o cliente digitasse algo antes que ela chegasse, a resposta sobrepunha a mensagem de boas-vindas aos resultados. Agora, essa solicitação é cancelada assim que uma consulta é recebida e, se ela já estivesse em andamento, não seria sobreposta. Com a mensagem de boas-vindas intencionalmente atrasada em 4 segundos, os resultados agora têm 192px de largura e a primeira aba tem 236px de largura, sem o CSS do tema.

O bloco que contém sua mensagem, links e "Categorias Mais Encontradas", que só aparece com uma pesquisa, move-se de cima dos resultados (169 px) para trás deles.

Uma busca, uma solicitação

• Cada consulta foi enviada ao servidor duas vezes. rkrfreevisualsearch-nav.js envolto executarPesquisa com _origExecute(query).then ? _origExecute(query)…A verificação já havia iniciado a busca e a filial a iniciou novamente.
• Ao abrir o painel, apareceram 2 ou 4 pesquisas vazias. Um deles pediu "produtos em destaque" com somente em destaque, um parâmetro que o servidor nunca leu, e a resposta foi irrelevante: foi removido. Além disso, o tópico exige abrir() Com o foco e o clique na caixa, a segunda chamada repetiu a mensagem de boas-vindas e apagou o que estava escrito: agora não faz nada se o painel já estiver aberto.
• Os filtros, a ordem e o limite não cancelaram a pesquisa anterior. E duas respostas poderiam chegar em qualquer ordem. Agora, cada busca cancela a que está em andamento, e uma resposta antiga é descartada mesmo que chegue (incluindo respostas de "carregar mais" e de autocompletar).

O preenchimento automático demorou o mesmo tempo que uma página inteira.

autocomplete.php Eu estava ligando parent::initContent(), que no PrestaShop atribui variáveis de página e executa exibirCabeçalho com os hooks de todos os módulos da loja. No iogenixdise, levava 3,6 segundos por requisição, mesmo com o autocomplete desativado, porque a verificação vinha depois. Agora leva de 0,1 a 0,2 segundos (0,9 segundos na primeira vez). pesquisa.php Ele nunca fez isso. adicionarcarrinho.php Antes fazia a mesma coisa e também parou de fazer: adicionar ao carrinho a partir do painel, 0,17 s.

A faixa de preenchimento automático, com miniatura e sem ocultar nada.

Flutuou acima do painel (posição: absolutaAntes, abrangia as pesquisas populares e exibia apenas texto. Agora, está integrado ao fluxo, acima da coluna de resultados, em uma única linha que rola horizontalmente (~70px), e cada produto tem sua própria miniatura: o servidor já estava enviando URL da imagem. A entrada em uma sugestão marcada com setas não teve efeito (a lista lida estava sempre vazia) e agora ela a abre.

O mecanismo de busca levou segundos para encontrar lojas com histórico de pedidos.

Medido em maesalv9 (PS) 9.1.4, (1.083 produtos, 535.838 linhas de pedido):

• Fichas técnicas de produtos (ProvedorDeDadosDoProduto::obterProdutos): as unidades vendidas totalizaram detalhes_do_pedido + pedidos Cada solicitação leva aproximadamente 1 segundo por produto vendido. Ao abrir o mecanismo de busca (consulta vazia), os 12 "mais vendidos" levaram 9,8 segundos. Agora eles aparecem em rkrfreevisualsearch_index.total_sold, O indexador já calcula a mesma soma (os mesmos números); apenas os dados não indexados são calculados como antes. Consulta vazia: 10,1 s → 0,22 s; "cerâmica": 2,4 s → 0,4 s. As respostas são idênticas byte a byte.
• Preenchimento automáticoAnteriormente, os arquivos eram compilados para até 80 candidatos, exibindo 8, e então aqueles que não correspondiam eram descartados (1,7 segundos). Agora, o sistema filtra previamente usando nome, referência e EAN de uma consulta, e somente os seguintes são compilados: limite * 2 cartões. 2,2 s → 0,15–0,4 s, mesmas sugestões. No iogenixdise (PS 8.2, 346 produtos, 578.153 linhas de pedido), "Isolar" passa de 12 s para 0,3 s sem cache, e a consulta vazia de 5 s para 0,24 s. Busca aproximada (DIFUSO, limite 60) e CONSULTA_MAX_PRODUTOS=100 Eles não eram o gargalo: uma consulta sem resultados, que percorre o caminho difuso, leva 0,49 segundos.

Atualizar

upgrade-1.4.38.php é só ligar Media::clearCache()Com o "cache inteligente" de JS/CSS ativado, a loja ainda serviria o pacote agrupado antigo.

05/10/2026
v1.4.37

Uma única imagem ou banner de vídeo derrubou toda a loja no PrestaShop 9.2.

Com um banner de imagem ou vídeo ativo, a página inicial e as páginas de produtos do PrestaShop 9.2 apresentariam um erro fatal, e não apenas a função de busca: SmartyException: O modelo './_banner-overlay.tpl' não pode ser relativo a um modelo do tipo de recurso 'módulo'.. . _banner-media.tpl incluiu o texto do banner com um caminho relativo (./_banner-overlay.tpl), e o Smarty 9.2 não suporta mais caminhos relativos dentro de um modelo carregado como módulo:.

Agora incluído no seu roteiro completo (módulo:rkfreevisualsearch/views/templates/hook/_banner-overlay.tpl), assim como os demais modelos de front-end. Não é necessário fazer upgrade: é apenas o modelo. Reproduzido em 9.2.0 com a versão anterior e testado com a nova em 9.2.0, , 9.1.5, , 9.0.0, , 8.2.8 e 1.7.8.11 (Página inicial com um banner de imagem no topo e um banner de vídeo na lateral, e a página de resultados). O incluir As relações de back-office não mudam: esses modelos são carregados via caminho de arquivo e também funcionam em 9.2.

30/09/2026
v1.4.36

A chave Meilisearch "não foi salva".

Um cliente relatou o seguinte: a senha foi salva, mas a tela exibia uma mensagem contrária e o Meilisearch acabou sendo desligado. 1.4.33 A chave salva não é mais enviada para o navegador — o campo sempre aparece vazio — e o JavaScript da tela continua inferindo "nenhuma chave" a partir de um campo vazio: ao carregar, ele desabilita e bloqueia a opção e exibe "A chave da API é necessária". Como uma caixa de seleção desabilitada não é enviada, a próxima caixa de seleção salva envia a chave. 0 do campo oculto e Meilisearch desativado. E se fosse forçado, o PHP rejeitaria a gravação pelo mesmo motivo, pois também estaria analisando apenas o campo.

Agora o modelo indica se existe uma chave salva (conjunto de chaves de dadosO JavaScript leva isso em consideração, enquanto o PHP só exige a chave se o campo estiver vazio. e Nenhum salvo. Reproduzido em 9.2.0 Na versão anterior e também na nova: ao salvar com uma senha, recarregar e salvar novamente sem digitá-la, o Meilisearch permanece ativado e a senha intacta.

28/09/2026
v1.4.33

Limpeza. Nenhuma alteração de funcionalidade para o comerciante; o que muda é o que o módulo faz internamente e o que é transmitido dentro do pacote.

Cada ação de "adicionar ao carrinho" envia uma solicitação HTTP do servidor para si mesmo.

Ao adicionar um produto a partir do mecanismo de busca, o controlador solicitou o HTML do mini-carrinho via cURL. para a própria loja, Com um atraso de dois segundos, dentro do processo de compra. Foi inútil: apontava para o módulo. carrinho de blocos, que Isso não existe desde o PrestaShop 1.7. —o bloco de carrinho nativo é ps_carrinho_de_compras—, então a solicitação retornou um erro 404 e o HTML sempre chegava vazio. Medido em 8.2.8: HTTP 404 e 47 bytes.

O que custou caro foi o tempo. Em uma loja que não consegue se acessar devido ao seu domínio público — com Cloudflare no caminho, DNS de horizonte dividido, um balanceador de carga ou um certificado que o cURL não valida — eram dois segundos inteiros a cada clique, bem na tela onde o cliente decide.

O navegador, que gerencia a sessão do comprador, já cuidava da atualização: os dois arquivos JavaScript foram colocados em seus próprios diretórios. buscar Quando esse HTML vem vazio, o que sempre acontece, nada se perde ao removê-lo.

Também mediu o quê? Não Para não entrar em muitos detalhes: essa solicitação não gerou visitantes falsos nas estatísticas. Antes e depois de cinco chamadas, ps_convidado e ps_conexões Eles continuam presos nos números 416 e 446.

Código que ninguém estava executando.

• 176 linhas de JavaScript do indexador (de 530 a 354). Duas telas inteiras — reindexadas com barra de progresso e atualização de estatísticas — foram coladas em onze identificadores que nenhum modelo de módulo define, verificadas uma a uma. Com elas vão suas três assistentes, que ninguém mais chamou, e as onze regras CSS daquela barra de progresso.
• 49 linhas do Controlador GeralCópias de dois hooks do módulo e uma segunda implementação da fila de reindexação. Estes são métodos. ganchoXxx() dentro de um controlador, e o PrestaShop envia os hooks para módulos, Portanto, eles nunca foram executados. A prova de que estavam mortos há algum tempo é que esta cópia ainda estava olhando. _PS_MODE_IMPORT_, a constante que o 1.4.32 O problema já foi corrigido no próprio hook. As implementações em produção no arquivo principal não foram alteradas; tampouco a fila usada pelo cron e pelo módulo.
• configuração/services.yaml, que ninguém leu: PrestaShop literalmente pesquisa services.yml, verificado em 1.7.8.11 e 8.2.8. E não podia simplesmente ser renomeado, porque ativá-lo teria tentado injetar automaticamente classes com dependências que não conseguia resolver. Com isso, desaparece a extensão Twig que existia apenas para registrar esse arquivo: o módulo sequer possui um modelo Twig.

Apresentação em seis idiomas

O que o comprador vê (os 141 rótulos no mecanismo de busca) agora também aparece em Francês, alemão, italiano e polonês, Além de inglês e espanhol. Anteriormente, em lojas nesses idiomas, a interface aparecia em inglês. O painel administrativo do módulo permanece em inglês e espanhol.

E três textos que escaparam à tradução em qualquer idioma: «Acesse…» estava escrito em espanhol no JavaScript, e o contador «N resultados» e seu rótulo de acessibilidade, em inglês.

Multiloja: categorias repetidas com o nome de outra loja.

Seis consultas unidas categoria_lang Sem filtrar por loja. Em uma loja com várias lojas, cada categoria apareceu apenas uma vez. por loja Nos atalhos dos resultados e com o nome daquele que foi selecionado: na loja de teste polonesa, apareceram tanto "Tonery" quanto "Tóner". Isso afetou os atalhos, as "categorias mais encontradas", as facetas e o nome da categoria de cada anúncio.

As pesquisas populares que foram definidas manualmente nunca apareceram.

As entradas adicionadas pelo comerciante em Importar/Exportar contam como zero buscas, e a lista foi ordenada por volume de buscas antes de ser truncada no limite: assim que as estatísticas mostraram alguma coisa, as entradas manuais foram descartadas sem aviso prévio. Elas vêm primeiro, em ordem.

O validador de complementos estava interpretando o nome do módulo incorretamente.

Eu o registrei como «Rekire Busca visual gratuita - Inteligente SearchModules.Rkfreevisualsearch.Admin»: extrai o nome combinando todas as letras na atribuição de $this->nome de exibição, A chamada de tradução estava usando o nome de domínio literalmente. O nome de domínio agora é uma constante. Confirmado pelo upload do arquivo ZIP: a submissão 3767735 agora usa o nome correto, com 0 erros e 0 avisos.

As capturas de tela no guia mostravam nosso laboratório.

Três das dezoito imagens no guia continham nomes do nosso ambiente de teste: um host Meilisearch e um nome de índice em uma delas, e um domínio local no URL de exemplo nas outras duas. Esses não são credenciais nem dados de ninguém — são nomes de máquinas locais —, mas estão incluídos no pacote que o cliente compra e são completamente irrelevantes. Eles foram substituídos por valores neutros.

08/09/2026
v1.4.14

• Novo Guia do usuário no painel administrativo, em espanhol e inglês, com capturas de tela e ajuda em cada tela.
• Corrigido A ativação do Meilisearch não permitirá mais que sua loja fique sem serviço caso seu servidor esteja inativo ou desatualizado.
• Corrigido Os links do banner, a mensagem de boas-vindas, os designs escuros e os pesos para várias lojas foram corrigidos.
• Segurança Correção de segurança, chaves de API salvas criptografadas e todas as bibliotecas dentro do módulo, sem CDN externo.

01/09/2026
v1.4.13

• Corrigido O filtro de preço permite, mais uma vez, filtrar pelo menor preço.

26/08/2026
v1.4.12

• Corrigido As cores configuradas são aplicadas ao botão do carrinho de compras e à janela de combinações.

23/07/2026
v1.4.8

• Novo Os banners suportam imagens, vídeos ou produtos e podem ser gerados usando inteligência artificial.
• Novo Campanhas de e-mail para aqueles que pesquisaram um termo, com o consentimento deles registrado na primeira vez que pesquisaram.
• Corrigido A janela e as permissões para toda a página foram corrigidas, assim como um erro no editor de texto.

11/07/2026
v1.3.7

• Melhorou Busca mais refinada, mesmo quando o nome do produto contém números.
• Novo Opção para alternar para o mecanismo de busca do PrestaShop pressionando Enter ou o ícone de lupa.
• Novo Novo modo de apresentação Clássico, sem sobreposição em tela cheia, e um modo de página inteira totalmente funcional.
• Melhorou A melhor opção entre rolagem infinita e paginação.

13/06/2026
v1.2.33

• Corrigido Corrigida a atualização do índice ao salvar um produto.

11/04/2026
v1.2.8

• Corrigido Filtros corrigidos e aprimorados.

10/04/2026
v1.2.7

• Melhorou Módulo totalmente traduzido para o inglês, com todos os textos traduzíveis.
• Melhorou Pequenos retoques visuais no escritório e na loja.
• Segurança Melhorias de segurança.

09/04/2026
v1.2.5

• Novo Cor de fundo configurável para rótulos de pesquisa preditiva.
• Melhorou Ajustes de cor e tamanho.

v1.2.42026/04/07

• Novo A seção "Você também pode se interessar por" apresenta produtos sugeridos quando há poucos resultados.
• Melhorou Busca aproximada aprimorada com o mecanismo MySQL e melhorias visuais.

05/04/2026
v1.1.0

• Novo Banners programáveis na parte superior ou lateral do mecanismo de busca.
• Novo Opção para excluir marcas da pesquisa.
• Melhorou Aviso sobre produtos fora de estoque que ainda podem ser adquiridos.
• Melhorou Melhorias visuais e correções menores.

30/03/2026
v1.0.27

• Novo Produtos novos ou editados são reindexados automaticamente.
• Novo Preço com ou sem impostos, à sua escolha.

29/03/2026
v1.0.25

• Novo Exclusão de categorias e características na pesquisa.
• Novo Indexação automática por tarefa agendada, que detecta produtos não indexados e sincroniza o Meilisearch.
• Melhorou Pré-carregamento automático dos termos mais pesquisados e estatísticas aprimoradas.
• Melhorou Refinamento da busca aproximada, que ignora termos excessivamente curtos, e melhor apresentação em telas 2K e 4K.

26/03/2026
v1.0.24

• Melhorou Melhorias visuais e correções de erros.

19/03/2026
v1.0.23

• Novo Lançamento do módulo.