La función get_the_post_thumbnail() WordPress te permitirá obtener la imagen destacada y mostrarla utilizando tu tema o plugin. En este artículo, le enseñaremos cómo utilizar la función get_the_post_thumbnail() para mostrar las imágenes destacadas en cualquier lugar que desee.
Si desea obtener más información sobre la creación de plugins de WordPress, consulte nuestra serie de tutoriales sobre la creación de su primer plugin de WordPress.
Nota: Para utilizar la función get_the_post_thumbnail(), tendrá que habilitar el soporte para ella dentro de su tema.
Para habilitar el soporte de la función get_the_post_thumbnail(), incluya lo siguiente en el archivo functions.php de su tema:
add_theme_support( ‘post-thumbnails’ );
Uso básico
<?php echo get_the_post_thumbnail( $post_id, $size, $attr ); >
En el código anterior, simplemente estamos mostrando la imagen destacada de un post en base a los parámetros que hemos definido. A continuación, verás los distintos parámetros que se pueden definir dentro de la función get_the_post_thumbnail().
Parámetros
$post_id: Es un parámetro opcional en el que se puede definir el ID del post del que se obtendrá la imagen destacada. Si no se define, se mostrará la imagen destacada del post actual que se está viendo.
$size: Este es un parámetro opcional que se puede utilizar para determinar el tamaño en que se muestra la imagen destacada. Puedes definir una cadena o un array con las dimensiones.
Tamaños predefinidos:
- thumbnail
- medium
- large
- full
Tamaños personalizados:
Para definir un tamaño personalizado, basta con definirlo dentro de un array, por ejemplo:
get_the_post_thumbnail($post_id, array(100,100), $attr );
Como puedes ver en el código anterior, el tamaño de la imagen es 100×100.
$attr: Es un parámetro opcional en el que se puede utilizar un array para definir atributos adicionales como la clase, el texto alt, el título, etc. Esto se vería algo como lo siguiente:
$attr = array(
‘src’ => $src,
‘class’ => «attachment-$size»,
‘alt’ => trim(strip_tags( $attachment->post_excerpt )),
‘title’ => trim(strip_tags( $attachment->post_title )),
);
En el ejemplo anterior, estamos almacenando el array que contiene la ubicación de la imagen, la clase, el texto alt y el título dentro de una variable que posteriormente se llama dentro de la función get_the_post_thumbnail().