get_the_post_thumbnail_caption:WordPress私的マニュアル

を
から

WordPress私的マニュアル : トップ
クラス
グローバル変数・定数
コラム
関数

投稿情報（141）
取得する（311）

get_the_post_thumbnail_caption

(4.6.0以降)
get_the_post_thumbnail_caption - 投稿ページのサムネイルキャプションを取得する

説明

string get_the_post_thumbnail_caption( mixed $post = null )

投稿ページのサムネイル（アイキャッチ画像）キャプションを取得する。

パラメータ

$post
投稿IDまたは投稿情報（WP_Postオブジェクト）を指定（省略時はnull）。

返り値

投稿ページにサムネイルが設定されている場合はそのキャプションを返す。サムネイルが設定されていない場合は''を返す。

注意

パラメータ$postがnull（省略時）の場合は、現在の投稿情報（グローバル変数$post）が適用される。

使用例

現在の投稿ページのサムネイルキャプションを取得する。
```
<?php $caption = get_the_post_thumbnail_caption(); ?>
```

$_postのサムネイルキャプションを取得する。

<?php $caption = get_the_post_thumbnail_caption( $_post ); ?>

フィルター

実行するフィルターはありません。

アクション

実行するアクションはありません。

ソースファイル

/wp-includes/post-thumbnail-template.php

参考

Code Reference: get_the_post_thumbnail_caption

お勧めコンテンツ

WP_Postオブジェクトで投稿情報を直感的に使う（2012年10月4日登録）

WordPress 3.5で登場するであろうWP_Postクラス。WordPressの投稿情報は、投稿情報本体のほか、カテゴリーや投稿タグ、カスタムフィールドなど、いくつかに分散して記録され、それぞれの情報を取得する際は、いくつかの関数をしていた。新しいWP_Postクラスにより、その習慣とおさらばできるかもしれない。

絵文字画像がPNGからSVGへ（2016年8月15日登録）

WordPressでは絵文字に対応していないブラウザ環境で絵文字を表示する仕組みをバージョン4.2から提供。絵文字に対応しているブラウザとそん色がない表示を実現する。

初期化に関連するアクションのおさらい（2012年8月7日登録）

いつも何気なくfunctions.phpで使っているafter_setup_themeアクションやinitアクション。普段はあまり意識していなかったが、ふとしたことからどんな順番に呼び出されるのか気になってしまい、ちょっと調べてみた。

プラグインのヘッダー情報を国際化対応しよう（2017年6月19日登録）

バージョン4.8がリリースされてひと段落。あらためてプラグイン一覧ページを見てみると「Akismet」が「Akismet Anti-Spam (アンチスパム)」と表示されていた。説明文だけじゃなくプラグイン名も国際化対応できたのね。

タイトルのみをキーワード検索する（2014年4月3日登録）

WordPressのキーワード検索は、投稿タイトルと本文のどちらかに指定したキーワードが含まれているかを調べるわけだが、時々タイトルだけとか、逆に本文だけ検索したいケースがある。