【Wordpress関数】分岐用テンプレートタグ一覧

[公開] 2024-08-05 / [更新] 2024-08-16

WordPressには、ページやテンプレートに応じた便利な分岐用タグが色々用意されています。

よく使うタグ、たまに必要になりそうなタグをまとめました。

【 is_ 】対象ページかを判定

個別ページ

code	対象ページ	パラメータ指定 / 説明
`is_singular()` `is_singular('post_type')`	投稿・固定ページ・カスタム投稿特定の投稿タイプ	対象ページをすべて含む `post_type`=`'post','page',`カスタム投稿タイプ名
`is_single() is_single('post')`	投稿特定の投稿	投稿ページだったら `post`= ID, スラッグ, タイトル
`is_page() is_page('page')`	固定ページ特定の固定ページ	固定ページだつたら `page`= ID, スラッグ, タイトル
`is_front_page()`	トップページ	不可
`is_home()`	トップページが「最新の投稿」	不可
`is_privacy_policy()`	プライバシーポリシーベージ	不可
`is_404()`	404ページ	不可
`is_paged()`	2ページ目以降	不可 (特定のページ指定はできない)

is_front_page() はトップページである事を判定。「固定ページ」「最新の投稿」どちらも対象。
is_home() はトップページが投稿である事を判定。トップページであるかの判定ではない。
is_front_page() && is_home() は「トップページ」かつ「最新の投稿」を判定。

アーカイブページ

code	対象アーカイブ	パラメータ指定 / 説明
`is_archive()`	カテゴリー, タグ, 日付( 年別、月別、日別 )	パラメータ不可
`is_category()` `is_category('cat')`	カテゴリ特定のカテゴリ	カテゴリアーカイブだったら `cat=`カテゴリ( ID, スラッグ, 名前) 又は配列
`is_tag() is_tag('tag')`	タグ特定のタグ	タグアーカイブだったら `tag` = タグスラッグ又は配列
`is_tax() is_tax('taxonomy') is_tax('taxonomy','term')`	カスタムタクソノミー特定のタクソノミー特定のターム	タクソノミーアーカイブだったら taxonomy = スラッグ又は配列 `term` =ターム( ID, スラッグ, 名前) 又は配列
`is_post_type_archive()` `is_post_type_archive('post_type')`	カスタム投稿タイプ特定の投稿タイプ	カスタム投稿タイプアーカイブだったら `post_type`= カスタム投稿タイプ名又は配列
`is_date() is_year() is_month() is_day()`	日付アーカイブ年別アーカイブ月別アーカイブ日別アーカイブ	パラメータ不可
`is_search()`	検索結果	パラメータ不可
`is_author('author')`	作成者	`author`= ID, ユーザー名, 表示名(ニックネーム)

【 in_category 】特定のカテゴリーに含まれる投稿を判定

指定カテゴリーに属している投稿を調べます。

code	対象	パラメータ
`in_category('cat')`	投稿	未指定不可 / `cat`=カテゴリ( ID, スラッグ, 名前) 又は配列

【has_】特定の投稿に基づいた要素を判定

ターム(カテゴリ等)に投稿が属するか

code	対象	パラメータ指定 / 説明
`has_category('cat') has_category('cat',投稿)`	特定のカテゴリに属するか投稿を指定	`cat=`カテゴリ( ID, スラッグ, 名前) 又は配列投稿(ID, スラッグ) 又は配列
`has_tag() has_tag('tag') has_tag('tag',投稿)`	タグに属するか特定のタグに属するか投稿を指定	現在の投稿 `tag=`タグ( ID, スラッグ, 名前) 又は配列投稿(ID, スラッグ) 又は配列
`has_term() has_term('taxonomy') has_term('taxonomy','term') has_term('taxonomy','term',投稿)`	タクソノミーに属するか特定のタクソノミーに属するか特定のタームに属するか投稿を指定	現在の投稿タクソノミースラッグ又は配列 `term =`ターム(ID, スラッグ, 名前) 又は配列投稿(ID, スラッグ) 又は配列

投稿が対象を持っているか

code	対象	パラメータ指定 / 説明
`has_post_thumbnail() has_post_thumbnail(投稿ID)`	アイキャッチがあるか投稿を指定	現在の投稿投稿ID (複数不可)
`has_excerpt() has_excerpt(投稿ID)`	抜粋が入力されているか投稿を指定	現在の投稿投稿ID (複数不可)