WEB制作のための情報サイト / unazuki Library

is_tax()

基本構文と使い方(引数・実行結果)

基本構文

リクエストしたページがタクソノミーページ(ターム別のアーカイブページ)かどうかを判定します。引数を使って指定したタクソノミー、タームかどうかを判定することもできます。

is_tag($taxonomy,$term);

引数

引数必須/任意引数に指定するもの
第1引数
$taxonomy
任意タクソノミーのスラッグ (文字列)、あるいはそれらの配列
初期値''(空の文字列)
第2引数
$term
任意タームのID (整数)または、名前 / スラッグ (文字列)、あるいはそれらの配列
初期値''(空の文字列)

第1引数のみを指定すれば、指定したタクソノミーのアーカイブページかどうかを判定します。つまり指定したタクソノミーに紐づくいずれのターム別アーカイブページにおいてもtrueを返します。第2引数を指定すれば、指定したタクソノミーの中でも特定のターム別アーカイブページの場合にのみ、trueを返します。

実行結果

戻り値(返す値):真偽値。(指定した)タクソノミーページならtrue、そうでなければfalse。

例1.リクエストしたページがタクソノミーページかどうかで条件分岐する

<?php if (is_tax()) {
	// タクソノミーページの場合の処理
} ?>

例2.リクエストしたページがaaaかbbb(名前 / スラッグ)のタグページかどうかで条件分岐する

<?php if (is_tax('sports',['baseball', 'soccer'])) {
	// タクソノミーsportsに紐づくタームの中でもbaseballまたはsoccerの場合の処理
} ?>

学習者向け補足情報

【引数とは】
テンプレートタグ(=関数)を実行する際に、引数を渡すことができるテンプレートタグがあります。引数は、関数の中で使われるので、渡す引数の値によって実行結果が変わってきます。何を処理したいのか、どのようなデータを取得したいのかによって渡す引数が変わります。

【引数について】

  • 指定できる引数の数はテンプレートタグによって異なります。(引数なしもあり)
  • 引数ごとに必須 / 任意が決まっています。(必須は必ず指定、任意は指定しなければ初期値)
  • 引数名(例:$post)は仕様の便宜上の名前と考えてください。(この名前自体はテンプレートタグ実行に関係しません。各引数に何を指定するのかを理解していればOKです。)

※当サイトでは初期値とデフォルト値の言葉の定義を区別せず、原則統一して初期値を採用しています。

関連するテンプレートタグ

テンプレートタグ 説明
is_main_query() 現在のクエリがメインクエリかどうかを判定する。
is_user_logged_in() ユーザーがWordPressにログインしているかどうかを判定する。
is_paged() リクエストしたページがページングされたページかどうかを判定する。
is_404() 表示するページが404ページかどうかを判定する。
is_search() リクエストしたページが検索結果ページかどうかを判定する。
is_archive() リクエストしたページがアーカイブページかどうかを判定する。
is_day() リクエストしたページが日付別のアーカイブページかどうかを判定する。
is_date() リクエストしたページが年別/月別/日付別のいずれかのアーカイブページかどうかを判定する。
is_month() リクエストしたページが月別アーカイブページかどうかを判定する。
is_year() リクエストしたページが年別アーカイブページかどうかを判定する。
is_author() リクエストしたページが投稿者アーカイブページかどうかを判定する。
is_post_type_archive() リクエストしたページが投稿タイプのアーカイブページかどうかを判定する。
is_tag() リクエストしたページがタグページかどうかを判定する。
is_category() リクエストしたページがカテゴリーページかどうかを判定する。
is_page() リクエストしたページが固定ページかどうかを判定する。
is_singular() リクエストしたページが指定した投稿タイプの個別ページかどうかを判定する。
is_single() リクエストしたページが投稿の個別ページかどうかを判定する。
is_front_page() リクエストしたページがトップページかどうかを判定する。
is_home() リクエストしたページがホームかどうかを判定する。