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

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

関数リファレンス/has post thumbnail

提供: WordPress Codex 日本語版
移動先: 案内検索

投稿にアイキャッチ画像(以前は投稿サムネイルと呼ばれていました)が登録されているかどうかをチェックする関数です。

参考: アイキャッチ画像を有効にするには、add_theme_support( 'post-thumbnails' ); をテーマの functions.php/en ファイルに含む必要があります。投稿サムネイルのページも参照してください。

使い方

<?php has_post_thumbnail( $post_id ); ?>

パラメータ

$post_id
整数) (オプション) 投稿 ID
初期値: null – 現在の投稿

戻り値

(真偽値) 
アイキャッチ画像が付いていれば true を、付いていなければ false を返す。

用例

この例は、まず、ループ内の現在の項目(投稿など)に投稿サムネイル(アイキャッチ画像)が付いているかチェックします。付いていればそれを表示します。付いていなければ、現在のテーマの images フォルダーにあるデフォルト画像を表示します(そのフォルダーはテーマのルートディレクトリにあるとします)。

<?php
// ループの中で使用します。

if ( has_post_thumbnail() ) {
	the_post_thumbnail();
}
else {
	echo '<img src="' . get_bloginfo( 'stylesheet_directory' ) . '/images/thumbnail-default.jpg" />';
}
?>

set_post_thumbnail_size() を使えばアイキャッチ画像のデフォルトの大きさを設定できます。別の方法として、add_image_size() を使えばデフォルト以外の画像サイズを追加できます。

変更履歴

ソースファイル

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

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


条件分岐タグis_404(), is_admin(), is_admin_bar_showing(), is_archive(), is_attachment(), is_author(), is_category(), is_comments_popup(), is_date(), is_day(), is_feed(), is_front_page(), is_home(), is_local_attachment(), is_main_query, /is_multi_author, is_month(), is_new_day(), is_page(), is_page_template(), is_paged(), is_plugin_active(), is_plugin_active_for_network() /en, is_plugin_inactive() /en, is_plugin_page() /en, is_post_type_archive(), is_preview() /en, is_search(), is_single(), is_singular(), is_sticky(), is_tag(), is_tax(), is_taxonomy_hierarchical(), is_time(), is_trackback(), is_year(), in_category(), in_the_loop(), is_active_sidebar(), is_active_widget(), is_blog_installed() /en, is_rtl(), is_dynamic_sidebar(), is_user_logged_in(), has_excerpt(), has_post_thumbnail(), has_tag(), pings_open(), email_exists(), post_type_exists(), taxonomy_exists(), term_exists(), username_exists() /en, wp_attachment_is_image(), wp_script_is()


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


最新英語版: WordPress Codex » Function Reference/has_post_thumbnail最新版との差分