説明
パラメータ
- $post_id投稿情報IDを指定(省略時はnull)。
返り値
アイキャッチ画像として設定されているアタッチメント情報のIDを返す。アイキャッチ画像が設定されていない場合は''を返す。
[5.5.0]アイキャッチ画像が設定されていない場合は''ではなくfalseを返すように変更された。
注意
パラメータ$post_idを省略した場合はnullが適用され、現在の投稿情報のアイキャッチ画像のIDを取得する。
なお、以下に示す add_theme_support関数にてテーマがアイキャッチ画像をサポートしていないと本関数を含めアイキャッチ画像関連関数は未定義となるので、注意が必要である。
使用例
- アイキャッチ画像(サムネイル)のIDを取得する。<?php $thumbnail_id = get_post_thumbnail_id( ); ?>
フィルター
[5.9.0]アイキャッチ画像のIDを返す前に'post_thumbnail_id'フィルターを呼び出す。パラメータ$thumbnail_idにはアイキャッチ画像のIDが、$postには対象の投稿オブジェクトが格納されている。return (int) apply_filters( 'post_thumbnail_id', $thumbnail_id, $post );
アクション
実行するアクションはありません。ソースファイル
/wp-includes/post-thumbnail-template.php最終更新 : 2023年06月02日 16:59
関連
お勧め
CSSやJavaScriptファイルのバージョン番号を変える(2018年5月27日 更新)
WordPress 4.7系の脆弱性をついた攻撃も落ち着いた感じなので、標準でヘッダーやフッター内に出力されるWordPressのバージョン番号について一考しました。
テーブルブロックを投稿メタ(カスタムフィールド)に保存する(2022年1月5日 更新)
ふと「テーブルブロックの内容を投稿メタ(カスタムフィールド)として保存できたら便利なのでは」と思い、投稿メタの使い方を調べてみた。
カスタム投稿タイプの投稿保存には専用アクションを使おう(2014年7月4日 更新)
カスタム投稿タイプを登録して、専用ウィジェット(meta_box)を使って拡張情報を入力させ、それらの情報をsave_postアクションで保存する。これまではこんな感じだったのだが、久しぶりにカスタム投稿タイプを使ったら、save_postアクションの前にsave_postに投稿タイプ名がくっついたアクションが追加されていた。
Fotepo:プラグイン作ってみました(2019年9月19日 更新)
仕事柄、Chromeの「デベロッパーツール」を使ってページのフォントを変更することがある。そんな時、無効なフォント名を指定してしまったり、フォント名をまちがえることがあり、もう少しお手軽にできないかと思って作ったのが今回紹介するプラグイン「Fotepo」である。
5.3への準備:投稿写真を使っているサイトは準備しておこう(2019年10月10日 更新)
この記事は先日公開した「5.3の新機能:JPEG画像の向きを調整」の続きのようなものになる。高解像度の投稿写真を扱っているサイトは、5.3のリリースに合わせて対応を検討しておくべきことをまとめてみた。