is_tag() の使い方｜説明・引数・注意点

説明

基本構文

is_tag( int|string|int[]|string[] $tag = '' ): bool

引数

• $tag：タグのID・名前・スラッグ（省略可）

戻り値

条件に当てはまれば true、そうでなければ false。

使い方（サンプル）

if ( is_tag() ) {
	// タグ一覧
}

注意点

• 引数に特定のタグを指定できます。
• 投稿にタグが付いているかは has_tag() で調べます。

実務での使いどころ

• 特定のタグ（スラッグ）のアーカイブだけで、表示を変えるとき。
• タグのアーカイブ全般で、見出しを変えるとき。

よくあるミスと対処

• 個別の投稿ページで、投稿がタグを持つかを判定するつもりで使っている。投稿ページでは false。投稿のタグは has_tag() で判定する。
• タグ名とスラッグを取り違えている。

NG例

// 個別の投稿ページで
if ( is_tag( 'php' ) ) {
	// 当てはまらない
}

OK例

if ( is_single() && has_tag( 'php' ) ) {
	// phpタグを持つ投稿
}

使い分け早見表

関連項目

is_category()、has_tag()

公式リファレンス：is_tag() | Function | WordPress Developer Resources