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

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

関数リファレンス/is singular

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

この 条件分岐タグ は、個別の投稿を表示中であるかチェックします。以下の関数のいずれかが 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最新版との差分