Mill's Note

【Wordpress関数】 get_term(), get_term_by()

/

get_term(), get_term_by() は、IDやスラッグ等からカテゴリーやタグ、ターム情報を取得するWordpressテンプレートタグ。

  • get_term()タームID + タクソノミー
  • get_term_by()指定したフィールドの検索条件 + タクソノミー

それぞれ、タクソノミーの指定 ('category','post_tag',カスタムタクソノミー)で情報を引き出せるので、ページごとに関数を変えないで使い回せます。

呼び出しコード

get_term()

PHP
<?php $term = get_term('タームID','taxonomy'); ?> 
対象パラメータ説明
taxonomy'category','post_tag', ‘カスタムタクソノミー’タクソノミーを指定

get_term_by()

PHP
<?php $term = get_term_by('検索対象フィールド','検索する値','taxonomy'); ?> 
対象パラメータ説明
検索対象フィールド'slug','name','id'いずれかを指定
検索する値情報を取得したいタームの (ID, スラッグ, 名前)フィールドに対応したいずれか
taxonomy'category','post_tag', ‘カスタムタクソノミー’タクソノミーを指定

get_term(), get_term_by() 戻り値

変数名内容
term_idintタームID
namestringターム名
slugstringタームスラッグ
parentint親タームID
countint記事数
descriptionstringターム説明
taxonomystringtaxonomy名
term_taxonomy_idinttaxonomy ID
エイリアスは記載していません。

get_term_by() の使用例

PHP
<?php $term = get_term_by('slug', 'wordPress', 'post_tag'); ?>
<ul>
  <li>
    <a href="<?php echo get_term_link($term->term_id,$term->taxonomy); ?>"><?php echo $term->name; ?></a>
  </li>
<ul>

面倒そうな書き方ですが、こうしておくと get_term_by('slug', 'wordPress', 'post_tag') を書き換えるだけで様々なページに対応できます。