Custom Google Search

Crie sua Própria Pesquisa Personalizada no WordPress

O sistema de busca padrão do WordPress muitas vezes é criticado. Embora existam muitos plugins que prometem melhorar essa funcionalidade, nem sempre eles atendem às necessidades específicas de quem está tentando desenvolver um mecanismo de busca alternativo. Neste texto, vamos discutir como criar sua própria pesquisa personalizada no WordPress e explorar alguns segredos surpreendentes sobre a busca na plataforma.

Amplificando a Busca do WordPress com um Formulário Personalizado

Por trás da função de busca do WordPress, está a classe WP_Query. Se você já trabalhou com loops personalizados anteriormente, é provável que esteja familiarizado com o WP_Query. Essa classe permite que você utilize uma vasta gama de parâmetros, muitos dos quais podem ser especificados em um formulário de busca (ou até diretamente em uma URL) para alterar o comportamento da pesquisa.

Por exemplo, se você deseja transformar uma busca padrão para que ela busque em um tipo de post personalizado chamado “produto”, você pode simplesmente usar uma URL como a seguinte:

http://www.seusite.com/?s=bola&post_type=produto

Esse link retornará apenas resultados para os posts personalizados do tipo “produto” que contêm a palavra “bola” no título ou no conteúdo. Ao explorar a lista de parâmetros do WP_Query, você encontrará diversas opções que podem ser usadas para alterar a pesquisa, incluindo inclusão e exclusão de categorias, busca por taxonomias e restrições de autores.

Vale lembrar que é imprescindível incluir o parâmetro “s” na URL para que a pesquisa funcione.

Buscando por Frases

A pesquisa padrão do WordPress realiza buscas por palavras-chave. Por exemplo, ao fazer uma busca pela consulta “botas de futebol”, o WordPress monta a seguinte cláusula para o WHERE:

((wp_posts.post_title LIKE '%futebol%') OR (wp_posts.post_content LIKE '%futebol%')) AND ((wp_posts.post_title LIKE '%botas%') OR (wp_posts.post_content LIKE '%botas%'))

Esse tipo de busca não é uma busca por frase; em vez disso, busca “futebol” em qualquer parte do título ou conteúdo, assim como “botas”. Portanto, um post que contenha “botas” no título e “futebol” no conteúdo será retornado, o que provavelmente não reflete a intenção de quem está pesquisando.

Entretanto, você pode fazer com que o WordPress realize uma busca por frases, simplesmente adicionando o parâmetro &sentence=1 à URL. Isso altera a cláusula WHERE para:

((wp_posts.post_title LIKE '%botas de futebol%') OR (wp_posts.post_content LIKE '%botas de futebol%'))

Agora, a pesquisa busca pela frase exatamente como foi digitada e somente retornará resultados que contêm “botas de futebol” no título ou no conteúdo.

Encontrando uma Correspondência Exata

Um conceito relacionado ao anterior, mas ainda mais específico, é a busca exata. Ao incluir o parâmetro &exact=1 na URL, a cláusula WHERE se transforma em:

((wp_posts.post_title LIKE 'botas de futebol') OR (wp_posts.post_content LIKE 'botas de futebol'))

A única diferença aqui é a remoção do caractere % em torno da frase nas cláusulas LIKE. Isso faz toda a diferença, já que agora o título ou o conteúdo precisa corresponder exatamente à busca, em vez de apenas conter as palavras.

Assim, se não houver nenhum post com o título “botas de futebol”, não haverá resultados retornados. Use o parâmetro exato com cuidado.

Personalizando o Formulário de Busca

O formulário de busca padrão do WordPress é bem simples e básico:

Buscar por:

Se quisermos mudar o comportamento da pesquisa, basta adicionar campos ao nosso formulário. Um exemplo de um formulário de busca customizado que gera a seguinte URL quando enviado:

http://www.test.dev/?s={query}&sentence=1&post_type=produto

Esse formulário ainda chamará a página de resultados de buscas padrão, mas agora retornará resultados para o tipo de post personalizado “produto” que contêm a frase buscada em seus títulos ou conteúdos.

Uma maneira fácil de construir seu próprio formulário de busca, se você deseja manter o formulário padrão, é criar um novo template de página com o formulário codificado conforme suas preferências e atribuí-lo a uma página específica.

Caso você queira atualizar o formulário de busca padrão, existem duas opções:

1. Criação de um arquivo template chamado searchform.php. Sempre que a função get_search_form() for chamada, o WordPress buscará e usará esse template primeiro.
2. Usar o filtro get_search_form para forçar o WordPress a utilizar seu formulário personalizado.

Ambas as técnicas são descritas em detalhes na documentação do WordPress.

Quando um Formulário Personalizado Não É Suficiente

Embora você possa fazer bastante coisa com um formulário personalizado, existem cenários em que é necessário construir o WP_Query e gerenciar os resultados por conta própria, principalmente quando você está adicionando uma segunda função de busca.

Estudo de Caso: Biblioteca de Produtos

Este estudo de caso se refere a um site de e-commerce que vende uma combinação de produtos físicos e digitais. A maioria dos produtos digitais é composta de edições antigas de duas revistas, além de encartes tanto em formato impresso quanto digital.

A organização desejava oferecer uma busca tipo “biblioteca” que permitisse aos visitantes pesquisar apenas as revistas e os encartes por certas frases (as revistas possuem uma lista completa de conteúdo em seu conteúdo). Enquanto o site já tinha uma busca por produtos, os resultados eram insatisfatórios, pois:

• Muitas vezes retornavam resultados irrelevantes.
• Incluíam todos os produtos.
• Não indicavam onde o termo de busca havia sido encontrado, já que os resultados eram apenas a imagem do produto.

Para manter as buscas atuais intactas, uma nova função de busca foi construída, que:

• Prioriza a busca por frases em vez de palavras-chave.
• Restringe a busca apenas às categorias de revista e encarte.
• Exibe e destaca o texto que contém a correspondência com a frase pesquisada.

As duas primeiras exigências poderiam ser atendidas com o seguinte formulário de busca personalizado:

Buscar por:

Entretanto, isso não ajudaria no layout da listagem dos resultados da busca e na destaque da frase buscada, então um novo template de página foi desenvolvido e atribuído a uma nova página dedicada.

A lógica principal no template é a seguinte:

O formulário é basicamente o padrão do WordPress, pois toda a manipulação da chamada do WP_Query acontece na codificação, onde:

• post_type está definido como “produto”.
• sentence está definido como 1, ativando a busca por frases.
• Um parâmetro de taxonomia é adicionado para restringir a busca a três categorias de produto.
• A ordenação é definida por data e menu_order de forma decrescente.
• Todos os posts devem ser retornados.

É importante observar que não há paginação nesta solução. Para uma busca personalizada e específica, pode não ser necessário o uso de paginação, especialmente se a busca por frase estiver ativada.

Uma vez que o WP_Query é executado, é hora de exibir os resultados da busca. Vale a pena ressaltar que, se não houver resultados, alguns produtos relacionados são exibidos para tentar manter o visitante na página.

A exibição dos resultados requer duas funções adicionais: uma para extrair o texto que contém a frase que coincide e outra para destacar a frase em si. O destaque da frase é feito com uma simples expressão regex, enquanto a extração do texto contendo a frase de busca não foi tão simples, sendo facilitada pelo fato de que o conteúdo de cada produto usava uma abordagem padrão de listar os conteúdos em uma lista não ordenada, com um cabeçalho e descrição, mas encontrar uma regex para extrair o item da lista se mostrou desafiador, levando à manipulação de strings.

O resultado, no entanto, se mostrou bastante satisfatório.

Explorando as Possibilidades com Um Segundo Tipo de Pesquisa

Formulários e funções de busca personalizados são ideais para quando você precisa adicionar uma segunda função de busca que opere paralelamente à função principal, especialmente em casos onde as exigências são bem específicas.

Em várias situações, você pode conseguir o que deseja simplesmente criando um formulário de busca personalizado que passe os parâmetros apropriados para a busca embutida. Essa é uma ótima maneira de testar suas ideias antes de decidir codificar sua própria função de busca, adicionando as variáveis de consulta adequadas à URL de busca padrão e observando os resultados.

Dito isso, programar sua própria função de busca não é tão difícil e lhe dará acesso a uma gama ainda maior de parâmetros para controlar o comportamento da busca. A flexibilidade que uma busca personalizada oferece é poderosa, permitindo que você adapte a pesquisa exatamente conforme as necessidades do seu site e público. Ao invés de depender de soluções prontas que nem sempre atendem às suas expectativas, desenvolver uma busca personalizada pode ser a chave para oferecer uma experiência do usuário muito mais satisfatória e eficaz.

Aproveitar as funcionalidades do WordPress para criar uma busca que realmente faça o que você deseja pode fazer toda a diferença, permitindo que seus visitantes encontrem exatamente o que procuram de forma rápida e eficiente. Com um pouco de criatividade e conhecimentos de programação, você pode ter o controle total sobre como a busca do seu site opera, aumentando a usabilidade e a satisfação do usuário em seu projeto.