The get_the_post_thumbnail() WordPress function will allow you get_the_post_thumbnail() the get_the_thumbnail function will allow you get_the_post_thumbnail will get the featured image and display it using your theme or plugin. Neste artigo, vamos ensinar a você como usar a função get_the_post_thumbnail() para exibir imagens em destaque em qualquer lugar que você queira.
Se você quiser mais informações sobre como criar plugins WordPress, veja nossa série tutorial sobre como criar seu primeiro plugin WordPress.
Note: Para usar a função get_the_post_thumbnail(), você precisará habilitar o suporte a ela dentro do seu tema.
Para habilitar o suporte para a função get_the_post_thumbnail(), inclua o seguinte no arquivo functions.php do seu tema:
add_theme_support( ‘post-thumbnails’ );
Basic usage
<?php echo get_the_post_thumbnail( $post_id, $size, $attr ); ?>
No código acima, estamos simplesmente exibindo a imagem em destaque de um post baseado nos parâmetros que definimos. Abaixo, você verá os vários parâmetros que podem ser definidos dentro da função get_the_post_thumbnail().
Parameters
$post_id: Este é um parâmetro opcional no qual você pode definir o ID do post do qual você estará obtendo a imagem em destaque. Se isto não estiver definido, ele exibirá a imagem em destaque do post atual que você está visualizando.
$size: Este é um parâmetro opcional que pode ser usado para determinar o tamanho que a imagem em destaque é exibida. Você pode definir tanto uma string quanto um array com as dimensões.
Tamanhos pré-definidos:
- miniatura
- médio
- largura
- full
Tamanhos personalizados:
Para definir um tamanho personalizado, simplesmente defina-o dentro de um array, por exemplo:
get_the_post_thumbnail($post_id, array(100,100), $attr );
Como você pode ver pelo código acima, o tamanho da imagem é 100×100.
$attr: Este é um parâmetro opcional no qual você pode usar um array para definir atributos adicionais, como a classe, texto alt, título, etc. Isto pareceria algo como o seguinte:
$attr = array(
‘src’ => $src,
‘class’ => “attachment-$size”,
‘alt’ => trim(strip_tags( $attachment->post_excerpt ))),
‘title’ => trim(strip_tags( $attachment->post_title )),
);
No exemplo acima, estamos armazenando o array contendo a localização da imagem, classe, texto alt, e título dentro de uma variável que é posteriormente chamada dentro da função get_the_post_thumbnail().