WordPressの投稿内でアイキャッチ画像の代替テキストやキャプション等の情報を取得する方法をご紹介いたします。
テーマ制作時に任意の場所にキャプション等を表示したいこともあるかと思いますので、覚えておくと便利です。
WordPressでアイキャッチ画像の代替テキストやキャプション等の情報を取得する方法
アイキャッチ画像に関する、以下の情報を取得する方法をご紹介いたします。
- 画像ID
- タイトル
- 代替テキスト
- キャプション
- 説明
- 画像の横幅
- 画像の高さ
- 画像のURL
具体的な取得方法は、以下の通りです。
//画像ID
$thumbnail_id = get_post_thumbnail_id();
//タイトル
get_post( $thumbnail_id )->post_title;
//代替テキスト
get_post_meta( $thumbnail_id, '_wp_attachment_image_alt', true );
//キャプション
get_post( $thumbnail_id )->post_excerpt;
//説明
get_post( $thumbnail_id )->post_content;
//画像の横幅
wp_get_attachment_image_src( $thumbnail_id, 'full' )[1];
//画像の高さ
wp_get_attachment_image_src( $thumbnail_id, 'full' )[2];
//画像のURL
$thumbnail_url = get_the_post_thumbnail_url();例えば、キャプションを取得して表示させたい場合は、以下のように記述します。
<?php
$thumbnail_id = get_post_thumbnail_id();
$thumb_caption = get_post( $thumbnail_id )->post_excerpt;
?>
<div class="thumb_caption_area"><?php echo $thumb_caption; ?></div>取得した値を変数に代入して出力しています。
あとがき
以前、アイキャッチ画像のURLを取得する方法としてwp_get_attachment_image_src()をご紹介しましたが、URLを取得する場合はget_the_post_thumbnail_url()で簡単に取得できますね。
アイキャッチ画像に紐づく色々な情報を取得したい場合は、ぜひ参考にしていただければと思います。