Realce do SearchWP
O SearchWP inclui um recurso de realce integrado que identifica e enfatiza os termos de pesquisa encontrados no conteúdo das postagens. Ele exibe um trecho de texto contendo as palavras-chave realçadas na página de resultados da pesquisa, permitindo que os usuários localizem facilmente a parte relevante do conteúdo. Esse recurso é particularmente útil para documentos de mídia grandes, como PDFs de várias páginas, pois ele percorre o conteúdo completo do documento, localiza instâncias do termo de pesquisa e gera um trecho da seção que contém essas palavras-chave.
A funcionalidade de realce é totalmente compatível com plugins de campos personalizados como o Advanced Custom Fields (ACF), permitindo que ele gere trechos de termos de pesquisa encontrados em campos de texto do ACF e outros conteúdos de campos personalizados.
Ativando o Realce
O recurso de realce pode ser ativado através da página de Configurações Gerais do SearchWP em sua área de administração do WordPress. Uma vez ativado, o SearchWP gerará automaticamente trechos personalizados que realçam os termos de pesquisa correspondentes em seus resultados.
Ordem de Processamento de Conteúdo
O sistema de realce processa os atributos de origem em uma ordem sequencial específica para determinar onde gerar os trechos. Essa abordagem priorizada garante um processamento eficiente e resultados consistentes em sua implementação de pesquisa.
Trecho da Postagem: O SearchWP primeiro verifica se há trechos de postagem criados manualmente. Se uma postagem tiver um trecho personalizado definido, esse conteúdo é avaliado primeiro quanto à presença de termos de pesquisa.
Conteúdo da Postagem: Se não houver trecho ou se nenhuma palavra-chave for encontrada no trecho, o SearchWP examina o campo de conteúdo principal da postagem em busca de instâncias dos termos de pesquisa.
Conteúdo do Documento: Para arquivos de mídia como PDFs, o SearchWP processa o conteúdo extraído do documento para localizar termos de pesquisa dentro do texto do arquivo.
Campos Personalizados: Finalmente, o SearchWP verifica o conteúdo dos campos personalizados em busca de termos de pesquisa, caso eles não tenham sido encontrados em nenhum dos atributos anteriores.
Se alguma das palavras-chave pesquisadas for encontrada em um desses atributos, os atributos subsequentes não serão processados. Por exemplo, se o trecho da postagem contiver as palavras-chave pesquisadas, o SearchWP não examinará o conteúdo da postagem ou os campos personalizados para gerar um trecho.
Observação: Quando múltiplas instâncias de uma palavra-chave existem dentro de um único campo de atributo, a primeira ocorrência da palavra-chave será usada para gerar o trecho.
Geração de Trechos
Quando o SearchWP localiza o conteúdo contendo as palavras-chave a serem destacadas, ele gera um trecho extraindo uma porção de texto antes e depois das palavras-chave. Essa abordagem contextual garante que os usuários vejam não apenas o termo correspondente, mas também o conteúdo circundante que fornece contexto para a correspondência. O comprimento do trecho é controlado pelas suas configurações do WordPress e pode ser personalizado usando o hook de filtro excerpt_length do WordPress, conforme documentado aqui.
Para modificar o comprimento do trecho especificamente para os resultados da Pesquisa ao Vivo do SearchWP, você pode implementar a seguinte personalização:
| <?php | |
| // Set excerpt length to 20 words for live search results | |
| function swp_excerpt_length( $length ) { | |
| if ( did_action( 'wp_ajax_searchwp_live_search' ) || did_action( 'wp_ajax_nopriv_searchwp_live_search' ) ) { | |
| return 20; | |
| } | |
| return $length; | |
| } | |
| add_filter( 'excerpt_length', 'swp_excerpt_length', 9999 ); |
Estilizando Termos Destacados
A marcação de destaque padrão inclui a classe CSS searchwp-highlight, que você pode direcionar com estilos personalizados para controlar a aparência visual dos termos de pesquisa destacados. Você pode adicionar regras CSS personalizadas à folha de estilo do seu tema para modificar a cor de fundo, a cor do texto, o peso da fonte ou outras propriedades visuais das palavras-chave destacadas. Isso permite garantir que os termos destacados sejam claramente visíveis e correspondam à estética geral do design do seu site.
