• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

テンプレートタグ/get post thumbnail id

提供: WordPress Codex 日本語版
移動先: 案内検索
  1. 投稿のアイキャッチ画像(投稿サムネイル)がセットされている場合は、アイキャッチ画像の ID を返す。
  2. アイキャッチ画像がなければ、空文字列を返す。
  3. 投稿が存在しなければ false を返す。

参考: アイキャッチ画像を有効にするには、add_theme_support( 'post-thumbnails' ); をテーマの functions.php/en ファイルに含む必要があります。投稿サムネイルも見てください。

使い方

<?php $post_thumbnail_id = get_post_thumbnail_id( $post_id ); ?>

パラメータ

$post_id
整数) (オプション) 投稿 ID
初期値: null – 現在の投稿

戻り値

(文字列) 
アイキャッチ画像の ID。アイキャッチ画像がなければ空文字列。投稿が存在しなければ false

用例

アイキャッチ画像を除くすべての添付ファイルを表示する

アイキャッチ画像を除く投稿の添付ファイルをすべて取得するには、この関数と一緒に get_posts() などを使います。

この例はループ内で実行してください($post->ID が利用できる状態)。

<?php
$args = array(
    'post_type'   => 'attachment',
    'numberposts' => -1,
    'post_status' => 'any',
    'post_parent' => $post->ID,
    'exclude'     => get_post_thumbnail_id(),
);

$attachments = get_posts( $args );

if ( $attachments ) {
    foreach ( $attachments as $attachment ) {
        echo apply_filters( 'the_title', $attachment->post_title );
        the_attachment_link( $attachment->ID, false );
    }
}
?>

参考

  • 「投稿サムネイル」は「アイキャッチ画像」の古い呼び名です。この関数は投稿のアイキャッチ画像の ID を返します。投稿に添付されている他の画像は、大きさが "thumbnail" であっても返しません。

変更履歴

ソースファイル

get_post_thumbnail_id()wp-includes/post-thumbnail-template.php にあります。

投稿サムネイル: has_post_thumbnail, the_post_thumbnail, get_post_thumbnail_id, get_the_post_thumbnail, add_image_size(), set_post_thumbnail_size()


関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: WordPress Codex » Template Tags/get_post_thumbnail_id最新版との差分