La fonction WordPress get_the_post_thumbnail() vous permettra d’obtenir l’image vedette et de l’afficher à l’aide de votre thème ou plugin. Dans cet article, nous vous apprendrons à utiliser la fonction get_the_post_thumbnail() pour afficher les images vedettes où vous le souhaitez.
Si vous souhaitez plus d’informations sur la création de plugins WordPress, consultez notre série de tutoriels sur la création de votre premier plugin WordPress.
Note : Pour utiliser la fonction get_the_post_thumbnail(), vous devrez activer son support dans votre thème.
Pour activer le support de la fonction get_the_post_thumbnail(), incluez ce qui suit dans le fichier functions.php de votre thème :
add_theme_support( ‘post-thumbnails’ );
Utilisation de base
< ?php echo get_the_post_thumbnail( $post_id, $size, $attr ) ; ?>
Dans le code ci-dessus, nous affichons simplement l’image vedette d’un article en fonction des paramètres que nous avons définis. Ci-dessous, vous verrez les différents paramètres qui peuvent être définis au sein de la fonction get_the_post_thumbnail().
Paramètres
$post_id : Il s’agit d’un paramètre facultatif dans lequel vous pouvez définir l’ID du post à partir duquel vous obtiendrez l’image vedette. Si ce paramètre n’est pas défini, l’image vedette sera affichée à partir du post actuel que vous consultez.
$size : C’est un paramètre facultatif qui peut être utilisé pour déterminer la taille d’affichage de l’image vedette. Vous pouvez définir soit une chaîne de caractères, soit un tableau avec les dimensions.
Tailles prédéfinies :
- thumbnail
- medium
- large
- full
Tailles personnalisées :
Pour définir une taille personnalisée, il suffit de la définir dans un tableau, par exemple :
get_the_post_thumbnail($post_id, array(100,100), $attr );
Comme vous pouvez le voir dans le code ci-dessus, la taille de l’image est de 100×100.
$attr : C’est un paramètre facultatif dans lequel vous pouvez utiliser un tableau pour définir des attributs supplémentaires tels que la classe, le texte alt, le titre, etc. Cela ressemblerait à quelque chose comme ce qui suit :
$attr = array(
‘src’ => $src,
‘class’ => « attachment-$size »,
‘alt’ => trim(strip_tags( $attachment->post_excerpt )),
‘title’ => trim(strip_tags( $attachment->post_title )),
) ;
Dans l’exemple ci-dessus, nous stockons le tableau contenant l’emplacement de l’image, la classe, le texte alt et le titre dans une variable qui est ensuite appelée dans la fonction get_the_post_thumbnail().