当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(英語版をコピペ)
 
(日本語化完了)
1行目: 1行目:
==Description==
+
<div id="Description">
This [[Conditional Tags|conditional tag]] checks if a singular post is being displayed, which is the case when one of the following returns ''true'': <tt>[[Function Reference/is single|is_single()]]</tt>, <tt>[[Function Reference/is page|is_page()]]</tt> or <tt>[[Function Reference/is attachment|is_attachment()]]</tt>. If the <tt>$post_types</tt> parameter is specified, the function will additionally check if the [[Glossary#Query|query]] is for one of the post types specified.
+
== 説明 ==
 +
</div>
 +
 
 +
この [[条件分岐タグ|条件分岐タグ]] は、個別の記事を表示しているかどうかをチェックします。これは以下の関数のいづれかが''true''を返すことと同義となります。
 +
*<tt>[[関数リファレンス/is single|is_single()]]</tt>
 +
*<tt>[[関数リファレンス/is page|is_page()]]</tt>
 +
*<tt>[[関数リファレンス/is attachment|is_attachment()]]</tt>
 +
 
 +
もし<tt>$post_types</tt>パラメーターが指定されている場合、それが投稿種類の1つの為の[[Glossary#クエリ文字列|クエリ]]であるかを追加でチェックします。
 +
 
 +
<div id="Usage">
 +
== 使い方 ==
 +
</div>
  
==Usage==
 
 
  <?php is_singular( $post_types ); ?>
 
  <?php is_singular( $post_types ); ?>
  
==Parameters==
+
<div id="Parameters">
{{Parameter|$post_types|string/array|Post type or types to check in current query.|optional}}
+
== パラメータ ==
 +
</div>
  
==Return Values==
+
{{Parameter|$post_types|string/array|記事の種類または今のqueryでチェックすべき種類|オプション}}
{{Return||boolean|''True'' on success, ''false'' on failure}}.
+
  
==Examples==
+
<div id="Return_Values">
 +
== 戻り値 ==
 +
</div>
  
===Different Sidebar Ads in Singular Page===
+
; <tt>(真偽値)</tt> : 個別記事を表示している場合は <tt>true</tt>,それ以外は <tt>false</tt>。
  <?php
+
 
 +
<div id="Examples">
 +
== 用例 ==
 +
</div>
 +
 
 +
=== 個別ページに異なるサイドバー広告を表示する場合 ===
 +
  &lt;?php
 
  if ( is_singular() ) {
 
  if ( is_singular() ) {
 
   // show adv. #1
 
   // show adv. #1
20行目: 39行目:
 
   // show adv. #2
 
   // show adv. #2
 
  }
 
  }
  ?>
+
  ?&gt;
  
===Custom Post Types===
+
=== カスタム投稿タイプ ===
When any of the following return true: <tt>is_single()</tt>, <tt>is_page()</tt> or <tt>is_attachment()</tt>.
+
これらの関数が''true''を返してきた時: <tt>is_single()</tt>, <tt>is_page()</tt> or <tt>is_attachment()</tt>.
  
 
  is_singular();
 
  is_singular();
  
True when viewing a post of the [[Post Types|Custom Post Type]] book.
+
[[投稿タイプ|カスタム投稿タイプ]]''book''の投稿を見ている時に''true''となる。
  
 
  is_singular('book');
 
  is_singular('book');
  
True when viewing a post of the [[Post Types|Custom Post Type]] newspaper or book.
+
[[投稿タイプ|カスタム投稿タイプ]]の''newspaper''または''book''の投稿を見ている時に''true''となる。
  
 
  is_singular(array( 'newspaper', 'book' ));
 
  is_singular(array( 'newspaper', 'book' ));
 +
  
==Notes==
+
<div id="Notes">
 +
== 注 ==
 +
</div>
  
==Change Log==
+
<div id="Change_Log">
* Since: [[Version 1.5|1.5.0]]
+
== 変更履歴 ==
* [[Version 3.0|3.0.0]]: <tt>$post_types</tt> parameter was added.
+
</div>
  
==Source File==
+
* [[Version 1.5|1.5]] : 新規導入
 +
* [[Version 3.0|3.0.0]]: <tt>$post_types</tt> パラメーター追加。
 +
 
 +
<div id="Source_File">
 +
== ソースファイル ==
 +
</div>
 
<!-- Need links to current source code files -->
 
<!-- Need links to current source code files -->
<tt>is_singular()</tt> is located in {{Trac|wp-includes/query.php}}.
+
<tt>is_singular()</tt> {{Trac|wp-includes/query.php}}に含まれています。
  
==Related==
+
<div id="Related">
 +
== 関連資料 ==
 +
</div>
  
 
{{Conditional Tags}}
 
{{Conditional Tags}}
51行目: 80行目:
 
{{Tag Footer}}
 
{{Tag Footer}}
 
{{原文|Function Reference/is singular|129810}}<!-- 17:40, 15 April 2013 Adam.samec -->
 
{{原文|Function Reference/is singular|129810}}<!-- 17:40, 15 April 2013 Adam.samec -->
 
+
[[Category:条件分岐タグ]]
[[Category:Conditional Tags]]
+
[[Category:関数]]
[[Category:Functions]]
+
[[en:Function_Reference/is_single]]
 +
[[tr:Fonksiyon_Listesi/is_single]]
 +
[[es:Function_Reference/is_single]]

2013年6月20日 (木) 20:08時点における版

この 条件分岐タグ は、個別の記事を表示しているかどうかをチェックします。これは以下の関数のいづれかがtrueを返すことと同義となります。

もし$post_typesパラメーターが指定されている場合、それが投稿種類の1つの為のクエリであるかを追加でチェックします。

使い方

<?php is_singular( $post_types ); ?>

パラメータ

$post_types
string/array) (オプション) 記事の種類または今のqueryでチェックすべき種類
初期値: なし

戻り値

(真偽値) 
個別記事を表示している場合は true,それ以外は false

用例

個別ページに異なるサイドバー広告を表示する場合

<?php
if ( is_singular() ) {
  // show adv. #1
} else {
  // show adv. #2
}
?>

カスタム投稿タイプ

これらの関数がtrueを返してきた時: is_single(), is_page() or is_attachment().

is_singular();

カスタム投稿タイプbookの投稿を見ている時にtrueとなる。

is_singular('book');

カスタム投稿タイプnewspaperまたはbookの投稿を見ている時にtrueとなる。

is_singular(array( 'newspaper', 'book' ));

変更履歴

  • 1.5 : 新規導入
  • 3.0.0: $post_types パラメーター追加。

ソースファイル

is_singular()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 singular最新版との差分