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

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

「関数リファレンス/has post thumbnail」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(整形・リンク調整、試験的にテーマテンプレートガイドを挿入、未翻訳)
(en:Function Reference/has_post_thumbnail 16:48, 30 October 2014 Stevejohnson 版を反映。)
 
(3人の利用者による、間の7版が非表示)
1行目: 1行目:
{{テンプレートタグガイド|PHP}}
+
<div id="Description">
 
== 説明 ==
 
== 説明 ==
 +
</div>
  
Returns a boolean if post has an image attached (true) or not (false).
+
投稿にアイキャッチ画像(以前は[[投稿サムネイル]]と呼ばれていました)が登録されているかどうかをチェックする関数です。
  
'''Note:''' To enable post thumbnails, the current theme must include <code>add_theme_support( 'post-thumbnails' );</code> in its <tt>[[テーマの作成#Theme Functions File|functions.php]]</tt> file.
+
'''参考:''' アイキャッチ画像を有効にするには、<code>[[関数リファレンス/add theme support|add_theme_support]]( 'post-thumbnails' );</code> をテーマの <tt>[[テーマの作成#Theme_Functions_File|functions.php]]</tt>/[[:en:Theme_Development#Functions_File|en]] ファイルに含む必要があります。[[投稿サムネイル]]のページも参照してください。
  
 +
<div id="Usage">
 
== 使い方 ==
 
== 使い方 ==
 +
</div>
  
 
  <?php has_post_thumbnail( $post_id ); ?>
 
  <?php has_post_thumbnail( $post_id ); ?>
  
== Parameters ==<!-- Parameters -->
+
<div id="Parameters">
 +
== パラメータ ==
 +
</div>
  
{{Parameter|$post_id|整数|Post ID.|任意|'ID', the post ID.}}
+
{{Parameter|$post_id|整数|投稿 ID|オプション|null &ndash; 現在の投稿}}
  
== 用例 ==<!-- Examples -->
+
== 戻り値 ==
This script asks if there is, actually, a thumbnail in the post. If it's not, it will put a default image.
+
 
 +
; (真偽値) : アイキャッチ画像が付いていれば <tt>true</tt> を、付いていなければ <tt>false</tt> を返す。
 +
 
 +
<div id="Examples">
 +
== 用例 ==
 +
</div>
 +
 
 +
この例は、まず、[[ループ]]内の現在の項目(投稿など)に[[投稿サムネイル]](アイキャッチ画像)が付いているかチェックします。付いていればそれを表示します。付いていなければ、現在のテーマの <tt>images</tt> フォルダーにあるデフォルト画像を表示します(そのフォルダーはテーマのルートディレクトリにあるとします)。
  
 
<pre>
 
<pre>
<?php  
+
<?php
//This must be in one loop
+
// ループの中で使用します。
  
if(has_post_thumbnail()) {
+
if ( has_post_thumbnail() ) {
 
the_post_thumbnail();
 
the_post_thumbnail();
} else {
+
}
echo '<img src="'.get_bloginfo("template_url").'/images/img-default.png" />';
+
else {
 +
echo '<img src="' . get_bloginfo( 'stylesheet_directory' ) . '/images/thumbnail-default.jpg" />';
 
}
 
}
 
?>
 
?>
 
</pre>
 
</pre>
  
== 変更履歴 ==<!-- Changelog -->
+
[[関数リファレンス/set_post_thumbnail_size|set_post_thumbnail_size()]] を使えばアイキャッチ画像のデフォルトの大きさを設定できます。別の方法として、[[関数リファレンス/add_image_size|add_image_size()]] を使えばデフォルト以外の画像サイズを追加できます。
  
* [[Version 2.9|2.9.0]] : 新規テンプレートタグ
+
<div id="Changelog">
 +
== 変更履歴 ==
 +
</div>
  
== ソースファイル ==<!-- Source File -->
+
* [[Version 2.9|2.9.0]] : 新規導入
  
<tt>has_post_thumbnail()</tt> is located in {{Trac|wp-includes/post-thumbnail-template.php}}.
+
<div id="Source_File">
 +
== ソースファイル ==
 +
</div>
  
{{原文|Template Tags/has_post_thumbnail|82659}}<!-- 18:08, 4 February 2010 Kyuumeitai 版 -->
+
<tt>has_post_thumbnail()</tt> は {{Trac|wp-includes/post-thumbnail-template.php}} にあります。
  
== 関連 ==<!-- Related -->
+
<div id="Related">
 +
== 関連項目 ==
 +
</div>
  
 
{{Post Thumbnail Tags}}
 
{{Post Thumbnail Tags}}
 +
 +
{{Conditional Tags}}
 
{{Tag Footer}}
 
{{Tag Footer}}
 +
 +
{{原文|Function Reference/has_post_thumbnail|147717}} <!-- 16:48, 30 October 2014 Stevejohnson 版 -->
  
 
{{DEFAULTSORT:Has_post_thumbnail}}
 
{{DEFAULTSORT:Has_post_thumbnail}}
 +
[[Category:条件分岐タグ]]
 
[[Category:wp2.9]]
 
[[Category:wp2.9]]
  
[[en:Template Tags/has_post_thumbnail]]
+
[[en:Function Reference/has_post_thumbnail]]
 +
[[it:Riferimento funzioni/has_post_thumbnail]]

2015年6月7日 (日) 15:18時点における最新版

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

参考: アイキャッチ画像を有効にするには、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最新版との差分