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

説明

基本構文

get_the_tags( int|WP_Post $post = 0 ): WP_Term[]|false|WP_Error

引数

• $post：投稿IDまたはオブジェクト

戻り値

WP_Term の配列。タグがなければ false。

使い方（サンプル）

$tags = get_the_tags();
if ( $tags ) {
	foreach ( $tags as $tag ) {
		echo esc_html( $tag->name );
	}
}

注意点

• タグが無いときは空配列ではなく false が返ります。

実務での使いどころ

• 投稿に付いたタグを、配列で取得するとき。
• タグ名を、リンクなしで表示するとき。

よくあるミスと対処

• タグが1つもないとき、空の配列ではなく false が返る。そのまま foreach に渡すと、警告になる。
• エラー時には WP_Error が返る場合もある。
• カスタム投稿タイプのカスタムタクソノミーには使えない。それらは get_the_terms() を使う。

NG例

foreach ( get_the_tags() as $tag ) {
	echo $tag->name; // タグが無いと、警告になる
}

OK例

$tags = get_the_tags();
if ( $tags && ! is_wp_error( $tags ) ) {
	foreach ( $tags as $tag ) {
		echo esc_html( $tag->name );
	}
}

使い分け早見表

関連項目

the_tags()、get_the_terms()

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