Web制作Labが運営するWPマニュアルサイトです

【テンプレートタグ】the_post_thumbnailの使い方を紹介

the_post_thumbnailはアイキャッチ画像を表示する際に使用する関数です。

PHP
the_post_thumbnail();

パラメータ

PHP
the_post_thumbnail( string|int[] $size = 'post-thumbnail', string|array $attr = '' )

「size」パラメータにサイズを入力することで画像のサイズを調整できます。
※デフォルトはpost-thumbnail

thumbnail「サムネイル」で指定したサイズ
デフォルト:150px x 150px(最大値)
medium「中サイズ」で指定したサイズ
デフォルト:300px x 300px(最大値)
large「大サイズ」で指定したサイズ
デフォルト:640px x 640px(最大値)
full画像の元々のサイズ

数値で指定する場合は以下の指定になります。

PHP
the_post_thumbnail( array(150, 150) );

テーマ開発時には下記のようにアイキャッチ画像が登録されていない場合を想定して実装することが多いです。

PHP
<?php if ( has_post_thumbnail() ): ?>
  <?php the_post_thumbnail('large'); ?>
<?php else: ?>
  <img src="<?php echo esc_url( get_template_directory_uri('') ); ?>/assets/img/thumb-sample.jpg" alt="#">
<?php endif; ?>

アイキャッチ画像が登録されていることは「has_post_thumbnail」で確認できます。