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
Blocos
Este plugin disponibiliza 1 bloco.
- Search Form The best WordPress search you can find.
Instalação
- Baixe o plugin e extraia os arquivos
- Carregue
searchwp-live-search
para seu diretório~/wp-content/plugins/
- Ative o plugin no menu “Plugins” no WordPress
- Personalize opcionalmente a configuração: documentação completa
- 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 incluisearch-results.php
— que é usado imediatamente para gerar resultados de pesquisa. Para personalizar essa geração, basta criar uma pasta chamadasearchwp-live-ajax-search
no diretório do seu tema e copiarsearch-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 valorespadrão
para o que você quiser.
Avaliações
Colaboradores e desenvolvedores
“SearchWP Live Ajax Search” é um programa de código aberto. As seguintes pessoas contribuíram para este plugin.
ColaboradoresSearchWP Live Ajax Search” foi traduzido para 5 localidades. Agradecemos aos tradutores por suas contribuições.
Traduzir “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.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!