Disponível a partir da versão 2.9 do WordPress, a função the_post_thumbnail()
foi uma mão na roda para muitos desenvolvedores, pois possibilitou de forma simples e funcional algo que antes só estava disponível através de códigos específicos: inserir imagens de forma automatizada nas chamadas dos posts.
Utilização
Para ativar a função, é necessário incluir a seguinte chamada no arquivo functions.php
do seu template:
[code=”php”][/code]
Agora basta incluir a seguinte linha na chamada dos posts, dentro do loop:
[code=”php”][/code]
Onde $tamanho
corresponde ao tamanho da thumbnail, podendo ser os padrões definidos em Painel > Media
(thumbnail
, medium
, large
ou full
) ou então um array com dois valores correspondentes à altura e largura personalizada para a imagem (array(x,y)
).
Exemplos de parâmetros
the_post_thumbnail(); // sem parâmetro, será exibido a miniatura the_post_thumbnail('thumbnail'); // Thumbnail the_post_thumbnail('medium'); // Tamanho médio the_post_thumbnail('large'); // Tamanho grande the_post_thumbnail('full'); // Tamanho original the_post_thumbnail( array(120,80) ); // Tamanho personalizado, 120x80px
Exemplo de implementação
<?php if (have_posts()) : ?> <?php while (have_posts()) : the_post(); ?> <h1><?php the_title(); ?></h1> <div class="thumb"> <?php the_post_thumbnail('thumbnail'); ?> </div> <div class="entry"> <?php the_content(); ?> </div> <?php endwhile; ?> <?php endif; ?>
Após concluída a implementação, para escolher qual imagem aparecerá na chamada do post, no momento do upload da imagem no post, basta marcar a opção “Usar como imagem destacada“:

.
Por hoje é isso, se esqueci de algo ou tiver alguma dúvida, manda um grito aí nos comentários. 🙂
Uma resposta em “Função the_post_thumbnail() do WordPress”
Olá Damião!
Vamos ver se você pode me ajudar:
Estou utilizando conforme o exemplo ” the_post_thumbnail( array(120,80) );
// Tamanho personalizado, 120x80px “, mas a imagem não fica no tamanho de 120×80, aparece em 80×80. Estou usando o tema twentyten.