【WordPressテンプレートタグ】get_the_post_thumbnail():アイキャッチ画像を取得
公開日: : 最終更新日:2016/03/24 テンプレートタグ
概要
アイキャッチ画像のimgタグを取得する。
書式
パラメーター
- post_id
- 記事ID(初期値:null)
- size
- サイズ(初期値:post-thumbnail)
- attr
- imgタグに挿入するalt、titleなどの属性値の指定(初期値:なし)
attrの設定
'src' => '任意src', // アイキャッチ画像の URL
'class' => '任意class' // クラス名
'alt' => '任意alt' // アイキャッチ画像のalt属性
'title' => '任意title' // アイキャッチ画像のtitle属性
);
位置
記事IDを指定すれば、ループ外でも使用可能。
使用例
初期設定でアイキャッチ画像を表示(初期値:thumbnail)
<?php echo get_the_post_thumbnail(); ?>
縦横150pxでアイキャッチ画像を表示
<?php echo get_the_post_thumbnail( $page->ID, array(150,150)); ?>
WordPress管理画面「設定」>「メディアの設定」で、あらかじめ設定しているサイズでアイキャッチ画像を表示
<?php // ↓サムネイル(初期値:150px x 150px(最大値)) echo get_the_post_thumbnail( $page->ID, 'thumbnail'); // ↓中サイズ(初期値:300px x 300px(最大値)) echo get_the_post_thumbnail( $page->ID, 'medium'); // ↓大サイズ(初期値:640px x 640px(最大値)) echo get_the_post_thumbnail( $page->ID, 'large'); // ↓フルサイズ(オリジナルの画像サイズ) echo get_the_post_thumbnail( $page->ID, 'full'); ?>
アイキャッチ画像のHTMLテキストをclass属性(photo)を指定して取得。
<?php echo get_the_post_thumbnail( $page->ID, 'thumbnail', 'class=photo' ); ?>
もしくは、
<?php echo get_the_post_thumbnail( $page->ID, 'thumbnail', array( 'class'=>'photo' )); ?>
属性値を複数指定するときは後者で。
MEMO
<?php the_post_thumbnail(); ?>はループ内でしか使用できないため、ループ外で使用したいときは<?php echo get_the_post_thumbnail(); ?>を使用する。
関連
- wordpressのテンプレートタグ一覧
- has_post_thumbnail()
- get_post_thumbnail_id()
- the_post_thumbnail()
関連記事
-
-
【WordPressテンプレートタグ】next_post_link():次の投稿ページへのリンクを表示
概要 表示している記事より公開日が1つ後(新しい)の記事へのリンクを表示する。 書式 <?ph...
-
-
【WordPressテンプレートタグ】the_category():カテゴリー名とリンクを表示
概要 記事が属するカテゴリー名とリンクを表示する 書式 <?php the_category(...
-
-
【WordPressテンプレートタグ】next_posts_link():次のアーカイブへのリンクを表示
概要 記事一覧ページ(メインページ・アーカイブページ・カテゴリーなど)の次ページ(日付の古い記事一覧...
-
-
【WordPressテンプレートタグ】the_permalink():記事のパーマリンクのURLを表示
概要 投稿や固定ページなど記事詳細ページへのURLを表示する 書式 <?php the_per...
-
-
【WordPressテンプレートタグ】get_the_date():記事の公開日を取得
概要 現在の記事の公開日を取得する。 書式 <?php get_the_date('forma...
-
-
【WordPressインクルードタグ】get_search_form():「searchform.php」を使用して検索フォームを表示または取得
概要 検索フォームを表示、または文字列として取得する。 テーマにテンプレートファイル「searchf...
-
-
【WordPressテンプレートタグ】single_cat_title():カテゴリーアーカイブのタイトルを表示または取得
概要 カテゴリーアーカイブページでのカテゴリータイトルを表示または取得する。 書式 <?php...
-
-
【WordPressテンプレートタグ】get_edit_post_link():記事やページの編集画面へのURLを取得
概要 現在の記事やページの編集画面へのURLを取得する。wordpressにログインしていない場合は...
-
-
【WordPressテンプレートタグ】previous_post_link():前の投稿ページへのリンクを表示
概要 表示している記事より公開日が1つ前(古い)の記事へのリンクを表示する。 書式 <?php...
-
-
【WordPressテンプレートタグ】get_calendar():日別アーカイブへのリンク付きカレンダーを表示または取得
概要 投稿のあった日を日別アーカイブへのリンクとしたカレンダーを表示、または文字列として取得する。 ...