get_post_thumbnail_id()

get_post_thumbnail_id() は、投稿または固定ページに設定されたアイキャッチ画像（サムネイル）の添付ファイル ID を取得するテンプレートタグです。この関数を使うことで、画像の詳細情報を取得したり、カスタム処理に活用できます。

機能の説明

get_post_thumbnail_id() は、指定した投稿のアイキャッチ画像の ID を取得します。この ID を使えば、WordPress の他の画像関連関数（例：wp_get_attachment_image() など）を利用して、画像のURLやメタ情報を取得することが可能です。

引数

$post（オプション）: 投稿の ID または投稿オブジェクト（省略時は現在の投稿が対象）

返り値

アイキャッチ画像の添付ファイル ID（整数値）

シンプルなコード例

<?php 
$thumbnail_id = get_post_thumbnail_id();
echo 'アイキャッチ画像のID: ' . $thumbnail_id;
?>

このコードでは、現在の投稿に設定されているアイキャッチ画像の ID を取得して表示します。

使い方の解説

get_post_thumbnail_id() は、アイキャッチ画像の詳細情報を取得したいときに使用されます。ID を取得した後、さらに wp_get_attachment_image_src() などを使って画像 URL などの情報を取得することが可能です。

get_post_thumbnail_id( int|WP_Post|null $post = null );

• $post が指定されない場合は、現在の投稿が対象となります。
• 特定の投稿や固定ページのアイキャッチ ID を取得するには、その投稿の ID を引数に指定します。

使用例

<?php 
$post_id = 42; // 投稿IDを指定
$thumbnail_id = get_post_thumbnail_id($post_id);
echo '投稿ID 42 のアイキャッチ画像ID: ' . $thumbnail_id;
?>

投稿 ID 42 に設定されたアイキャッチ画像の ID を取得し、画面に表示します。

一緒に使うことが多い関連タグ

wp_get_attachment_image()

wp_get_attachment_image() は、指定された添付ファイルの画像を HTML として出力するテンプレートタグです。
get_post_thumbnail_id() と組み合わせることで、アイキャッチ画像を柔軟に表示できます。

<?php 
$thumbnail_id = get_post_thumbnail_id();
echo wp_get_attachment_image($thumbnail_id, 'medium');
?>

このコードは、現在の投稿のアイキャッチ画像を中サイズで表示します。

使用例

<?php 
$post_id = 42; // 特定の投稿ID
$thumbnail_id = get_post_thumbnail_id($post_id);

if ( $thumbnail_id ) {
    echo wp_get_attachment_image($thumbnail_id, 'thumbnail');
} else {
    echo '<p>アイキャッチ画像が設定されていません。</p>';
}
?>

投稿 ID 42 にアイキャッチ画像が設定されていれば表示し、ない場合はメッセージを表示します。

追加情報を取得したい場合

get_post_thumbnail_id() で取得した ID を使って、添付ファイルのメタ情報や URL を取得することができます。

wp_get_attachment_image_src() で画像 URL を取得

<?php 
$thumbnail_id = get_post_thumbnail_id();
$image_src = wp_get_attachment_image_src($thumbnail_id, 'full');
echo '画像URL: ' . $image_src[0];
?>

このコードでは、アイキャッチ画像のフルサイズの URL を取得し、画面に表示します。

出力できる情報

• [0]：画像の URL
• [1]：画像の幅（ピクセル）
• [2]：画像の高さ（ピクセル）
• [3]：true/false（画像が縮小されているかどうか）

想定されるトラブル

get_post_thumbnail_id() が正しい ID を返さない

投稿にアイキャッチ画像が設定されていない可能性があります。

解決方法

has_post_thumbnail() を使って、画像の有無を事前に確認することを推奨します。

<?php 
if ( has_post_thumbnail() ) {
    $thumbnail_id = get_post_thumbnail_id();
    echo 'アイキャッチ画像ID: ' . $thumbnail_id;
} else {
    echo 'アイキャッチ画像が設定されていません。';
}
?>

カスタム投稿タイプでアイキャッチ画像が取得できない

カスタム投稿タイプにアイキャッチ画像のサポートが有効化されていない可能性があります。

解決方法

functions.php に以下のコードを追加し、アイキャッチ画像サポートを有効化します。

add_post_type_support('custom_post_type', 'thumbnail');

Q&A

<?php 
if ( has_post_thumbnail() ) {
    the_post_thumbnail('medium');
} else {
    echo '<img src="' . get_template_directory_uri() . '/images/default.png" alt="No Image">';
}
?>

まとめ

get_post_thumbnail_id() は、投稿や固定ページに設定されたアイキャッチ画像の添付ファイル ID を取得するためのテンプレートタグです。

この ID を使うことで、wp_get_attachment_image() や wp_get_attachment_image_src() といった関数を利用し、画像の URL やサイズを取得・表示することができます。また、関連するテンプレートタグと組み合わせることで、柔軟な画像管理が可能になります。