Se buscarmos no Google pelos termos: post thumbnail, wordpress post thumbnail, post thumbnail wordpress, dentre outros, teremos milhares de resultados. O que demonstra a tamanha procura pelo assunto. Os resultados são soluções diversas para implementar um simples recurso: vincular uma miniatura de imagem, diga-se thumbnail, a um post.
Com a chegada do WordPress 2.9 ficou simples, fácil e elegante vincular ao post desejado uma miniatura de imagem. Há quatro funções específicas para o assunto: has_post_thumbnail, the_post_thumbnail, get_post_thumbnail_id e get_the_post_thumbnail. Ambas estão localizadas no seguinte arquivo: wp-includes/post-thumbnail-template.php.
Suporte ao recurso de miniatura de post
Para implementar o suporte deste recurso no WordPress é necessário que a função add_theme_support() com o parâmetro ‘post-thumbnails’ seja chamada no arquivo functions.php do tema em uso. Para ser mais específico, inclua o seguinte código:
[php]
<?php
if ( function_exists( ‘add_theme_support’ ) ) :
add_theme_support( ‘post-thumbnails’ );
endif;
?>
[/php]
No arquivo functions.php do seu tema. Se ele ainda não existe, crie e salve-o na pasta do tema. Observe que antes de chamarmos a função add_theme_support verificamos se ela está disponível no WordPress em uso através da função function_exists. Como a nova função está disponível somente a partir da versão 2.9 garantimos compatibilidade com versões anteriores.
Chamado a função no arquivo functions.php do tema, teremos na tela de edição de posts o recurso Miniatura do Post como demonstrado na imagem abaixo.
Clicado em Configurar miniatura é exibido a tela de envio de imagens. Após o envio da imagem informe ao WordPress que gostaria de usa-la como miniatura clicando em Usar como miniatura. Observe:
Feito isso o recurso Miniatura do Post é preenchido com a imagem definida; além da opção remover a imagem. Veja:
Nas páginas do seu tema onde pretende exibir as miniaturas faça uso das funções has_post_thumbnail e the_post_thumbnail. A primeira verifica se há uma miniatura para o post em exibição; a segunda exibirá a miniatura com a devida marcação HTML.
Embora tenho dito que há quatro funções para se trabalhar com esse assunto, duas delas são usadas internamente. São elas: get_post_thumbnail_id e get_the_post_thumbnail. A primeira é utilizada pela função has_post_thumbnail e a segunda pela função the_post_thumbnail. Então, digamos que há duas funções internas e outras duas externas.
Forma de uso da função the_post_thumbnail.
[php]
<?php
if ( function_exists( ‘the_post_thumbnail’ ) :
the_post_thumbnail();
endif;
?>
[/php]
No exemplo acima verificamos se a função the_post_thumbnail está disponível para em seguida utiliza-la. Com seu uso será exibido uma marcação HTML através da tag img para exibir a miniatura do post.
[html]
<img width="640" height="480" title="título" alt="" src="[...]/wp-content/uploads/2009/12/1262731176983.jpg"/>
[/html]
Observe também um exemplo prático de uso da função has_post_thumbnail.
[php]
<?php if ( has_post_thumbnail() ) : ?>
<a href="<?php the_permalink(); ?>">
<?php the_post_thumbnail(); ?>
</a>
<?php endif; ?>
[/php]
As possibilidades de uso da função the_post_thumbnail
Através de seus dois parâmetros opcionais, a função the_post_thumbnail lhe permite exibir miniaturas de posts de forma personalizada. Sendo possível definir o tamanho desejado e diversos atributos.
Quanto a definição de tamanho da miniatura do post há diversas possibilidades. Utilizar os tamanhos definidos na configuração de mídia de sua instalação WordPress ou especificar valores personalizados.
[php]
the_post_thumbnail(); // Sem parâmetro é igual a Thumbnail
the_post_thumbnail( ‘thumbnail’ ); // Utiliza os valores definidos para o tamanho de imagem miniatura
the_post_thumbnail( ‘medium’ ); // Utiliza os valores definidos para o tamanho de imagem média
the_post_thumbnail( ‘large’ ); // Utilizar os valores definidos para o tamanho de imagem grande
the_post_thumbnail( array(150,110) );// Utiliza valores personalizados; neste exemplo 150 de largura e 110 de altura.
[/php]
Os atributos possíveis de serem definidos e que serão utilizados na marcação HTML da tag img são: src, class, alt e title. Para o primeiro é utilizado a localização da imagem; para o segundo uma classe personalizada com o tamanho da imagem, assim: attachment-post-thumbnail, attachment-post-medium, entre outras. O atributo alt é formado pela legenda da imagem e o title com o título.
Um exemplo prático de como definir atributos através da função the_post_thumbnail.
[php]
the_post_thumbnail( ‘thumbnail’, array( ‘class’ => ‘nome-da-classe’ ) );
[/php]
Indo além com avançadas configurações
O WordPress é extremamente flexível e isso me agrada muito. Temos incríveis possibilidades de personalização e com as miniaturas de posts não seria diferente. No seu arquivo functions.php, que deve residir no diretório do seu tema, é possível especificar o tamanho desejado para as miniaturas, os thumbnails, através da função set_post_thumbnail_size. Assim:
[php]
set_post_thumbnail_size( 75, 75 ); // Define o tamanho desejado para os thumbnails.
set_post_thumbnail_size( 75, 75, true ); // Define o tamanho desejado para os thumbnails e ativa a opção de "crop"
[/php]
É possível também registrar nomes personalizados para o tamanho de imagens, ou seja, em vez de usar os nomes proprietários: thumb, thumbnail, medium ou large, podemos definir nossos próprios nomes. Por exemplo:
[php]
add_image_size( ‘listagem-de-posts-home’, 150, 150 );
add_image_size( ‘listagem-de-posts-busca’, 300, 300 );
add_image_size( ‘post-em-destaque’, 500, 500 );
[/php]
Atente-se que a função add_image_size deve ser chamada no arquivo functions.php
A confusão de nomenclatura
Durante o desenvolvimento do WordPress 2.9 as funções relacionadas a miniatura de post, thumbnail, foram nomeadas utilizando o termo image. Posteriormente na versão final as funções foram renomeadas sendo alterada o image por thumbnail.
Logo, o correto é the_post_thumbnail e has_post_thumbnail do que the_post_image ou has_post_image, respectivamente.
Como percebemos as possibilidades em relação a miniatura de posts são diversas, use a criatividade, pesquise e compartilhe novas descobertas conosco.
