FacetWP – Relevanssi integration

Integração do FacetWP com o Relevanssi

A integração do FacetWP com o plugin Relevanssi é uma combinação poderosa que permite melhorar significativamente a qualidade e a relevância dos resultados de busca em sites WordPress. Isso ocorre porque o Relevanssi mantém seu próprio índice de busca no banco de dados, possibilitando resultados mais acertados e personalizados para os usuários. Neste artigo, vamos explorar como configurar essa integração, os principais benefícios e possíveis limitações para garantir que você tire o máximo proveito dessa combinação.

Configuração da Integração

Para que o FacetWP funcione corretamente com o Relevanssi, é essencial instalar o complemento específico do Relevanssi. Sem essa adição, as facetas de busca e as páginas de resultados de busca não funcionarão como deveriam. Após ativar o complemento, cada faceta de busca mostrará uma nova opção “Relevanssi” nas configurações do seu motor de busca. É importante selecionar essa opção para garantir que os resultados apareçam. Caso contrário, a faceta retornará sem resultados.

Se a sua página de resultados de busca (aquele link que termina em /?s=termo) não incluir facetas, a configuração necessária ainda se mantém. Você precisará desativar o FacetWP nesta mesma página para que os resultados sejam exibidos corretamente.

Limitações do Relevanssi

É importante estar ciente de que a utilização do Relevanssi pode demandar um espaço considerável no banco de dados, às vezes chegando a centenas de megabytes. Portanto, se o servidor que você está usando tem um espaço limitado, isso pode causar dificuldades. Há relatos de que, em contas de hospedagem compartilhada, um número elevado de posts pode causar problemas de desempenho.

Os desenvolvedores do Relevanssi informam que a capacidade máxima de suporte para sites depende muito do hardware disponível. Em hardware mais robusto, não há um limite claro; já em configurações comuns, algumas dezenas de milhares de posts podem ser um desafio. Um caso notável foi um site que lidava com dois milhões de posts, mas tinha um servidor de banco de dados dedicado com SSDs, fazendo tudo funcionar sem problemas.

Personalização do Limite de Postagens

Por padrão, o Relevanssi traz um limite de 500 resultados em suas buscas, estabelecido pela configuração “Throttle searches”, que está ativada por padrão. Caso você deseje remover esse limite, é necessário desativar essa opção. No entanto, essa ação pode prejudicar a performance se sua consulta mostrar um número elevado de posts.

Caso queira personalizar este limite, você pode adicionar um código ao arquivo functions.php do seu tema filho. A recomendação é que o valor não seja inferior a 200, pois números baixos podem levar a resultados menos relevantes. Lembrando que esse ajuste só surtirá efeito se a configuração “Throttle searches” estiver ativada.

Resolvendo Problemas de Busca

Caso os resultados da busca apresentem comportamentos inesperados, o primeiro passo é verificar as configurações do Relevanssi. Você pode testar os resultados utilizando a ferramenta “Admin search” do Relevanssi disponível no painel de controle, em Dashboard > Admin search.

Se, mesmo assim, você não conseguir ver todos os resultados esperados, fique atento ao limite padrão de 500 posts. Outra questão a considerar é a desativação da configuração de snippets de resultados de busca, que alguns usuários relataram ter causado problemas na exibição dos resultados.

Evitando Interferência do FacetWP

Ao utilizar a integração do FacetWP com o Relevanssi, é crucial garantir que não ocorra interferência nas consultas de busca, especialmente quando não há facetas presentes. Se isso ocorrer, os resultados podem não aparecer como esperado, ou a ordem dos resultados pode mudar. A solução é desativar o FacetWP apenas para a página de resultados de busca, utilizando um comando específico no functions.php do seu tema filho.

Usando o Relevanssi com WooCommerce

Para usuários que utilizam o Relevanssi em conjunto com o WooCommerce, algumas questões de compatibilidade podem surgir. Isso inclui problemas ao buscar SKUs de variações de produtos, que podem não funcionar como esperado. O Relevanssi pode indexar SKUs de produtos e variações, mas para garantir que você encontre os produtos principais ao buscar por SKUs de variações, é preciso adicionar um código ao functions.php que utiliza o gancho relevanssi_content_to_index.

Desabilitando o Relevanssi em Certas Páginas

Caso você precise desativar o Relevanssi em páginas ou templates específicos, isso pode ser feito desconectando dois filtros do Relevanssi. Isso permitirá que você utilize o motor de busca padrão do WordPress em facetas mesmo com o Relevanssi instalado.

Alterando o Comprimento Mínimo das Palavras

O Relevanssi, por padrão, não indexa palavras com menos de três caracteres. Isso significa que consultas menores não retornarão resultados nas facetas que utilizam o motor Relevanssi. Você pode alterar essa configuração nas opções de “Mínimo comprimento de palavra”.

Modificando a Consulta de Busca do Relevanssi

Em determinados casos, pode ser necessário manipular a consulta de busca do Relevanssi. Para isso, é indicado utilizar o gancho facetwp_relevanssi_do_query. Com ele, você pode adicionar argumentos de meta_query para excluir eventos passados de suas buscas.

Uma configuração prática pode incluir um código simples que aplica esta filtragem, garantindo que os usuários não vejam eventos que já ocorreram.

Exibindo Excertos do Relevanssi

Quando se utiliza uma faceta de busca com o Relevanssi como motor de busca, o FacetWP não gera excertos automaticamente. Para contornar isso, há um código que pode ser adicionado para garantir que os excertos exibidos sejam gerados pelo Relevanssi. Isso enriquece a apresentação dos resultados, fornecendo informações mais relevantes na visualização.

Considerações Finais

A integração entre FacetWP e Relevanssi apresenta grandes vantagens para quem busca melhorar a experiência de busca em sites WordPress. Com a configuração adequada e a conscientização sobre limitações e ajustes necessários, é possível elevar a relevância dos resultados, proporcionando uma navegação mais fluida e intuitiva.

Evite cair em armadilhas comuns, como não desativar o FacetWP quando necessário ou ignorar a necessidade de configuração do limite de resultados. Mantenha sempre um olho aberto nas atualizações dos plugins e nos guias oficiais de cada ferramenta para garantir que você está utilizando o que há de melhor e mais adequado para sua plataforma. Essa integração, se bem aproveitada, pode se tornar um grande diferencial para a gestão e otimismo da busca em seu site, facilitando a vida dos seus usuários e promovendo um engajamento maior com o conteúdo que você oferece.