get_term()


関数WordPressget_term()は、指定されたタクソノミーのターム情報を取得するために使用されます。

構文

get_term( int|WP_Term $term, string $taxonomy = '', string $output = OBJECT, string $filter = 'raw' );

引数の説明:

  • $term (int|WP_Term) — 取得するタームのIDまたはWP_Termオブジェクト。
  • $taxonomy (string) — タームが属するタクソノミーのスラッグ。
  • $output (string) — 出力フォーマット。デフォルトはOBJECT
  • $filter (string) — フィルターを適用するかどうか。デフォルトは'raw'

例 1: ターム情報の取得

指定されたタームIDの情報を取得します。

<?php $term = get_term( get_queried_object_id(), 'category' ); ?>

例 2: ターム名の表示

特定のタームの名前を表示します。

<?php echo get_term( get_queried_object_id(), 'post_tag' )->name; ?>

例 3: ターム説明の取得

タームの説明を取得して表示します。

<?php $description = get_term( get_queried_object_id(), 'category' )->description; ?>

例 4: 親タームの取得

指定されたタームの親タームを取得します。

<?php $parent_term = get_term( get_term( get_queried_object_id(), 'category' )->parent, 'category' ); ?>

例 5: タームスラッグの取得

特定のタームのスラッグを取得します。

<?php echo get_term( get_queried_object_id(), 'category' )->slug; ?>

注意点:

  • 指定された$taxonomyが正しくない場合、エラーが発生します。
  • 存在しない$termを指定するとWP_Errorが返されます。
  • タームオブジェクトを編集する場合は、必ず適切なフィルターを使用してください。

関連機能: