Come cambiare l'immagine di fallback predefinita per i risultati di ricerca
SearchWP utilizza il campo immagine in primo piano dei post per visualizzare le miniature nei risultati di ricerca. Questo approccio funziona bene per i tipi di post standard a cui sono state assegnate immagini in primo piano, ma alcuni tipi di contenuto potrebbero non avere immagini in primo piano o potrebbero richiedere una gestione diversa delle immagini. Per queste situazioni, è possibile implementare immagini di fallback personalizzate per garantire una presentazione visiva coerente in tutti i risultati di ricerca.
Configurazione di base dell'immagine di fallback
È possibile utilizzare l'hook post_thumbnail_html di WordPress per assegnare immagini alternative per tipi di post specifici che non dispongono di campi immagine in primo piano o quando si desidera sovrascrivere il comportamento predefinito delle miniature. Questo hook fornisce un controllo completo sulla visualizzazione delle miniature e consente di personalizzare la presentazione delle immagini in base al tipo di post, al contenuto o a qualsiasi altro criterio definito.
Per ulteriori informazioni sui parametri e sull'utilizzo di questo hook, consultare la documentazione per sviluppatori di WordPress qui.
Risultati immagine multimediale
Quando si lavora con risultati di immagini multimediali nella ricerca, è possibile modificare l'hook post_thumbnail_html per visualizzare la miniatura dell'immagine originale anziché fare affidamento sulle immagini in primo piano. Il seguente esempio dimostra come implementare questa funzionalità specificamente per i risultati di ricerca e i contesti di ricerca Ajax Live di 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 ); |
Nota: tutti gli hook devono essere aggiunti al tuo plugin personalizzato Personalizzazioni SearchWP.
Risultati multimediali PDF
Per i risultati di ricerca PDF, potresti voler visualizzare un'immagine segnaposto o utilizzare un campo personalizzato (come una miniatura caricata tramite ACF).
Ecco un esempio che utilizza un'immagine di 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 ); |
Nota: se stai utilizzando i campi ACF per assegnare miniature ai PDF, puoi sostituire il segnaposto con un valore di campo dinamico.

