【WordPressテンプレートタグ】the_post_thumbnail():アイキャッチ画像を表示
公開日: : 最終更新日:2016/03/24 テンプレートタグ
概要
記事に設定されたアイキャッチ画像を指定された大きさで表示する。
引数に、管理画面もしくはadd_image_sizeで指定したサイズを指定することで任意の大きさのアイキャッチ画像を表示できる。
書式
パラメーター
- size
- 画像サイズ
- post-thumbnail/set_post_thumbnail_size指定サイズ
- thumbnail/管理画面「サムネイル」(初期値)
- medium/管理画面「中サイズ」
- large/管理画面「大サイズ」
- full/オリジナルの画像サイズ
- add_image_sizeで指定したID名/add_image_sizeで指定したサイズ
- attr
- imgタグに挿入するalt、titleなどの属性値の指定(初期値:なし)
位置
ループ内でのみ使用可能
使用例
初期設定でアイキャッチ画像を表示(初期値:thumbnail)
<?php the_post_thumbnail(); ?>
縦横150pxでアイキャッチ画像を表示
<?php the_post_thumbnail(array(150,150)); ?>
WordPress管理画面「設定」>「メディアの設定」で、あらかじめ設定しているサイズでアイキャッチ画像を表示
<?php // サムネイル(初期値:150px x 150px(最大値)) the_post_thumbnail('thumbnail'); // 中サイズ(初期値:300px x 300px(最大値)) the_post_thumbnail('medium'); // 大サイズ(初期値:640px x 640px(最大値)) the_post_thumbnail('large'); // フルサイズ(オリジナルの画像サイズ) the_post_thumbnail('full'); ?>
投稿にアイキャッチ画像が登録されているかどうかを判別し、アイキャッチ画像がない場合は代替画像を表示
<a href="<?php the_permalink(); ?>"> <?php if(has_post_thumbnail()) : the_post_thumbnail(); else : echo '<img src="' .get_template_directory_uri() .'/images/default.png' ) .'" alt="" />'; endif; ?> </a>

<a href="<?php the_permalink(); ?>"> <img src="http://kajico.kajilabo.net/wp-content/themes/kajico/images/default.png" alt="" /> </a>
MEMO
アイキャッチ画像の新しいサイズを登録したい場合:add_image_size()
「thumbnail」の初期値を変更したい場合:set_post_thumbnail_size()
をfunctions.phpに追記する。
関連
- wordpressのテンプレートタグ一覧
- has_post_thumbnail()
- get_post_thumbnail_id()
- get_the_post_thumbnail()
関連記事
-
-
【WordPressテンプレートタグ】the_author_posts_link():作成者別アーカイブへのリンクを表示
概要 投稿の作成者別アーカイブへのリンクを表示する。 「ユーザー」>「あなたのプロフィール」>「ブロ...
-
-
【WordPressインクルードタグ】get_header():「header.php」を読み込む
概要 テンプレートファイル「header.php」を読み込む 書式 <?php get_hea...
-
-
【WordPressテンプレートタグ】the_meta():記事のカスタムフィールドの値をリスト形式で表示
概要 現在の記事のカスタムフィールドに記載した値をリスト形式で表示する。 書式 <?php t...
-
-
【WordPressテンプレートタグ】comment_author_email_link():コメント投稿者のメールアドレスを、mailto:リンクとして表示
概要 コメント投稿者のメールアドレスをmailto:リンクとして表示する。 管理画面「設定」>「ディ...
-
-
【WordPressテンプレートタグ】the_author_link():作成者のウェブサイトへのリンクを表示
概要 作成者のウェブサイトへのリンクを表示する。ウェブサイトの設定がない場合は作成者名のみ表示する。...
-
-
【WordPressテンプレートタグ】get_calendar():日別アーカイブへのリンク付きカレンダーを表示または取得
概要 投稿のあった日を日別アーカイブへのリンクとしたカレンダーを表示、または文字列として取得する。 ...
-
-
【WordPressテンプレートタグ】wp_logout_url():ログアウトURLを取得
概要 ログアウトURLを文字列として取得する。省略時はログインフォームへ。 書式 <?php ...
-
-
【WordPressテンプレートタグ】the_title_attribute():属性値用の記事タイトルを表示または取得
概要 属性値用の記事タイトルを表示、または文字列として取得する。 記事タイトル部分にHTMLタグを含...
-
-
【WordPressテンプレートタグ】the_author():作成者名を表示
概要 投稿の作成者名を表示する。 書式 <?php the_author(); ?&...
-
-
【WordPressテンプレートタグ】single_month_title():月別アーカイブのタイトルを表示または取得
概要 カテゴリーアーカイブページでのカテゴリータイトルを表示または取得する。 「11月2015」のよ...