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

wordpress テンプレートタグ

概要

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

書式

<?php the_post_thumbnail( ‘size’,’attr’ ); ?>

パラメーター

size
画像サイズ

  • post-thumbnail/set_post_thumbnail_size指定サイズ
  • thumbnail/管理画面「サムネイル」(初期値)
  • medium/管理画面「中サイズ」
  • large/管理画面「大サイズ」
  • full/オリジナルの画像サイズ
  • add_image_sizeで指定したID名/add_image_sizeで指定したサイズ
attr
imgタグに挿入するalt、titleなどの属性値の指定(初期値:なし)

位置

ループ内でのみ使用可能

使用例

初期設定でアイキャッチ画像を表示(初期値: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>
yaji_w200h50
<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に追記する。

関連

コメント

タイトルとURLをコピーしました