WordPress : Función get_the_post_thumbnail muestra imagen destacada

He estado trabajando en el desarrollo de un tema de wordpress y noté que muchas de las funciones de Wordpress tienen dos versiones: la normal, como the_post_thumbnail y la misma con get_the_post_thumbnail.

<?php the_post_thumbnail(); ?>
<?php get_the_post_thumbnail(); ?>

Con la funcion get_the_post_thumbnail se recupera las imagenes destacadas en cualquier lugar que uno desee en la web. 

Uso básico: 

Ejemplo 1:

<?php echo get_the_post_thumbnail( $post_id, $tamaño, $atributo); ?>

Ejemplo 2:

<?php 
 $args = array(
          'post_type' => 'fastfood_slider',
          'posts_per_page' => 3
          );

$loop = new WP_Query( $args );

while ( $loop->have_posts() ) : $loop->the_post();
   echo get_the_post_thumbnail( $loop->ID, 'imagen-featured-image' ); 
endwhile;
?> 

Explicación del ejemplo 2

$args = array(
'post_type' => 'fastfood_slider',
'posts_per_page' => 3
);

→  Consulta a la base de datos con WP_Query y le pasamos el argumento $args que indica 3 ultimos registros , recuerda que el custom post type lo hemos definido en function.php con la funcion
register_post_type( 'fastfood_slider'

→  while ( $loop->have_posts() ) : $loop->the_post()  = Mientras $loop tenga post have_posts() , convertimos a $loop en un post (the_post()) 

→  $loop->ID  →  Es el identificador del Loop

Parámetros

$post_id

Este es un parámetro opcional en el que puede definir el ID de la publicación de la que obtendrá la imagen destacada. Si esto no está definido, mostrará la imagen destacada de la publicación actual que está viendo.

$tamaño

Este es un parámetro opcional que se puede usar para determinar el tamaño en que se muestra la imagen destacada. Puede definir una cadena o una matriz con las dimensiones.

Tamaños predefinidos :

• miniatura
• medio
• largo
• completo

Tamaños personalizados :

Para definir un tamaño personalizado, simplemente defínalo dentro de una matriz, por ejemplo:

get_the_post_thumbnail($post_id, array(100,100), $attr);

Como puede ver en el código anterior, el tamaño de la imagen es 100 × 100.

$attr

Este es un parámetro opcional en el que puede usar una matriz para definir atributos adicionales como la clase, el texto alternativo, el título, etc. Esto se vería así:

$attr = array(
'src' => $src,
'class' => “adjunto-$tamaño”,
'alt' => recortar(strip_tags( $adjunto->post_extracto)),
'title' => recortar(strip_tags ( $archivo adjunto->post_title )),
);

En el ejemplo anterior, estamos almacenando la matriz que contiene la ubicación de la imagen, la clase, el texto alternativo y el título dentro de una variable que luego se llama dentro de la función get_the_post_thumbnail() .

Diferencia entre the_post_thumbnail y get_the_post_thumbnail en wordpress

the_post_thumbnail( $size, $attr )

1. Se usa solo cuando estás en el post loop actual (ciclo de publicación actual).
2. Imprime la salida directamente. No se puede asignar a una variable.
3. Tiene 2 parámetros como se especifica arriba.

get_the_post_thumbnail( $post, $size, $attr )

1. También se puede utilizar fuera del bucle. Puede pasar la identificación de publicación o el objeto de publicación en el primer parámetro.
2. Devuelve los datos. La salida se puede asignar a una variable.
3. Tiene 3 parámetros como se especifica arriba.