テンプレート内で使用できる主な条件分岐タグをまとめました。
ページの条件分岐
この条件分岐タグは、表示するページに対して条件分岐します。
| ホーム | ||
is_home() |
ホーム （ブログ記事のホーム） |
「フロントページの表示」設定が「最新の投稿」の場合はホーム（サイトURLのページ）、「固定ページ」の場合は「投稿ページ」に設定したページでtrueを返す |
|---|---|---|
is_front_page() |
フロントページ | ホーム（サイトURLのページ）でtrueを返す |
| アーカイブ | ||
is_archive() |
アーカイブ | カテゴリ・タグ・タクソノミーアーカイブ、日付アーカイブ、投稿者アーカイブ、投稿タイプアーカイブのいずれか |
is_category() |
カテゴリアーカイブ | is_category($category)で特定のカテゴリ$categoryはカテゴリスラッグ、カテゴリ名、カテゴリID、またはそれらの配列 |
is_tag() |
タグアーカイブ | is_tag($tag)で特定のタグ$tagはタグスラッグ、タグ名、タグID、またはそれらの配列※タグ名、タグIDはWP3.7から対応 |
is_tax() |
タクソノミーアーカイブ | is_tax($taxonomy, $term)で特定のタクソノミー、タグ$taxonomyはタクソノミースラッグ、またはその配列$termはタームスラッグ、ターム名、タームID、またはそれらの配列 |
is_author() |
投稿者アーカイブ | is_author($author)で特定の投稿者$authorはユーザID、ユーザ名、ニックネーム、またはそれらの配列 |
is_date() |
日付アーカイブ | 年・月・日・時刻アーカイブのいずれか |
is_year() |
年アーカイブ | |
is_month() |
月アーカイブ | |
is_day() |
日アーカイブ | |
is_time() |
時刻アーカイブ | |
is_post_type_archive() |
投稿タイプアーカイブ | is_post_type_archive($post_types)で特定の投稿タイプ$post_typesは投稿タイプ名、またはその配列 |
| 検索 | ||
is_search() |
検索結果ページ | |
| シングルページ | ||
is_singular() |
シングルページ | 投稿のシングルページ、固定ページ、添付ファイルページのいずれかis_singular($post_types)で特定の投稿タイプ$post_typesは投稿タイプ名、またはその配列 |
is_single() |
投稿のシングルページ | is_single($post)で特定の投稿$postは投稿ID、タイトル、スラッグ、またはそれらの配列 |
is_page() |
固定ページ | is_page($page)で特定の投稿$pageはページID、タイトル、スラッグ、またはそれらの配列 |
is_attachment() |
添付ファイルページ | |
is_page_template() |
ページテンプレート | 固定ページでページテンプレートが使われている場合is_page_template($template)で特定のページテンプレート$templateはテンプレートファイル名（テーマディレクトリ以下のパス） |
| 管理画面 | ||
is_admin() |
管理画面 | wp-adminディレクトリのページ全て |
is_blog_admin() |
ブログ管理画面 | ユーザ管理画面・ネットワーク管理画面以外のwp-adminディレクトリのページ |
is_user_admin() |
ユーザ管理画面 | wp-admin/userディレクトリのページ |
is_network_admin() |
ネットワーク管理画面 | wp-admin/networkディレクトリのページ |
| その他 | ||
is_404() |
404ページ | |
is_preview() |
プレビュー | |
is_paged() |
複数ページ | 記事一覧やアーカイブの2ページ目以降でtrueを返す |
投稿の条件分岐
この条件分岐タグは、ループ内などの個別の記事に対して条件分岐します。
in_category() |
カテゴリ | in_category($category, $post)で特定のカテゴリ、投稿 ($categoryは必須)$categoryはカテゴリスラッグ、カテゴリ名、カテゴリID、またはそれらの配列$postは投稿ID、またはオブジェクト |
|---|---|---|
has_tag() |
タグ | has_tag($tag, $post)で特定のタグ、投稿$tagはタグスラッグ、タグ名、タグID、またはそれらの配列$postは投稿ID、またはオブジェクト |
has_term() |
タクソノミー（ターム） | has_term($term, $taxonomy, $post)で特定のターム、投稿$termはタームスラッグ、ターム名、タームID、またはそれらの配列$taxonomyはタクソノミー名 ($termを指定した場合は必須)$postは投稿ID、またはオブジェクト |
has_excerpt() |
抜粋 | has_excerpt($post_id)で投稿IDを指定 |
has_post_thumbnail() |
アイキャッチ画像 | has_post_thumbnail($post_id)で投稿IDを指定 |
get_post_type() |
投稿タイプ | 条件分岐タグではなく、投稿タイプ名を返す関数if ( 'news' ===get_post_type() )のように使用して条件分岐する get_post_type($post)で投稿ID（またはオブジェクト）を指定 |
has_post_format() |
投稿フォーマット | has_post_format($format, $post)で特定のフォーマット、投稿$formatはフォーマットのスラッグ$postは投稿ID、またはオブジェクト |
is_sticky() |
先頭固定表示 | is_sticky($post_id)で投稿IDを指定 |
comments_open() |
コメント投稿許可 | comments_open($post)で投稿ID（またはオブジェクト）を指定 |
pings_open() |
トラックバック・ピンバック許可 | pings_open($post)で投稿ID（またはオブジェクト）を指定 |
post_password_required() |
パスワード保護 | post_password_required($post)で投稿ID（またはオブジェクト）を指定 |
is_new_day() |
新しい日付 | ループ内で直前の投稿と違う日付の場合 |