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

説明

基本構文

get_term( int|WP_Term|object $term, string $taxonomy = '', string $output = OBJECT, string $filter = 'raw' ): WP_Term|array|WP_Error|null

引数

• $term：タームIDまたはオブジェクト
• $taxonomy：タクソノミー名（任意）
• $output：返却形式
• $filter：フィルター種別

戻り値

WP_Term。存在しなければ null。

使い方（サンプル）

$term = get_term( 5, 'category' );
if ( $term && ! is_wp_error( $term ) ) {
	var_dump( $term->name );
}

注意点

• 存在しない場合や取得に失敗した場合、null や WP_Error が返ります。

実務での使いどころ

• タームのIDから、ターム情報（名前、スラッグ、説明など）を取得するとき。
• アーカイブページで、表示中のタームの説明を出すとき。

よくあるミスと対処

• 存在しないIDでは null、タクソノミーが不正なときは WP_Error が返る。どちらも確認せずに使う。
• スラッグや名前で探したいのに、これを使っている。それらは get_term_by() を使う。

NG例

$term = get_term( $id, 'news_cat' );
echo $term->name; // 無い場合や、エラーのときに壊れる

OK例

$term = get_term( $id, 'news_cat' );
if ( $term && ! is_wp_error( $term ) ) {
	echo esc_html( $term->name );
}

使い分け早見表

関連項目

get_term_by()、get_terms()

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