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

12/11/2026
v1.5.4

• Um produto que estava fora de estoque e tinha a opção "Permitir pedidos" ativada aparecia nos resultados da busca como esgotado e sem botão de compra, mesmo que pudesse ser comprado na página do produto. O mecanismo de busca estava lendo essa opção de uma fonte que a página de produtos do PrestaShop 8 e 9 não atualiza mais. Agora, ele lê da mesma fonte que a página do produto, e o mesmo se aplica a itens com a opção "Ocultar fora de estoque" e ao índice Meilisearch.
• Com o gerenciamento de estoque desativado na loja, todos os produtos podem ser encomendados, assim como na página do produto.

v1.5.32026/11/11

• Os preços exibidos nos mecanismos de busca agora refletem a alíquota de IVA do grupo de clientes, assim como na página do produto e nos anúncios do PrestaShop. Um grupo configurado para exibir preços sem impostos (por exemplo, o grupo de profissionais) estava vendo preços com impostos incluídos nos resultados de busca. Agora, os preços estão consistentes em todas as páginas de produtos, no filtro de preços e no seletor de combinação.
• A opção "Mostrar preços com impostos" funciona da seguinte forma: quando ativada, ela acompanha o grupo de cada cliente; quando desativada, ela sempre exclui os impostos.

v1.5.22026/11/11

• Finalização de compra rápida: a quantidade e o botão de adicionar estão em uma única linha, com um único ícone, como nas listas da maioria dos temas. Mesmo quando o produto já está no carrinho, ele ainda exibe "− N +".
• A cor de destaque do botão costumava ser vermelho puro sobre um fundo preto. Agora é cinza escuro; as lojas que não haviam alterado essa cor automaticamente passam a exibir o botão ao passar o cursor sobre ele durante a atualização, e a cor escolhida em Aparência é mantida.
• Filtro "Em promoção": um preço fixo sem desconto (como um preço para grupos de profissionais) não é mais considerado uma promoção. Em lojas com preços para grupos, esse filtro costumava marcar quase todo o catálogo. Agora, ele tem o mesmo peso que a etiqueta de desconto no cartão.

v1.5.12026/11/11

• Produtos ocultos dos visitantes por outro módulo deixam de aparecer nos resultados da pesquisa: não estão no menu suspenso, na página de resultados, nem nos produtos em destaque, e também não são incluídos no total de resultados ou nos filtros. O mecanismo de busca utiliza um gancho para fazer a pergunta. actionRkrFilterVisibleProductIds (recebe) IDs por referência e remove aqueles que não são visíveis); é usado, por exemplo, pela RKR Private Products para mostrar determinados produtos apenas a uma lista de clientes.
• O botão "Adicionar" do mecanismo de busca rejeita esses produtos, mesmo que o ID seja enviado manualmente.
• Com esse módulo instalado, o cache de resultados é salvo por cliente: o que um cliente vê na lista não é exibido para outro visitante, e vice-versa.

v1.5.02026/11/11

Para lojas cujos clientes fazem compras diretamente pelo mecanismo de busca. As novas opções estão localizadas em Aparência, na seção "Comprar pelo mecanismo de busca".

• Ofertas visíveis: Produtos com desconto exibem uma etiqueta "-20%" (ou "-€5,00" se o desconto for um valor fixo) acima da foto, juntamente com o preço anterior riscado, conforme mostrado nos detalhes do produto. Produtos que possuem apenas a etiqueta "Em promoção" do PrestaShop exibem "Em promoção!". Preços específicos e regras de catálogo aplicáveis ao cliente são considerados; o desconto para o seu grupo de produtos não é, pois se trata do preço normal. Este indicador é ativado após a atualização (está desativado em "Desconto e preço anterior").
• O filtro "Em promoção" no painel de filtros do mecanismo de busca e na página de resultados mostra o número de produtos com desconto entre os encontrados. Ele só aparece se houver algum produto em promoção. A verificação é feita durante a busca, não durante a indexação; portanto, uma promoção que começa ou termina hoje é contabilizada sem reindexação. Ativado após a atualização.
• Finalização de Compra Rápida (desativada após atualização): A quantidade e o botão Adicionar estão sempre visíveis em cada produto, não apenas ao passar o cursor sobre ele. Assim que o produto é adicionado ao carrinho, o botão muda para "- quantidade +" com o número de unidades já presentes no carrinho: alterar o valor mantém essa quantidade no carrinho (digitar 12 mantém 12 unidades, não adiciona 12), e alterar para 0 remove a quantidade. Se o carrinho for atualizado pelo cabeçalho, a opção de compra rápida também será atualizada. Isso se aplica a produtos sem opções de combinação; os demais ainda exibem "Escolher opção".
• O estoque é indicado por um semáforo (desligado quando atualizado): um ponto verde indica que há estoque, um ponto amarelo indica poucas unidades ("Últimas unidades") e um ponto vermelho indica que o estoque está esgotado. "Poucas" significa abaixo da quantidade definida em "Poucas unidades a partir de" ou, se definido como 0, abaixo da configuração do PrestaShop "Mostrar quantidades restantes quando menos de".
• Corrigido: A opção "Adicionar" exibia "Adicionado ao carrinho" mesmo que a loja não tivesse adicionado o item ao carrinho (outro módulo removia essa informação imediatamente). Agora, o usuário é notificado de que o item não pôde ser adicionado ao carrinho.
• Corrigido: Com o modo de depuração ativado, as notificações de outros módulos apareciam antes da resposta do carrinho e o botão exibia um erro de conexão. Nenhuma ação é necessária durante as atualizações: o cache de pesquisa é limpo automaticamente.

v1.4.642026/11/11

• Corrigido: Na página de resultados da pesquisa, a configuração de aparência "Mostrar preço" não estava sendo respeitada e o preço era sempre exibido. A caixa de pesquisa suspensa, no entanto, respeitava essa configuração. Os grupos de clientes sem permissão para visualizar preços já foram contemplados na seção de correção. 1.4.58, Em ambas as visualizações. Nenhuma ação é necessária ao atualizar.

10/11/2026
v1.4.63

• Nome completo do produto ao passar o cursor: Se o nome não couber no cartão e estiver cortado por "...", ao passar o cursor sobre ele, um balão com o nome completo será exibido na parte inferior da imagem. Ele não cobre o preço nem move a grade. Este recurso está disponível apenas em computadores (não há função "passar o cursor" em dispositivos móveis). Em lojas de calçados, por exemplo, o modelo e a cor não cabiam em duas linhas.
• Nos estilos Clean e Superclean, o nome ocupa até 3 linhas (antes eram 2): sem uma moldura ao redor do produto, o fato de alguns nomes ocuparem uma linha extra não é perceptível e, portanto, muito menos nomes são cortados, inclusive em dispositivos móveis.
• Corrigido: Nas sugestões acima, o texto completo exibido ao passar o cursor sobre o nome mostrava "&" em vez de "&" para nomes que continham esse símbolo. Nenhuma ação é necessária após a atualização.

09/11/2026
v1.4.62

• Corrigido: Produtos fora de estoque que podem ser encomendados ("Disponível sob encomenda": o produto, ou a loja, aceita encomendas de itens não disponíveis em estoque) anteriormente possuíam um botão "Verificar" e, ao clicar nele, era exibido um erro de "Estoque insuficiente" sem adicionar nada ao estoque. Agora, eles possuem um botão "Adicionar" e são adicionados conforme descrito nos detalhes do produto. Isso é particularmente relevante para lojas que vendem muitos itens feitos sob encomenda (como visto em...). lacasadelassetas.comEm 912 de 1.519 produtos, o botão não funcionou em mais da metade do catálogo.
• Corrigido: Na janela "Escolher opção", uma variante que estava fora de estoque, mas disponível para encomenda, aparecia como "Fora de estoque" e não podia ser adicionada. Agora, ela aparece como "Disponível sob encomenda" e pode ser adicionada.
• O botão flutuante "Filtros" do celular pode ser personalizado com a cor da loja: leia --rkfvs-filter-toggle-bg e --rkfvs-filter-toggle-text (Por padrão, como antes: a cor principal e o texto branco). Anteriormente, a cor era fixa e não havia CSS para alterá-la.

09/11/2026
v1.4.61

• Nova opção "Lembrar pesquisa ao voltar" (Geral). Se um cliente selecionar um produto na barra de pesquisa e retornar usando o botão Voltar, o painel será reaberto exatamente como estava: os mesmos resultados de pesquisa, filtros, ordem de classificação, produtos já carregados e posicionados no mesmo nível do produto visualizado. Anteriormente, o cliente retornava à página com o painel fechado e precisava pesquisar novamente. Se o cliente fechar o painel manualmente, ele não será reaberto ao retornar. Esta opção está desativada por padrão após a atualização; para ativá-la, acesse Configurações > Geral.

07/11/2026
v1.4.60

• Uma única letra junto com outras palavras conta: "vitamina C" prioriza as vitaminas do complexo C (anteriormente, pesquisar apenas por "vitamina" retornaria D3, B12, etc.). O mesmo se aplica a "vitamina E", "vitamina K" e assim por diante. A letra deve fazer parte de uma palavra completa no nome: "C" não corresponde a "complexo". Uma única letra ainda não é pesquisada. Nenhuma ação é necessária durante a atualização.

07/11/2026
v1.4.59

• O status do estoque ("Em estoque", "Disponível sob encomenda", "Sem estoque") reaparece nos cartões do painel para grupos que não visualizam os preços. 1.4.58, Ocultar o preço por grupo também significava obter a etiqueta de estoque.
• Estilos "Clean" e "Superclean": o bloco de filtros fica muito mais compacto, tanto no painel quanto na página de resultados (cada filtro fechado ocupa metade da altura). Nenhuma ação é necessária após a atualização.

07/11/2026
v1.4.58

Preços apenas para quem puder vê-los.

• O mecanismo de busca respeita a configuração "Mostrar preços" para grupos de clientes (Clientes > Grupos). Em uma loja B2B com o grupo Visitante (sem preços), o painel de resultados e a página exibiam o preço e o botão "Adicionar ao carrinho". Agora, para esses grupos, nem o preço, nem o filtro ou a ordenação por preço, nem o botão do carrinho aparecem, e o recurso de carrinho do mecanismo de busca rejeita a solicitação.
• O cache de resultados é armazenado por grupo de clientes e moeda: não apresenta mais preços de um grupo para outro.

A primeira carta não está mais perdida.

• Ao tocar na caixa de pesquisa do tema e digitar imediatamente, a primeira letra permanecerá nessa caixa ("proteína" pesquisou por "roteína"). O foco muda para a caixa de pesquisa do painel com o mesmo toque e, se algo aparecer na caixa de pesquisa do tema, será trazido para o painel. Nenhuma ação é necessária ao atualizar.

05/11/2026
v1.4.57

Erro de JavaScript ao adicionar um formulário à página

• Se outro módulo ou tema adicionasse um formulário à página com um campo chamado eu ia, o console exibiu node.id.startsWith não é uma função, E o mecanismo de busca parou de remover o preenchimento automático nativo que aparecia com esse formulário. Nenhuma ação é necessária após a atualização.

04/11/2026
v1.4.56

Validador de complementos do PrestaShop pronto para uso

Revisão de código sem novas funcionalidades. Nenhuma ação adicional é necessária durante a atualização.

• O aviso sobre idiomas não indexados nunca apareceu: sua consulta continha um LIMITE Demais. Com o modo de depuração ativo, esse erro de SQL quebrou as telas do módulo que o exibia. Ele vem do 1.4.39.
• A ordenação dos resultados utiliza a linguagem e o armazenamento da pesquisa atual, e não os do contexto global. Isso é perceptível na tarefa de aquecimento do cache, que itera por todas as linguagens e armazenamentos: agora, cada uma é ordenada por seus sinônimos e pesos.
• O aviso sobre idiomas não indexados vem de um modelo, não do PHP.
• Os exemplos neste registro e os comentários no código não mencionam mais lojas específicas.

04/11/2026
v1.4.55

Multiloja: cada loja é pesquisada usando seu próprio texto.

Se um produto tivesse um nome diferente em duas lojas diferentes, o mecanismo de busca usaria o nome e a descrição da loja com o nome da última para todas elas: renomeá-lo em uma loja impediria que ele aparecesse nessa loja, e o mesmo se aplicava aos nomes das categorias. Agora, cada loja tem seu próprio índice de texto, com seus próprios pesos e características de exclusão, independentemente de qual loja tenha salvo o produto.

Isso também corrige o que dependia do armazenamento de onde o arquivo foi salvo:

• Desativar ou ocultar um produto em uma loja costumava removê-lo dos resultados de busca em todas as lojas. Agora, ele aparece apenas naquela loja específica.
• Um produto salvo de uma loja onde não está disponível desapareceria do mecanismo de busca das lojas onde estava disponível.
• A disponibilidade é calculada com base no estoque de cada loja. Como o estoque é compartilhado entre as lojas, os produtos foram indexados como indisponíveis em todas elas.
• A reconstrução do índice inclui produtos de todas as lojas, não apenas da loja de onde a atualização foi iniciada. Após a atualização, em uma configuração com várias lojas, os produtos são reindexados automaticamente em lotes usando o cron. Se você não usa o cron, clique em "Reconstruir Índice". Com uma única loja, nenhuma ação é necessária e nenhuma linha do índice será alterada.

A mesma ordem em cada busca

Produtos com a mesma classificação podiam ter sua ordem alterada entre duas buscas idênticas, e um produto podia aparecer repetido ou ausente ao navegar pela página. Agora, em caso de empate, o produto mais recente aparece primeiro.

04/11/2026
v1.4.54

Salvar um produto sem alterações não sobrescreve mais o índice.

Um conector para o sistema ERP costumava armazenar milhares de produtos mesmo quando nada havia sido alterado, e cada salvamento apagava e reinseriava todas as linhas do produto no índice de pesquisa. Agora, o mecanismo de busca salva um único registro de cada produto e, se nada tiver sido alterado, não grava nada. A tabela de índice para de crescer e o salvamento é muito mais rápido.

Quando algo muda, apenas a diferença é registrada: renomear um produto afeta duas ou três palavras, não centenas de linhas. Se apenas as vendas ou o estoque mudarem, essas colunas serão atualizadas. Após a atualização, a reindexação é desnecessária: na primeira vez que cada produto é salvo, ele é comparado com o que já está no índice.

As pesquisas salvas param de ser apagadas sem motivo aparente.

Antes, o cache de pesquisa era limpo sempre que um produto, categoria ou fabricante era salvo, e também sempre que um módulo limpava um de seus modelos, o que muitos sliders de temas fazem ao salvar um produto. Agora, ele só é limpo se algo mudou e afeta os resultados: texto, preço, categorias, fabricante, combinações, características ou se o produto estiver disponível para compra. O botão "Limpar cache" no painel administrativo também o limpa, o que não acontecia antes.

A fila de reindexação não perde produtos.

Produtos que não estavam indexados (importações, grandes lotes) costumavam aguardar em uma lista de 500 itens, que, quando cheia, pulava os mais antigos, mantendo-os com o índice antigo. Agora, eles estão em sua própria tabela, sem limite, e a tarefa agendada avança com base no tempo (25 segundos por execução) em vez de um limite fixo de 100 produtos. Ao concluir, o cache é limpo caso algo tenha sido alterado e as alterações são enviadas para o Meilisearch.

Pesquisas com várias palavras mais rápidas

O peso de cada palavra contabilizava os produtos no índice para cada busca com duas ou mais palavras, mesmo quando os dados eram servidos do cache. Agora, esse total vem de uma consulta direta: em um catálogo de 10.000 produtos, representa a diferença entre segundos e milissegundos quando o banco de dados está com pouca memória.

28/10/2026
v1.4.53

Página de resultados para dispositivos móveis

Em telas menores que 768px, os filtros não aparecem mais ao lado dos produtos em um espaço fixo de 280px (impedindo que a lista seja comprimida em todos os estilos). Agora, eles aparecem na parte superior, ocultos por um botão "Filtros" que os abre e fecha; eles permanecem abertos quando um filtro é aplicado e os produtos são exibidos dois a dois. Nada muda na versão para desktop.

28/10/2026
v1.4.52

Estilos "Clean" e "Superclean" para resultados

Dois novos estilos em Aparência → Predefinições de Design Rápido, para o painel de pesquisa e para a página de resultados:

• LimparTudo é branco, sem borda ao redor de cada produto. A foto, juntamente com o nome e o preço, aparece sobre um fundo cinza muito claro. Ao passar o cursor sobre a foto, ela fica levemente desfocada e o nome é sublinhado, sem espaços ou sombras. Os filtros não têm mais suas caixas e são separados por uma linha fina. No painel, o botão que aparece ao passar o cursor agora está na parte inferior da foto e não cobre mais o preço.
• SuperlimpoO mesmo se aplica, mas sem banners ou mensagem de boas-vindas, e sem o esquema de cores da loja: rótulos, botões, barras de preço e linhas separadoras (filtros, "Correspondência Exata") são todos alterados para preto e cinza claro. As lojas que já utilizam um estilo diferente permanecem inalteradas.

28/10/2026
v1.4.51

Com várias palavras, a mais específica dá as ordens.

Ao pesquisar por duas palavras, uma muito comum em nomes de catálogo e a outra incomum ("camiseta de algodão" em uma loja onde quase tudo é camiseta), os produtos que continham apenas a palavra comum tinham uma classificação superior aos que continham a palavra incomum, simplesmente porque começavam com a primeira palavra. Agora, cada palavra é ponderada de acordo com a quantidade de nomes de produtos em que aparece: a palavra incomum tem mais peso do que a comum. Produtos com ambas as palavras ainda têm uma classificação superior. Não há necessidade de renomear os produtos.

Palavras vazias ("com", "para", "de", "o", "com"...) não têm peso e, sozinhas, não colocam um produto nos resultados: um produto com "(com brinde)" no nome deixa de aparecer por causa disso, e uma busca como "camiseta com gola" deixa de retornar metade do catálogo.

Janela de variantes sem barra horizontal e sem nomes repetidos.

• O nome de cada variante costumava aparecer uma vez para cada imagem na combinação ("Cor: Vermelho / Cor: Vermelho / Cor: Vermelho…"). Agora, ele aparece apenas uma vez, com o que distingue a variante: o valor, sem o nome do grupo e sem os grupos que têm o mesmo valor em todas elas ("Vermelho" e não "Cor: Vermelho / Tamanho: Tamanho Único").
• Na versão mobile, a janela tinha uma barra de rolagem horizontal: o nome aparecia em uma única linha. Agora, ele ocupa duas linhas, e a quantidade e o botão "Adicionar" ficam abaixo, de forma que cada linha se ajusta à largura da página. A atualização remove o CSS/JS combinado do armazenamento e do cache de busca.

28/10/2026
v1.4.50

Os cartões respeitam as indicações "Mostrar preço" e "Disponível para encomenda".

Um produto com a opção "Mostrar preço" desativada aparecia nos resultados da busca por €0,00, com a indicação "Disponível sob encomenda" e um botão "Adicionar ao carrinho": o que uma loja simplesmente quer exibir (um catálogo de máquinas, um produto personalizado) parecia um presente e podia ser comprado. Agora, o cartão se comporta como uma página de produto do PrestaShop: sem a opção "Mostrar preço" (ou no modo catálogo sem preços), ele não exibe preço, nível de estoque ou botão de compra; sem a opção "Disponível sob encomenda", ele exibe o preço, mas não o nível de estoque ou o botão.

Preço 0: "Solicitar preço e disponibilidade"

Um produto com preço 0 exibe texto em vez de €0,00, sem etiqueta de estoque ou botão de compra. O texto pode ser configurado por idioma em Aparência → Detalhes do Cartão.

A etiqueta de estoque não cobre mais o preço.

Antes, a etiqueta subia 25 pixels para se posicionar ao lado do preço, e um texto longo ("Disponível sob encomenda") a encobria. Agora, preço e estoque estão alinhados, e se não houver espaço suficiente, a etiqueta se move para baixo.

Uma funcionalidade com o nome, que é pesquisada como referência.

Em Aparência → Detalhes do Cartão, você seleciona uma característica (por exemplo, o fabricante ou a referência OEM) que o cartão exibe abaixo do nome (no máximo duas linhas). Seus valores também são indexados com códigos de referência e representados como "Ref:": a busca por um desses códigos exibe o produto em primeiro lugar. É necessário reindexar após selecioná-lo.

Digite o rótulo por recurso

Você escolhe uma funcionalidade e um ou mais de seus valores (por exemplo, Família = Máquina). Seus produtos exibirão o valor como um rótulo acima do nome e, em vez de um botão de compra, um rótulo direcionará para a página do produto com o texto configurado ("Ver produtos compatíveis" se deixado em branco).

"Acesse…": primeiro, a categoria que tem o mesmo nome do que você está procurando.

Antigamente, as categorias eram determinadas pela profundidade e posição: um código de modelo revelaria mais facilmente categorias que o continham dentro de outra palavra ("MX2000", "FMX200S") do que aquelas que o continham por inteiro ("Office MX200"). Agora, a similaridade do nome é fundamental: mesmo nome, palavra inteira, começa com, contém.

O modelo desejado é lançado antes de seus consumíveis.

A busca por um código de modelo retornaria uma correspondência exata para um produto cujo nome começasse com esse código seguido por outro número ("MX2000" para "MX200"). E o produto com esse nome ("Office MX200") teria a mesma pontuação que as centenas de consumíveis "para Office MX200..." e, tudo o mais sendo igual, os números de vendas prevaleceriam, o que um produto de catálogo não possui. Agora, adicionar outro número significa que não é mais o mesmo código, e um nome curto terminando com o código pesquisado vem primeiro.

A atualização limpa o cache de pesquisa, que armazenava os cartões com o preço antigo.

26/10/2026
v1.4.49

A lupa do mecanismo de busca não está mais oculta para leitores de tela.

Ao converter a lupa de pesquisa de temas em um botão (com foco, role="botão" e seu aria-rótulo), o módulo saiu do aria-hidden="true" que vem com o modelo ps_searchbar. Um elemento que recebe foco não pode ser ocultado: o Lighthouse o marcou como "Os elementos [aria-hidden=true] "Eles contêm elementos descendentes selecionáveis", e a pontuação de acessibilidade diminuiria. Agora, esse atributo é removido na conversão. Apenas o JS é alterado; não há nada para atualizar no banco de dados.

21/10/2026
v1.4.48

Descubra o que está escrito de ouvido.

Uma palavra com erro ortográfico que não esteja no índice também é pesquisada por sua sonoridade em espanhol: "kolageno" encontra "collagen", "proteyna" encontra "protein", "kafeina" encontra "caffeine" e "bitamine" encontra "vitamin". Anteriormente, o sistema caía na armadilha da busca aproximada, que aceitava palavras de descrições que apenas se assemelhavam em letras ("oxigeno" para "kolageno") e preenchia os resultados com produtos não relacionados.

Regras: h é mudo; w e hu têm o mesmo som; k, c e qu também têm o mesmo som; ce, ci e z; ge, gi e j; b e v; y e i; letras duplas contam como uma só, e a vogal final não importa. Uma palavra escrita corretamente é pesquisada exatamente como está, então o que já funcionou não muda. Sinônimos da palavra encontrada também contam ("kolageno" → "colageno" → "collagen").

Uma pesquisa sem resultados não é preenchida com qualquer coisa.

O método de busca de último recurso comparava trechos de três letras a nomes: "biscoito" exibia produtos com "bis" no nome, seguidos por mais oito na mesma categoria. Agora, ele usa apenas variações quase completas da palavra; se nada corresponder, não há resultados e as buscas populares aparecem.

A atualização cria a tabela de chaves fonéticas e a preenche com as palavras que já estão no índice, sem reindexar, e limpa o cache de pesquisa.

21/10/2026
v1.4.47

Primeiro, vem uma referência completa do modelo.

Ao pesquisar uma referência de modelo usando letras e números ("et-14100", "ET 14100", "et14100"), os produtos que contêm essa sigla em seu nome podem ficar centenas de posições abaixo no ranking, por dois motivos:

• A parte menor continha centenas de produtos. Assim como o número curto no 1.4.46, Uma parte de uma ou duas letras ("et") corresponde como prefixo em rótulos e em qualquer outro modelo "ET-...". Agora, se a pesquisa tiver uma parte mais longa, um produto precisa corresponder pelo menos a essa parte.
• Os itens esgotados foram colocados no final da lista., ...mesmo atrás de "Você também pode gostar". Agora, eles estão no final do seu próprio bloco: uma correspondência exata fora de estoque ainda fica à frente de correspondências relacionadas. Além disso, uma referência de modelo que esteja completa no nome conta como uma correspondência exata, com ou sem hífen: "et14100" corresponde a "ET-14100", mas não a "ET-141000". A atualização limpa o cache de pesquisa.

20/10/2026
v1.4.46

Um número curto já não é suficiente para entrar nos resultados.

O 1.4.45 A contagem de números curtos isolados na ordenação foi interrompida, mas a consulta ainda incluía qualquer produto com esse número na descrição ou nas características nos resultados: "whey 80" exibiria produtos com "80 cápsulas" ou "800 mg", e como os nomes não correspondiam, eles apareceriam em "Você também pode gostar". Agora, se a pesquisa incluir palavras e um número de um ou dois dígitos, um produto deve corresponder a pelo menos uma das palavras. Com poucos resultados, o bloco é preenchido com produtos da mesma categoria, como no exemplo a seguir. 1.4.45.

A atualização limpa o cache de pesquisa.

20/10/2026
v1.4.45

Sinônimos também contam na hora de fazer um pedido.

A busca já procurava sinônimos ("proteína" → "proteína"), mas a etapa que separava correspondências exatas, correspondências relacionadas e "Você também pode gostar" comparava apenas a palavra digitada com o nome do produto. Tudo o que era encontrado como sinônimo entrava em "Você também pode gostar" e era classificado por vendas, então o produto mais vendido aparecia primeiro, mesmo que não tivesse relação com o produto, e uma busca com um erro de ortografia mostrava essa etiqueta no topo. Agora, uma palavra corresponde ao produto se corresponder a si mesma ou a um de seus sinônimos ativos, e "proteína" é classificada da mesma forma que "proteína". Ativar e desativar a opção "Promover Correspondências Exatas" é suficiente.

Um único número curto já não se refere a um produto.

Com várias palavras, bastava acertar um ou dois dígitos para acessar itens relacionados e marcar pontos: com "ômega 3", você ganhava um "Pacote 3" de outro produto ou um formato "30g" antes dos de ômega. Agora, o número só conta se também corresponder a uma palavra.

"Você também pode gostar" com poucos resultados, sem Meilisearch

Uma busca com menos de 8 resultados é complementada com até 8 produtos que compartilham a mesma categoria: primeiro a categoria mais específica que compartilham (uma subcategoria antes da categoria principal; as categorias raiz e inicial não são contabilizadas) e, em seguida, os produtos mais vendidos. Respeita categorias e fabricantes excluídos, bem como a opção "Ocultar produtos fora de estoque". Apenas a ordenação por relevância é utilizada, sem filtros. Anteriormente, somente o Meilisearch oferecia essa funcionalidade, e apenas quando não havia resultados disponíveis.

A atualização limpa o cache de pesquisa, que armazena o pedido final.

15/10/2026
v1.4.42

Imagens corrompidas de outros módulos não desaparecem mais

O mecanismo de busca estava à procura de erros de carregamento. todos As imagens da página foram ocultadas e quaisquer imagens que apresentassem problemas, mesmo que não fossem da própria página, também eram marcadas com um ícone de "sem imagem". Uma imagem criada por outro módulo em branco e posteriormente preenchida — o código QR de um modal de compartilhamento de carrinho de compras, por exemplo — permanecia oculta para sempre.

Agora, apenas as imagens dentro do mecanismo de busca, da página de resultados ou dos banners são processadas. Nada muda dentro do próprio módulo: uma imagem de produto que não carrega continua sendo substituída pelo ícone.

15/10/2026
v1.4.41

Outros módulos agora podem salvar o carrinho de compras após salvar um produto.

Ao salvar um produto, o mecanismo de busca o indexa e precisa de um carrinho de compras no contexto para calcular o preço (sem ele, Produto::obterPreçoEstático() faz morrer() no PrestaShop 1.7.8, 8.2 e 9.0). Se o carrinho de contexto ainda não tivesse um ID, ele era alterado para um novo Carrinho() Carrinho vazio, sem valor monetário. Na vitrine da loja, esse carrinho sem ID é o que o PrestaShop prepara para o visitante, portanto, qualquer módulo que salvasse um produto da loja e, em seguida, o carrinho, falharia com a mensagem "A propriedade Cart->id_currency está vazia". Isso também ocorre com um personalizador de roupas: o primeiro design de cada produto não cabia no carrinho.

Agora, um carrinho só é criado quando não existe nenhum (console, serviço web) e é preenchido da mesma forma que o sistema principal: idioma, moeda e loja.

O botão "adicionar ao carrinho" no painel também salva o carrinho que a loja já havia preparado, em vez de criar outro, retendo assim o visitante (id_convidado) como o carrinho de compras normal do PrestaShop.

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" faz uma requisiçã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.