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

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

「関数リファレンス/is single」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(全体を和訳。)
(てにをは見直し。クリーンアップ。)
 
(3人の利用者による、間の6版が非表示)
3行目: 3行目:
 
</div>
 
</div>
  
この [[条件分岐タグ|条件分岐タグ]] は、現在個別の記事を表示しているかどうかをチェックします。
+
この [[条件分岐タグ|条件分岐タグ]] は、添付ファイルや固定ページを除く個別の投稿を表示しているかどうかをチェックします。もし <tt>$post</tt> パラメータが指定されていれば、指定された投稿が表示中であることを追加でチェックします。すべての投稿(種類を問わず)を対象とするには、<tt>[[関数リファレンス/is singular|is_singular()]]</tt> 関数を使ってください。
  
 
<div id="Usage">
 
<div id="Usage">
9行目: 9行目:
 
</div>
 
</div>
  
  <?php is_single($post); ?>
+
  <?php is_single( $post ); ?>
  
 
<div id="Parameters">
 
<div id="Parameters">
15行目: 15行目:
 
</div>
 
</div>
  
{{Parameter|$post|mixed|記事 ID、記事タイトル、記事スラッグ またはそれらの配列。|オプション}}
+
{{Parameter|$post|整数/文字列/配列|投稿の ID、タイトル、スラッグ、またはそれらの配列 (WP 2.5+)。|オプション}}
  
 
<div id="Return_Values">
 
<div id="Return_Values">
21行目: 21行目:
 
</div>
 
</div>
  
; <tt>(真偽値)</tt> : (指定した)個別記事を表示している場合は <tt>true</tt>,それ以外は <tt>false</tt>。
+
; <tt>(真偽値)</tt> : (指定した)個別投稿を表示している場合は <tt>true</tt>,それ以外は <tt>false</tt>。
  
 
<div id="Examples">
 
<div id="Examples">
28行目: 28行目:
  
 
  is_single();
 
  is_single();
  // 個別記事のページが表示されている場合。
+
  // 任意の個別投稿のページが表示中。
 
   
 
   
  is_single('17');
+
  is_single( '17' );
  // ID 17の記事が表示されている場合。
+
  // ID 17 の投稿が表示中。
 
   
 
   
  is_single('Irish Stew');
+
  is_single( 17 );
  // "Irish Stew" というタイトルの記事が表示されている場合。
+
  // ID 17 の投稿が表示中。17という整数パラメータも使えます。
 
   
 
   
  is_single('beef-stew');
+
  is_single( 'Irish Stew' );
  // "beef-stew" という投稿スラッグの記事が表示されている場合。
+
  // "Irish Stew" というタイトルの投稿が表示中。
 
   
 
   
  is_single(array(17,'beef-stew','Irish Stew'));
+
is_single( 'beef-stew' );
  // ID が 17、投稿スラッグが "beef-stew"、またはタイトルが "Irish Stew" のいずれかにあてはまる記事が表示されている場合。
+
// "beef-stew" というスラッグの投稿が表示中。
 +
 +
  is_single( array( 17, 'beef-stew', 'Irish Stew' ) );
 +
  // ID が 17、スラッグが "beef-stew"、またはタイトルが "Irish Stew" のいずれかにあてはまる投稿が表示中。
 +
// 配列を引数に使えるのは [[Version 2.5|バージョン 2.5]] からです。
  
== ==
+
<div id="Note">
 +
== 参考 ==
 
</div>
 
</div>
  
* 配列を引数に使えるのは [[Version 2.5|バージョン 2.5]] からです。
+
* [[関数リファレンス/is singular|is_singular()]] もご覧ください。
* [[関数リファレンス/is singular|is_singular()]] も見てください。
+
 
 +
* ふつう <tt>is_single()</tt> は添付ファイルのページについても true を返しますが、この動作に依存すべきではありません。<tt>[[関数リファレンス/is_page|is_page()]]</tt> と <tt>[[関数リファレンス/is_attachment|is_attachment()]]</tt> が同時に true になる場合があり、そのときは <tt>is_single()</tt> が false になります。この理由から、添付ファイルも対象にしたければ <code>is_attachment() || is_single()</code> を、固定ページも含めたければ <code>is_singular()</code> を使うべきです。
  
 
<div id="Change_Log">
 
<div id="Change_Log">
61行目: 67行目:
  
 
<div id="Related">
 
<div id="Related">
== 関連資料 ==
+
== 関連項目 ==
 
</div>
 
</div>
  
67行目: 73行目:
  
 
{{Tag Footer}}
 
{{Tag Footer}}
{{原文|Function Reference/is single|84047}}<!-- 13:53, 14 March 2010 Milardovich -->
+
 
[[Category:Conditional Tags]]
+
{{原文|Function Reference/is single|149842}} <!--13:22, 27 February 2015 Jdgrimes  -->
[[Category:Functions]]
+
 
 +
{{DEFAULTSORT:Is_single}}
 +
[[Category:条件分岐タグ]]
 +
[[Category:関数]]
 +
 
 
[[en:Function_Reference/is_single]]
 
[[en:Function_Reference/is_single]]
 
[[tr:Fonksiyon_Listesi/is_single]]
 
[[tr:Fonksiyon_Listesi/is_single]]
 
[[es:Function_Reference/is_single]]
 
[[es:Function_Reference/is_single]]

2016年4月17日 (日) 13:26時点における最新版

この 条件分岐タグ は、添付ファイルや固定ページを除く個別の投稿を表示しているかどうかをチェックします。もし $post パラメータが指定されていれば、指定された投稿が表示中であることを追加でチェックします。すべての投稿(種類を問わず)を対象とするには、is_singular() 関数を使ってください。

使い方

<?php is_single( $post ); ?>

パラメータ

$post
整数/文字列/配列) (オプション) 投稿の ID、タイトル、スラッグ、またはそれらの配列 (WP 2.5+)。
初期値: なし

戻り値

(真偽値) 
(指定した)個別投稿を表示している場合は true,それ以外は false

用例

is_single();
// 任意の個別投稿のページが表示中。

is_single( '17' );
// ID 17 の投稿が表示中。

is_single( 17 );
// ID 17 の投稿が表示中。17という整数パラメータも使えます。

is_single( 'Irish Stew' );
// "Irish Stew" というタイトルの投稿が表示中。

is_single( 'beef-stew' );
// "beef-stew" というスラッグの投稿が表示中。

is_single( array( 17, 'beef-stew', 'Irish Stew' ) );
// ID が 17、スラッグが "beef-stew"、またはタイトルが "Irish Stew" のいずれかにあてはまる投稿が表示中。
// 配列を引数に使えるのは バージョン 2.5 からです。

参考

  • ふつう is_single() は添付ファイルのページについても true を返しますが、この動作に依存すべきではありません。is_page()is_attachment() が同時に true になる場合があり、そのときは is_single() が false になります。この理由から、添付ファイルも対象にしたければ is_attachment() || is_single() を、固定ページも含めたければ is_singular() を使うべきです。

変更履歴

ソースファイル

is_single()wp-includes/query.php に含まれています。

条件分岐タグ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/is single最新版との差分