Como alterar a imagem de fallback padrão para Resultados da Pesquisa
SearchWP utiliza o campo de imagem destacada das postagens para exibir miniaturas nos resultados da pesquisa. Essa abordagem funciona bem para tipos de postagem padrão que têm imagens destacadas atribuídas, mas alguns tipos de conteúdo podem não ter imagens destacadas ou podem exigir um tratamento de imagem diferente. Para essas situações, você pode implementar imagens de fallback personalizadas para garantir uma apresentação visual consistente em todos os resultados da pesquisa.
Configuração Básica de Imagem de Fallback
Você pode usar o hook post_thumbnail_html do WordPress para atribuir imagens alternativas para tipos de postagem específicos que não possuem campos de imagem destacada ou quando você deseja substituir o comportamento padrão de miniatura. Este hook oferece controle total sobre a exibição de miniaturas e permite personalizar a apresentação da imagem com base no tipo de postagem, conteúdo ou qualquer outro critério que você definir.
Para mais informações sobre os parâmetros e uso deste hook, consulte a documentação do desenvolvedor do WordPress aqui.
Resultados de Imagem de Mídia
Ao trabalhar com resultados de imagem de mídia em sua pesquisa, você pode modificar o hook post_thumbnail_html para exibir a miniatura da imagem original em vez de depender de imagens destacadas. O exemplo a seguir demonstra como implementar essa funcionalidade especificamente para resultados de pesquisa e contextos de pesquisa Ajax ao vivo do SearchWP:
| <?php | |
| // Set image thumbnail for media image results on search page | |
| add_filter( 'post_thumbnail_html', function( $html, $post_id ) { | |
| // Check if we're in a search context | |
| if ( | |
| ( | |
| is_search() | |
| || doing_action( 'wp_ajax_searchwp_live_search' ) | |
| || doing_action( 'wp_ajax_nopriv_searchwp_live_search' ) | |
| || isset( $_REQUEST['swps'] ) | |
| ) | |
| && 'attachment' === get_post_type( $post_id ) | |
| ) { | |
| $mime_type = get_post_mime_type( $post_id ); | |
| // If it’s an image attachment, use the original thumbnail | |
| if ( strpos( $mime_type, "image" ) !== false ) { | |
| $html = wp_get_attachment_image( $post_id, 'thumbnail' ); | |
| } | |
| } | |
| return $html; | |
| }, 10, 2 ); |
Observação: Todos os hooks devem ser adicionados ao seu plugin personalizado SearchWP Customizations Plugin.
Resultados de Mídia em PDF
Para resultados de pesquisa em PDF, você pode querer exibir uma imagem de placeholder ou usar um campo personalizado (como uma miniatura carregada pelo ACF).
Aqui está um exemplo usando uma imagem de fallback:
| <?php | |
| // Set default thumbnail for PDF results on search page | |
| add_filter( 'post_thumbnail_html', function( $html, $post_id ) { | |
| $mime_type = get_post_mime_type( $post_id ); | |
| // Target PDF media results only | |
| if ( 'attachment' === get_post_type( $post_id ) && strpos( $mime_type, "pdf" ) !== false ) { | |
| $html = "<img src='https://placehold.co/500x500' alt='PDF Thumbnail' />"; | |
| } | |
| return $html; | |
| }, 10, 2 ); |
Observação: Se você estiver usando campos ACF para atribuir miniaturas para PDFs, você pode substituir o placeholder por um valor de campo dinâmico.
