Realce do SearchWP
SearchWP inclui um recurso de destaque 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 destacadas na página de resultados da pesquisa, permitindo que os usuários localizem facilmente a parte relevante do conteúdo. Este recurso é particularmente útil para documentos de mídia grandes, como PDFs de várias páginas, pois ele escaneia todo oconteúdo do documento, localiza instâncias do termo de pesquisa e gera um excerto da seção que contém essas palavras-chave.
A funcionalidade de destaque é totalmente compatível com plugins de campos personalizados comoAdvanced Custom Fields(ACF), permitindo gerar excertos de termos de pesquisa encontrados em campos de texto do ACF e outros conteúdos de campos personalizados.
Ativando o Destaque
O recurso de destaque pode ser ativado através dasConfigurações Geraisdo SearchWP em sua área de administração do WordPress. Uma vez ativado, o SearchWP gerará automaticamente excertos personalizados que destacam os termos de pesquisa correspondentes em seus resultados.
Ordem de Processamento de Conteúdo
O sistema de destaque processa os atributos de origem em uma ordem sequencial específica para determinar onde gerar os excertos. Essa abordagem priorizada garante um processamento eficiente e resultados consistentes em sua implementação de pesquisa.
Excerto da Postagem:O SearchWP primeiro verifica se há excertos de postagem criados manualmente. Se uma postagem tiver um excerto personalizado definido, esse conteúdo será avaliado primeiro quanto à presença de termos de pesquisa.
Conteúdo da Postagem:Se não houver excerto ou se nenhuma palavra-chave for encontrada no excerto, o SearchWP examinará 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 palavra-chave pesquisada for encontrada em um desses atributos, os atributos subsequentes não serão processados. Por exemplo, se o excerto da postagem contiver as palavras-chave pesquisadas, o SearchWP não examinará o conteúdo da postagem ou os campos personalizados para gerar um excerto.
Observação: Quando várias 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 excerto.
Geração de Trecho
Quando o SearchWP localiza o conteúdo que contém 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 ao redor 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 do WordPressexcerpt_lengthconforme documentadoaqui.
Para modificar o comprimento do trecho especificamente para os resultados do SearchWPBusca ao Vivovocê 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 CSSsearchwp-highlightque você pode direcionar com estilos personalizados para controlar a aparência visual dos termos de pesquisa destacados. Você pode adicionar regras de CSS personalizadas à folha de estilo do seu tema para modificar a cor de fundo, a cor do texto, a espessura da fonte ou outras propriedades visuais das palavras-chave destacadas. Isso permite que você garanta que os termos destacados sejam claramente visíveis e correspondam à estética geral de design do seu site.
