get_post_thumbnail_id()


WordPressの関数get_post_thumbnail_id()は、指定された投稿またはページのサムネイル（アイキャッチ画像）のIDを取得するために使用されます。

構文

get_post_thumbnail_id( int|WP_Post $post = null );
  • $post(int|WP_Post) — サムネイルIDを取得したい投稿のIDまたはWP_Postオブジェクト。デフォルトは現在の投稿。

例1: 現在の投稿のサムネイルIDを取得

現在表示されている投稿のサムネイルIDを取得します。

<?php $thumbnail_id = get_post_thumbnail_id(); ?>

例2: 特定の投稿のサムネイルIDを取得

指定された投稿IDのサムネイルIDを取得します。

<?php $thumbnail_id = get_post_thumbnail_id( get_the_ID() ); ?>

例3: サムネイルIDを使用して画像を表示

取得したサムネイルIDを使用して、画像を表示します。

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

例4: サムネイルが存在するか確認

サムネイルが存在するかどうかを確認します。

<?php if ( has_post_thumbnail() ) { $thumbnail_id = get_post_thumbnail_id(); } ?>

例5: カスタム投稿タイプのサムネイルIDを取得

カスタム投稿タイプのサムネイルIDを取得します。

<?php $args = array( 'post_type' => 'custom_post_type', 'posts_per_page' => 1 ); $custom_query = new WP_Query( $args ); if ( $custom_query->have_posts() ) { while ( $custom_query->have_posts() ) { $custom_query->the_post(); $thumbnail_id = get_post_thumbnail_id(); } } wp_reset_postdata(); ?>

例6: サムネイルIDを利用して画像のURLを取得

サムネイルIDを使用して、画像のURLを取得します。

<?php $thumbnail_id = get_post_thumbnail_id(); $image_url = wp_get_attachment_url( $thumbnail_id ); ?>

注意点

  • サムネイルが設定されていない場合、get_post_thumbnail_id()は空の文字列を返します。
  • 投稿IDを指定しない場合、現在のループ内の投稿が対象となります。

関連機能：