SearchWP Live Ajax Search

Descrição

Não requer o SearchWP, mas o utilizará se disponível. A documentação completa está disponível em SearchWP.com.

O SearchWP Live Ajax Search permite a pesquisa ao vivo com tecnologia AJAX para seus formulários de pesquisa. Criado para ser o melhor amigo do desenvolvedor, o SearchWP Live Ajax Search tem o objetivo de não atrapalhar, mas, ao mesmo tempo, permite que você personalize tudo nele. Ele foi configurado para funcionar com qualquer tema do WordPress e usa um carregador de modelos para exibir os resultados. A abordagem baseada em modelos permite que você personalize perfeitamente a implementação do SearchWP Live Search sem precisar mexer em dezenas de opções desorganizadas.

Funciona melhor com o SearchWP (mas o SearchWP não é necessário)

O SearchWP Live Ajax Search é melhor utilizado em conjunto com o SearchWP, mas ele não é obrigatório. Se o SearchWP estiver instalado e ativado, o SearchWP Live Ajax Search pode ser personalizado para usar qualquer um de seus mecanismos de pesquisa por formulário de pesquisa.

Personalização

Você pode personalizar a implementação do SearchWP Live Ajax Search em grande escala, incluindo qualquer número de configurações definidas pelo desenvolvedor. Os resultados são baseados em um carregador de modelos, permitindo que o SearchWP Live Ajax Search não atrapalhe e que você crie o modelo de resultados como faria com qualquer outro arquivo de tema do WordPress.

Tudo é ativado pela adição de um único atributo de dados HTML5 (data-swplive=“true”) ao campo de entrada do seu formulário de pesquisa. Isso acontece de forma automática e imediata em todos os formulários de pesquisa gerados por get_search_form().

Suporte a widget

O SearchWP Live Ajax Search inclui um widget que permite inserir formulários de pesquisa ao vivo onde você quiser.

Capturas de tela

  • Menu suspenso de resultados do SearchWP Live Ajax Search
  • Página de configurações do SearchWP Live Ajax Search Forms
  • Página de configurações do SearchWP Live Ajax Search Forms
  • Opções de incorporar do SearchWP Live Ajax Search Forms

Blocos

Este plugin disponibiliza 1 bloco.

  • SearchWP Form The best WordPress search you can find.

Instalação

  1. Baixe o plugin e extraia os arquivos
  2. Carregue searchwp-live-search para seu diretório ~/wp-content/plugins/
  3. Ative o plugin no menu “Plugins” no WordPress
  4. Personalize opcionalmente a configuração: documentação completa
  5. Personalize opcionalmente o modelo de resultados: documentação completa

Perguntas frequentes

Documentação?

Claro! Documentação completa

Como adiciono pesquisa ao vivo ao meu formulário de pesquisa?

O SearchWP Live Ajax Search se habilitará automaticamente em todos os formulários de pesquisa gerados com get_search_form(). Você pode evitar isso com o seguinte filtro:

add_filter( 'searchwp_live_search_hijack_get_search_form', '__return_false' );

Se quiser habilitar manualmente o SearchWP Live Ajax Search em um formulário de pesquisa personalizado, basta adicionar o seguinte atributo de dados à entrada que deseja conectar: data-swplive="true”

Como os resultados da pesquisa são gerados?

Por padrão, o SearchWP Live Ajax Search usa o mecanismo de pesquisa padrão do SearchWP se você estiver usando o plugin. Se não tiver o SearchWP, serão fornecidos resultados de pesquisa nativos do WordPress. Se quiser personalizar o mecanismo de pesquisa usado pelo SearchWP, basta adicionar o seguinte atributo à entrada do formulário: data-swpengine=“supplemental”, substituindo “supplemental” pelo nome do mecanismo de pesquisa desejado.

Como faço para personalizar o modelo de resultados?

O SearchWP Live Ajax Search usa um carregador de modelo. Na pasta do plugin, você encontra uma pasta templates que inclui search-results.php — que é usado imediatamente para gerar resultados de pesquisa. Para personalizar essa geração, basta criar uma pasta chamada searchwp-live-ajax-search no diretório do seu tema e copiar search-results.php para essa pasta. O SearchWP Live Ajax Sarch usará então esse arquivo em vez do que veio com o plugin, e você pode personalizá-lo como faria com outros arquivos de modelo de tema.

O SearchWP Live Ajax Search também apresenta dois conjuntos de estilos. O conjunto principal prepara o invólucro de resultados para ser posicionado corretamente. O segundo controla a aparência visual. Essa abstração foi feita para garantir que a personalização seja a mais direta possível. Você pode desativar o “tema” padrão retirando a fila da folha de estilo aplicável e também pode desativar o CSS básico. Mais informações estão disponíveis na documentação.

Como faço para personalizar o botão giratório?

O SearchWP Live Ajax Search Results usa um filtro —searchwp_live_search_configs — que permite que você personalize completamente a configuração usada. Basta adicionar uma nova chave ao array passado por esse filtro, personalizando os valores padrão para o que você quiser.

Avaliações

30 setembro, 2025 2 respostas
Hi, great plugin, I’m using the free version, how can I exclude pages? Is there a way to exclude pages via code without purchasing the pro version? Thanks in advance.
19 março, 2025
I couldn’t be more impressed with the SearchWP plugin support team! Excellent support team – They are always friendly and helpful, making sure your issues are addressed. Very responsive and speedy replies – I was impressed by how fast they got back to me each time I reached out. Extremely helpful with support queries – Every question I had was answered in detail, and they made sure I was fully satisfied. Fantastic support that really sets them apart!
8 julho, 2024 1 resposta
After initially a bad experience with support, since they have been extremely helpful with this plugin and have provided code and knowledge bases to help do the things we want
Leia todas as 37 avaliações

Colaboradores e desenvolvedores

“SearchWP Live Ajax Search” é um programa de código aberto. As seguintes pessoas contribuíram para este plugin.

Colaboradores

SearchWP Live Ajax Search” foi traduzido para 6 localidades. Agradecemos aos tradutores por suas contribuições.

Traduzir o “SearchWP Live Ajax Search” para seu idioma.

Interessado no desenvolvimento?

Navegue pelo código, consulte o repositório SVN ou assine o registro de desenvolvimento por RSS.

Registro de alterações

1.8.7

  • Updated compatibility with WP 6.9
  • Adds ARIA attributes to the search forms.
  • Renamed the editor form block to “SearchWP Form”.
  • Prevent deprecation notice in the block editor.
  • Updates deprecated jQuery methods.
  • Updates Choises.js deprecated methods.

1.8.6

  • Updates deprecated jQuery methods.
  • Improved results’ dropdown alignment with Gutenberg search block.
  • Adds minified assets for frontend.

1.8.5

  • Fixes integration with SearchWP Modal Search Form plugin.

1.8.4

  • Adds support for SearchWP multisite search.
  • Improves search results dropdown role attribute, for better accessibility.
  • Adjust results width to match Gutenberg form width when the search button is inside.
  • Fixes the display of the results dropdown within a custom parent element.

1.8.3

  • Evita problemas com cache de plugins em alguns casos.
  • Adiciona suporte para carregar um modelo personalizado a partir de um caminho de diretório especificado pelo usuário.

1.8.2

  • Corrige a integração com o Relevanssi Premium.

1.8.1

  • Correção de resultados incorretos ao usar um modelo personalizado do Live Search em alguns casos.

1.8.0

  • Adiciona formulários de pesquisa.
  • Adiciona suporte para fontes de pesquisa personalizadas do SearchWP.
  • Aprimora as personalizações existentes e adiciona novas personalizações à página de configurações do Live Ajax Search.
  • Atualiza arquivos de tradução.
  • Corrige o local do link Configurações na lista de plugins quando o SearchWP é ativado.

1.7.6

  • Altera a aparência da página de configurações e a estrutura do menu para funcionar perfeitamente com uma versão atual do SearchWP.

1.7.5

  • Altera o estilo visual da página de configurações do administrador para corresponder à versão atual do SearchWP.

1.7.4

  • Corrige o botão de configurações avançadas do widget que desaparece sem revelar as configurações em alguns casos.
  • Corrige a substituição do conteúdo do corpo se o elemento principal personalizado for definido na configuração.

1.7.3

  • Adiciona um sistema de notificação no plugin para obter as atualizações mais recentes do SearchWP.

1.7.2

  • Adiciona compatibilidade com a próxima versão do plugin SearchWP Modal Search Form.
  • Corrige um problema com uma versão legada do plugin SearchWP.

1.7.1

  • Corrige as traduções do plugin.

1.7.0

  • Adiciona uma nova página de administração de configurações para controlar o comportamento do plugin com mais facilidade.
  • Apresenta uma refatoração significativa do código para melhorar o desempenho.

1.6.3

  • Aprimora a higienização do argumento do campo de pesquisa “swpengine”.
  • Padroniza restrições de acesso direto em classes em todo o plugin.

1.6.2

  • Limita os argumentos passados para a consulta quando usados com a pesquisa nativa do WordPress.

1.6.1

  • Corrige o aviso do PHP introduzido na versão 1.6.0

1.6.0

  • Adiciona suporte ao bloco de formulário de pesquisa no editor de blocos (Gutenberg)

1.5.0

  • Adiciona suporte para as variáveis de consulta post_status, post_type e posts_per_page quando não estiver usando o SearchWP
  • Atualiza a fonte de tradução, atualiza traduções com domínio de texto fixo
  • Processo de pacote refatorado
  • Atualiza dependências do pacote

1.4.6

  • Adiciona compatibilidade com o SearchWP 4

1.4.5

  • Corrige um problema com suporte a frases entre aspas
  • Corrige um problema com tipos de post que são excluídos da pesquisa quando registrados (aplica-se somente a pesquisas com o SearchWP)

1.4.4

  • Corrige um problema com bundle.js em alguns casos

1.4.3

  • Aumenta a compatibilidade com o SearchWP suprimindo os filtros quando o SearchWP realiza a pesquisa
  • Correção de compatibilidade com o SearchWP Modal Search Form

1.4.2

  • Corrige um problema (erro de JavaScript) quando uma configuração personalizada desativa o botão giratório

1.4.1

  • Corrige um problema que pode ter impedido que as personalizações do botão giratório fossem aplicadas corretamente

1.4

  • Elimina o tipo de post do modelo de resultados padrão
  • Corrige um problema com entidades HTML na string de pesquisa
  • Atualiza a fonte de tradução e as traduções
  • Atualiza o processo de compilação do bundler
  • Atualizações a11y quando aplicável
  • Cancela automaticamente pesquisas pendentes quando a entrada de pesquisa é alterada

1.3.1

  • Corrige erro de digitação na chamada de função do modelo de resultados

1.3.0

  • Diversas melhorias no a11y (agradecimentos a @geoffreycrofte)
  • Adiciona mensagem quando o número mínimo de caracteres não foi atingido
  • Adicionada tradução em alemão (agradecimentos a @stefan-meier)
  • Adicionada tradução polonesa (agradecimentos a @boguslawski-piotr)
  • Adicionada tradução em holandês (agradecimentos a Stefan G.)
  • Fonte de tradução atualizada

1.2.0

  • Processo de compilação reformulado para ser mais simples
  • Suporte à depuração de scripts (agradecimentos a mgratch)
  • Elimina o requisito de ação do formulário para se integrar melhor a outros códigos (agradecimentos a mgratch)
  • Correção de um problema que impedia o acionamento da pesquisa quando ela era reinserida muito rapidamente (agradecimentos a pierrestoffe)

1.1.8

  • Adicionada opção de configuração para evitar o cancelamento de AJAX quando a tecla Enter é pressionada
  • Adicionadas algumas ações para facilitar a personalização
  • Adicionado filtro para personalizar o local do modelo de resultados

1.1.7

  • Correção de um problema com a falta do nome do mecanismo

1.1.6

  • Corrigido um problema que impedia que várias instâncias de pesquisa ao vivo em uma única página usassem mecanismos diferentes

1.1.5

  • Foi corrigido um problema em que results_destroy_on_blur não era aplicado corretamente se uma configuração personalizada fosse usada, mas essa propriedade não estivesse definida na configuração personalizada

1.1.4

  • Adição de vários eventos JavaScript para facilitar a extensão/integração adicional

1.1.3

  • Correção de um problema no processo de compilação que introduzia uma versão desatualizada dos ativos JavaScript do plugin

1.1.2

  • Não limitar mais os resultados aos tipos de post incorporados
  • Adição da opção de configuração results_destroy_on_blur para impedir a remoção automática da janela de resultados ao clicar fora do painel de resultados

1.1.1

  • Foi corrigido um problema que impedia a exibição dos mecanismos suplementares do SearchWP na configuração do widget
  • Adicionada tradução em francês
  • Adicionada tradução sérvia

1.1

  • Definir status de post padrão ao usar a pesquisa nativa do WordPress
  • Novo filtro searchwp_live_search_query_args para manipular argumentos de consulta antes das pesquisas
  • Correção de um deslocamento ao posicionar os resultados na parte superior do campo de pesquisa

1.0.6

  • Limpeza de aviso do PHP

1.0.5

  • Nova ação: searchwp_live_search_alter_results
  • Adiciona suporte a Relevanssi (com base na implementação do WordPress Live Search de Dave)

1.0.4

  • Correção do nome da pasta do modelo de resultados padrão para searchwp-live-ajax-search, conforme consta na documentação
  • Melhoria: ocultar a caixa de resultados quando a consulta for esvaziada (agradecimentos a Lennard Voogdt)
  • Correção de um problema em que a mídia não era exibida nos resultados quando integrada ao SearchWP

1.0.3

  • Corrigido problema em que um conjunto falso de nenhum resultado era retornado (agradecimentos a Lennard Voogdt)

1.0.2

  • Foi resolvido um problema em que pressionar Enter/Return impedia que a consulta de pesquisa fosse passada para a página de resultados
  • Corrigido potencial falso positivo para DOING_AJAX (agradecimentos a justinsainton)
  • Eliminada a chamada desnecessária para get_the_ID() no modelo de resultados padrão (agradecimentos a justinsainton)
  • Adição de escape ao nome do permalink e do tipo de post no modelo de resultados padrão (agradecimentos a justinsainton)
  • Utilizar uma string traduzida do núcleo do WordPress em vez de uma personalizada (agradecimentos a justinsainton)
  • Aumentar a prioridade do filtro get_search_form para permitir a acomodação dos filtros existentes

1.0.2

  • Adicionada tradução servo-croata (agradecimentos a Andrijana Nikolic)

1.0.1

  • Corrigido um problema de URL de diretório
  • Corrigido um erro indexOf JavaScript

1.0

  • Lançamento inicial!