- サイトデザイン工事中です。ご意見をお寄せください。
- 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。（詳細）
テンプレートタグ/the post thumbnail
提供：WordPress Codex 日本語版
< テンプレートタグ
このページ「テンプレートタグ/the post thumbnail」は未翻訳です。和訳や日本語情報を加筆してくださる協力者を求めています。
タグ一覧： テンプレートタグ | インクルードタグ | 条件分岐タグ | その他の関数 | phpdoc
使い方： テンプレートタグ入門 | パラメータの渡し方 | 初心者の方へ | その他のテーマ関連資料
目次 |
説明
投稿編集画面で設定すると、投稿サムネイルを表示します。サムネイル画像には "attachment-thumbnail" クラスが付与されます。
投稿サムネイルを有効にするには、使用しているテーマの functions.php ファイルに add_theme_support( 'post-thumbnails' ); を追加する必要があります。投稿サムネイルも参照してください。
使い方
<?php the_post_thumbnail( $size, $attr ); ?>
パラメータ
- size
- （整数/配列） （任意） 画像サイズ。
- 初期値： post-thumbnail。テーマ(の functions.php)で
set_post_thumbnail_size( $width, $height, $crop_flag );で設定可能。明示的に指定するときはキーワード(thumbnail, medium, large, full) または幅と高さをピクセルで指定する要素 2 つの配列、例えば array(32,32)。
- 初期値： post-thumbnail。テーマ(の functions.php)で
- attr
- （配列） （任意）
- 初期値： なし
用例
デフォルトの使用例
<?php the_post_thumbnail(); ?> <?php the_content(); ?>
オプション
the_post_thumbnail(); // パラメータなし -> サムネイル
the_post_thumbnail('thumbnail'); // サムネイル
the_post_thumbnail('medium'); // 中サイズ
the_post_thumbnail('large'); // 大サイズ
the_post_thumbnail( array(100,100) ); // 他のサイズ
変更履歴
- 2.9.0 : 新規テンプレートタグ
ソースファイル
外部資料
- 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/the_post_thumbnail （最新版との差分）
Related
has_post_thumbnail, the_post_thumbnail, get_post_thumbnail_id, get_the_post_thumbnail
