Recuperar a imagem de destaque de um Post no WordPress

Como recuperar a imagem de destaque de um Post no WordPress utilizando a função get_the_post_thumbnail_url.

Primeiro, analisamos a função que iremos utilizar:

get_the_post_thumbnail_url( int|WP_Post $post = null, string|array $size = ‘post-thumbnail’ )

O primeiro parâmetro é o ID do Post, já o segundo é o tamanho da imagem, que por padrão é “post-thumbnail”.

A localização da função: wp-includes/post-thumbnail-template.php

function get_the_post_thumbnail_url( $post = null, $size = 'post-thumbnail' ) {
    $post_thumbnail_id = get_post_thumbnail_id( $post );
    if ( ! $post_thumbnail_id ) {
        return false;
    }
    return wp_get_attachment_image_url( $post_thumbnail_id, $size );
}

Como recuperar a imagem de destaque

Primeiro exemplo dentro do loop:

if ( have_posts() ) {
    while ( have_posts() ) {
        the_post();
   
     
        $featured_img_url = get_the_post_thumbnail_url(get_the_ID(),'full'); 

        echo '<a href="'.esc_url($featured_img_url).'" rel="lightbox">'; 
            the_post_thumbnail('thumbnail');
        echo '</a>';
    endwhile; 
endif;

Fora do Loop, utilizando apenas o ID do Post.

$post = get_post(2);

$featured_img_url = get_the_post_thumbnail_url($post->ID, 'full'); 

echo '<a href="'.$featured_img_url.'" rel="lightbox">'; 
    the_post_thumbnail('thumbnail');
echo '</a>';