Função the_post_thumbnail() do WordPress

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. 🙂

Deixe uma resposta

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *

1 comentário em “Função the_post_thumbnail() do WordPress”

  1. 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.