La funzione get_the_post_thumbnail() WordPress ti permetterà di ottenere l’immagine in primo piano e di visualizzarla utilizzando il tuo tema o plugin. In questo articolo, vi insegneremo come utilizzare la funzione get_the_post_thumbnail() per visualizzare le immagini in primo piano ovunque vogliate.
Se volete maggiori informazioni sulla creazione di plugin WordPress, consultate la nostra serie di tutorial sulla creazione del vostro primo plugin WordPress.
Nota: Per utilizzare la funzione get_the_post_thumbnail(), è necessario abilitare il supporto per essa nel vostro tema.
Per abilitare il supporto della funzione get_the_post_thumbnail(), includi quanto segue nel file functions.php del tuo tema:
add_theme_support( ‘post-thumbnails’ );
Uso base
<?php echo get_the_post_thumbnail( $post_id, $size, $attr ); ?>
Nel codice precedente, stiamo semplicemente visualizzando l’immagine in primo piano di un post in base ai parametri che abbiamo definito. Di seguito, vedrete i vari parametri che possono essere definiti all’interno della funzione get_the_post_thumbnail().
Parametri
$post_id: Questo è un parametro opzionale in cui puoi definire l’ID del post da cui otterrai l’immagine in primo piano. Se questo non è definito, verrà visualizzata l’immagine in primo piano dal post corrente che stai visualizzando.
$size: Questo è un parametro opzionale che può essere usato per determinare la dimensione con cui viene visualizzata l’immagine in primo piano. Puoi definire una stringa o un array con le dimensioni.
Dimensioni predefinite:
- thumbnail
- medium
- large
- full
Dimensioni personalizzate:
Per definire una dimensione personalizzata, basta definirla all’interno di un array, per esempio:
get_the_post_thumbnail($post_id, array(100,100), $attr );
Come potete vedere dal codice sopra, la dimensione dell’immagine è 100×100.
$attr: Questo è un parametro opzionale in cui puoi usare un array per definire attributi aggiuntivi come la classe, il testo alt, il titolo, ecc. Questo sarebbe qualcosa di simile a quanto segue:
$attr = array(
‘src’ => $src,
‘class’ => “attachment-$size”,
‘alt’ => trim(strip_tags( $attachment->post_excerpt )),
‘title’ => trim(strip_tags( $attachment->post_title )),
);
Nell’esempio precedente, stiamo memorizzando l’array contenente la posizione dell’immagine, la classe, il testo alt e il titolo in una variabile che viene poi chiamata all’interno della funzione get_the_post_thumbnail().