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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(関連資料: 最新のマージ)
(en:Function_Reference/is_singular 08:57, 20 February 2015 Jhckncl を反映、およびクリーンアップ。)
 
3行目: 3行目:
 
</div>
 
</div>
  
この [[条件分岐タグ|条件分岐タグ]] は、個別の記事を表示しているかどうかをチェックします。これは以下の関数のいづれかが''true''を返すことと同義となります。
+
この [[条件分岐タグ]] は、個別の投稿を表示中であるかチェックします。以下の関数のいずれかが ''true'' を返すとき、個別の投稿を表示中です。
 
*<tt>[[関数リファレンス/is single|is_single()]]</tt>
 
*<tt>[[関数リファレンス/is single|is_single()]]</tt>
 
*<tt>[[関数リファレンス/is page|is_page()]]</tt>
 
*<tt>[[関数リファレンス/is page|is_page()]]</tt>
 
*<tt>[[関数リファレンス/is attachment|is_attachment()]]</tt>
 
*<tt>[[関数リファレンス/is attachment|is_attachment()]]</tt>
  
もし<tt>$post_types</tt>パラメーターが指定されている場合、それが投稿種類の1つの為の[[Glossary#クエリ文字列|クエリ]]であるかを追加でチェックします。
+
<tt>$post_types</tt> パラメータが指定された場合は、指定された投稿タイプのいずれかに対する [[Glossary#クエリ文字列|クエリ]] であることを追加でチェックします。
  
 
<div id="Usage">
 
<div id="Usage">
20行目: 20行目:
 
</div>
 
</div>
  
{{Parameter|$post_types|string/array|記事の種類または今のqueryでチェックすべき種類|オプション}}
+
{{Parameter|$post_types|文字列/配列|投稿タイプ(複数なら配列)。現在のクエリが対象としているかチェックされる。|オプション}}
  
 
<div id="Return_Values">
 
<div id="Return_Values">
26行目: 26行目:
 
</div>
 
</div>
  
; <tt>(真偽値)</tt> : 個別記事を表示している場合は <tt>true</tt>,それ以外は <tt>false</tt>。
+
; <tt>(真偽値)</tt> : 個別投稿を表示している場合は <tt>true</tt>、それ以外は <tt>false</tt>。
  
 
<div id="Examples">
 
<div id="Examples">
32行目: 32行目:
 
</div>
 
</div>
  
=== 個別ページに異なるサイドバー広告を表示する場合 ===
+
<div id="Different_Sidebar_Ads_in_Singular_Page">
&lt;?php
+
=== 個別ページに異なるサイドバー広告を表示 ===
if ( is_singular() ) {
+
</div>
  // show adv. #1
+
} else {
+
  // show adv. #2
+
}
+
?&gt;
+
  
===デフォルト投稿タイプ===
+
<pre>
通常の投稿を表示した時に''True''
+
<?php
 +
if ( is_singular() ) {
 +
  // 広告その1を表示
 +
} else {
 +
  // 広告その2を表示
 +
}
 +
?>
 +
</pre>
  
is_singular( 'post' );
+
<div id="Default_Post_Type">
 +
=== デフォルトの投稿タイプ ===
 +
</div>
  
 +
通常の投稿を表示した時に ''true'' を返します。
  
 +
is_singular( 'post' );
 +
 +
<div id="Custom_Post_Types">
 
=== カスタム投稿タイプ ===
 
=== カスタム投稿タイプ ===
これらの関数が''true''を返してきた時: <tt>is_single()</tt>, <tt>is_page()</tt> or <tt>is_attachment()</tt>.
+
</div>
 +
 
 +
パラメータを省略すると、以下のいずれかが ''true'' を返す場合に ''true'' を返します: <tt>is_single()</tt><tt>is_page()</tt><tt>is_attachment()</tt>
  
 
  is_singular();
 
  is_singular();
  
[[投稿タイプ|カスタム投稿タイプ]]''book''の投稿を見ている時に''true''となる。
+
[[投稿タイプ|カスタム投稿タイプ]] ''book'' の投稿を見ている時に ''true'' を返します。
  
  is_singular('book');
+
  is_singular( 'book' );
  
[[投稿タイプ|カスタム投稿タイプ]]''newspaper''または''book''の投稿を見ている時に''true''となる。
+
[[投稿タイプ|カスタム投稿タイプ]] ''newspaper'' または ''book'' の投稿を見ている時に ''true'' を返します。
  
  is_singular(array( 'newspaper', 'book' ));
+
  is_singular( array( 'newspaper', 'book' ) );
+
  
 
<div id="Notes">
 
<div id="Notes">
 
+
== 参考 ==
== ==
+
 
</div>
 
</div>
  
71行目: 79行目:
  
 
* [[Version 1.5|1.5]] : 新規導入
 
* [[Version 1.5|1.5]] : 新規導入
* [[Version 3.0|3.0.0]]: <tt>$post_types</tt> パラメーター追加。
+
* [[Version 3.0|3.0.0]] : <tt>$post_types</tt> パラメータ追加。
  
 
<div id="Source_File">
 
<div id="Source_File">
 
== ソースファイル ==
 
== ソースファイル ==
 
</div>
 
</div>
<!-- Need links to current source code files -->
+
 
<tt>is_singular()</tt> は {{Trac|wp-includes/query.php}}に含まれています。
+
<tt>is_singular()</tt> は {{Trac|wp-includes/query.php}} に含まれています。
  
 
<div id="Related">
 
<div id="Related">
== 関連資料 ==
+
== 関連項目 ==
 
</div>
 
</div>
  
86行目: 94行目:
  
 
{{Tag Footer}}
 
{{Tag Footer}}
{{原文|Function Reference/is singular|148516}}<!-- 07:22, 15 December 2014‎ Neocreo -->
+
 
 +
{{原文|Function Reference/is_singular|149747}} <!-- 08:57, 20 February 2015 Jhckncl -->
 +
 
 +
{{DEFAULTSORT:Is_singular}}
 
[[Category:条件分岐タグ]]
 
[[Category:条件分岐タグ]]
 
[[Category:関数]]
 
[[Category:関数]]
[[en:Function_Reference/is_single]]
+
 
[[tr:Fonksiyon_Listesi/is_single]]
+
[[en:Function_Reference/is_singular]]
[[es:Function_Reference/is_single]]
+
[[tr:Fonksiyon_Listesi/is_singular]]
 +
[[zh-hans:函数引用/is_singular]]

2016年8月23日 (火) 19:50時点における最新版

この 条件分岐タグ は、個別の投稿を表示中であるかチェックします。以下の関数のいずれかが true を返すとき、個別の投稿を表示中です。

$post_types パラメータが指定された場合は、指定された投稿タイプのいずれかに対する クエリ であることを追加でチェックします。

使い方

<?php is_singular( $post_types ); ?>

パラメータ

$post_types
文字列/配列) (オプション) 投稿タイプ(複数なら配列)。現在のクエリが対象としているかチェックされる。
初期値: なし

戻り値

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

用例

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

<?php
if ( is_singular() ) {
  // 広告その1を表示
} else {
  // 広告その2を表示
}
?>

デフォルトの投稿タイプ

通常の投稿を表示した時に true を返します。

is_singular( 'post' );

カスタム投稿タイプ

パラメータを省略すると、以下のいずれかが true を返す場合に true を返します: is_single()is_page()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最新版との差分