2024年07月01日
WP関数:get_the_post_thumbnail()
この関数の説明
WP関数の get_the_post_thumbnail() は、指定した投稿IDに設定されているアイキャッチ画像(サムネール)のデータを取得します。
※エスケープ処理された<img>タグが取得できます。
関数
get_the_post_thumbnail( $post_id, $size, $attr )
パラメータ
$post_id(整数)(オプション)
投稿 IDを指定します。
省略した場合は、現在の投稿になります。
$size(文字列 | 配列)(オプション)
表示する画像サイズを指定します。
省略した場合は set_post_thumbnail_size() で指定したサイズ
・キーワード指定場合
'thumbnail', 'medium', 'large', 'full'
・直接指定(幅、高さ)する場合
array( 150, 150 )
$attr(配列)(オプション)
アイキャッチ画像を<img>タグで表示する時の属性/値を配列で記述します。
利用方法は the_post_thumbnail() を参照してください。
戻り値
エスケープ処理された<img>タグが戻ります。
アイキャッチ画像が設定されてない場合はnullが返されます。
利用事例
①アイキャッチ画像(サムネール)が設定されていた場合は表示します。
<?php $thumbnail = get_the_post_thumbnail(get_the_ID() , array( 300, 300 )); if( $thumbnail !== null){ echo $thumbnail; } ?>
■2行目:サムネールをサイズ指定で取得しています。
■3行目:サムネールが設定されているか否かを判定しています。
■4行目:サムネールがあった場合は表示しています。
関連情報
関連関数は アイキャッチ関連関数 を参照してください.