- サイトデザイン工事中です。ご意見をお寄せください。
- 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。（詳細）
テンプレートタグ/get the post thumbnail
提供：WordPress Codex 日本語版
< テンプレートタグ
タグ一覧： テンプレートタグ | インクルードタグ | 条件分岐タグ | その他の関数 | phpdoc
使い方： テンプレートタグ入門 | パラメータの渡し方 | 初心者の方へ | その他のテーマ関連資料
目次 |
説明
投稿記事/ページ編集画面で設定した投稿サムネイルを取得します。サムネイル画像には、クラス "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><?php echo $page->post_title; ?></h1>
<?php echo $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.php に add_theme_support( 'post-thumbnails' ); を追加する必要があります。
変更履歴
- 2.9 : 新規テンプレートタグ
ソースファイル
get_the_post_thumbnail() は、wp-includes/post-thumbnail-template.php にあります。
外部資料
- Everything you need to know about WordPress 2.9’s post image feature, by JustintAdlock.com
- The Ultimative Guide For the_post_thumbnail In WordPress 2.9, by wpEngineer.com
最新英語版： WordPress Codex » Template Tags/get_the_post_thumbnail （最新版との差分）
関連
has_post_thumbnail, the_post_thumbnail, get_post_thumbnail_id, get_the_post_thumbnail
