【WordPressテンプレートタグ】the_post_thumbnail()：アイキャッチ画像を表示

概要

記事に設定されたアイキャッチ画像を指定された大きさで表示する。
引数に、管理画面もしくはadd_image_sizeで指定したサイズを指定することで任意の大きさのアイキャッチ画像を表示できる。

書式

パラメーター

位置

ループ内でのみ使用可能

使用例

初期設定でアイキャッチ画像を表示(初期値：thumbnail)

<?php the_post_thumbnail(); ?>

縦横150pxでアイキャッチ画像を表示

<?php the_post_thumbnail(array(150,150)); ?>

WordPress管理画面「設定」＞「メディアの設定」で、あらかじめ設定しているサイズでアイキャッチ画像を表示

<?php
// サムネイル(初期値：150px x 150px(最大値))
the_post_thumbnail('thumbnail');
// 中サイズ(初期値：300px x 300px(最大値))
the_post_thumbnail('medium');
// 大サイズ(初期値：640px x 640px(最大値))
the_post_thumbnail('large');
// フルサイズ(オリジナルの画像サイズ)
the_post_thumbnail('full');
?>

投稿にアイキャッチ画像が登録されているかどうかを判別し、アイキャッチ画像がない場合は代替画像を表示

<a href="<?php the_permalink(); ?>">
<?php if(has_post_thumbnail()) :
the_post_thumbnail();
else :
echo '<img src="' .get_template_directory_uri() .'/images/default.png' ) .'" alt="" />';
endif; ?>
</a>

<a href="<?php the_permalink(); ?>">
<img src="http://kajico.kajilabo.net/wp-content/themes/kajico/images/default.png" alt="" />
</a>

MEMO

アイキャッチ画像の新しいサイズを登録したい場合：add_image_size()
「thumbnail」の初期値を変更したい場合：set_post_thumbnail_size()
をfunctions.phpに追記する。

関連

• wordpressのテンプレートタグ一覧
• has_post_thumbnail()
• get_post_thumbnail_id()
• get_the_post_thumbnail()