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

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

関数リファレンス/is single

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

この 条件分岐タグ は、添付ファイルや固定ページを除く個別の投稿を表示しているかどうかをチェックします。もし $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最新版との差分