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.

  • Search 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

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
20 dezembro, 2023 1 resposta
Установил, активировал. Вроде работает, будем разбираться.
18 dezembro, 2023 1 resposta
Great job to the developer! This is amazing. The customization options have been thought through incredibly well.
16 maio, 2023
data-swpengine attribute was exactly what I was looking for, I’ve should come here much earlier 🙂
Leia todas as 34 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 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!