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

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

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

提供: WordPress Codex 日本語版
< テンプレートタグ
2010年4月14日 (水) 20:40時点におけるMizuno (トーク | 投稿記録)による版 (翻訳済み。 3.0 の featured image 対応が必要)

移動先: 案内検索

説明

投稿記事/ページ編集画面で設定した投稿サムネイルを取得します。サムネイル画像には、クラス "attachment-thumbnail" が付与されます。

使い方

<?php echo get_the_post_thumbnail( $id, $size, $attr ); ?>

パラメータ

$id
整数) (必須) 投稿 ID.
初期値: なし
$size
整数) (オプション) 画像サイズ
初期値: 'thumbnail'
$attr
整数) (オプション
初期値: なし

用例

使い方の例

<?php $pages = get_pages(array('child_of' => 1)); ?> 
<ul>
	<?php foreach ($pages as $page): ?>
		<li>
			<?php echo get_the_post_thumbnail($page->ID, 'thumbnail'); ?>
			<h1><?=$page->post_title?></h1>
			<?=$page->post_content?>
		</li>
	<?php endforeach; ?>
</ul>

オプション

get_the_post_thumbnail($id);                  // パラメータなし -> サムネイル

get_the_post_thumbnail($id, 'thumbnail');     // サムネイル
get_the_post_thumbnail($id, 'medium');        // 中サイズ
get_the_post_thumbnail($id, 'large');         // 大サイズ

get_the_post_thumbnail($id, array(100,100) ); // 他のサイズ

投稿サムネイルを有効にするには、使用しているテーマの functions.phpadd_theme_support( 'post-thumbnails' ); を追加する必要があります。

変更履歴

  • 2.9 : 新規テンプレートタグ

ソースファイル

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

外部資料

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

関連

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


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