説明
パラメータ
バージョン4.5.0以降のパラメータは次の通り。
- $args検索条件を指定する文字列または連想配列。主なキーワードは次の通り。
キーワード 意味 taxonomy タクソノミーを示すcategory、post_tagなど orderby ソート対象を示すcount、name、slug、term_group、none、idなど(省略時は'name') order ソート順を示すASCかDESC(省略時はASC) hide_empty 投稿記事がないタクソノミーを取得しない場合はtrue(1)、投稿記事がないタクソノミーも取得する場合はfalse(0)を指定(省略時はtrue) exclude 取得したくないタクソノミーのID(複数指定する場合は,で区切る) exclude_tree 取得したくないタクソノミーのID(複数指定する場合は,で区切る)。指定されたIDのタクソノミーが子タクソノミーを持っている場合、それらの子カテゴリーも除外される。 include 取得したいタクソノミーのID(複数指定する場合は,で区切る) number 取得件数(省略時は条件にマッチするすべてを取得する) offset 取得開始位置(省略時は0:先頭) fields 情報項目を示すall、count、ids、namesなどを指定(省略時はall) slug 取得したいタクソノミーのスラッグを指定 hierarchical true(1)またはfalse(0)を指定(省略時はtrue) search 取得したいタクソノミーの名前(その一部)を指定 name__like 取得したいタクソノミーの名前の先頭部分を指定 pad_counts 子タクソノミーの投稿件数を親タクソノミーに加算する場合はtrue(1)を指定(省略時はfalse) get すべてのカテゴリー情報を取得する場合にallを指定 child_of カテゴリーのIDを指定(そのIDのタクソノミーの子孫がすべて対象となる) parent カテゴリーのIDを指定(そのIDのタクソノミーの子カテゴリーのみが対象となる) suppress_filter [4.8.0]フィルター処理しない場合はtrueを指定(省略時はfalse) - $deprecated非推奨(互換性維持のため存在)
バージョン4.4.3以前のパラメータは次の通り。
- $taxonomiesタクソノミー名。複数指定する場合は配列で指定。
タクソノミー名 意味 category カテゴリー post_tag 投稿タグ nav_menu メニュー link_category リンクのカテゴリー - $args検索条件を指定する文字列または連想配列。主なキーワードは次の通り。
キーワード 意味 orderby ソート対象を示すcount、name、slug、term_group、none、idなど(省略時は'name') order ソート順を示すASCかDESC(省略時はASC) hide_empty 投稿記事がないタクソノミーを取得しない場合はtrue(1)、投稿記事がないタクソノミーも取得する場合はfalse(0)を指定(省略時はtrue) exclude 取得したくないタクソノミーのID(複数指定する場合は,で区切る) exclude_tree 取得したくないタクソノミーのID(複数指定する場合は,で区切る)。指定されたIDのタクソノミーが子タクソノミーを持っている場合、それらの子カテゴリーも除外される。 include 取得したいタクソノミーのID(複数指定する場合は,で区切る) number 取得件数(省略時は条件にマッチするすべてを取得する) offset 取得開始位置(省略時は0:先頭) fields 情報項目を示すall、count、ids、namesなどを指定(省略時はall) slug 取得したいタクソノミーのスラッグを指定 hierarchical true(1)またはfalse(0)を指定(省略時はtrue) search 取得したいタクソノミーの名前(その一部)を指定 name__like 取得したいタクソノミーの名前の先頭部分を指定 pad_counts 子タクソノミーの投稿件数を親タクソノミーに加算する場合はtrue(1)を指定(省略時はfalse) get すべてのカテゴリー情報を取得する場合にallを指定 child_of カテゴリーのIDを指定(そのIDのタクソノミーの子孫がすべて対象となる) parent カテゴリーのIDを指定(そのIDのタクソノミーの子カテゴリーのみが対象となる)
返り値
マッチしたすべてのデータが格納された配列を返す。タクソノミー情報のメンバー変数は次の通り。プロパティ名 | データ型 | 意味 |
---|---|---|
term_id | int | ID |
name | string | 名前 |
slug | string | スラッグ |
term_group | int | グループID |
term_taxonomy_id | int | タクソノミーID |
taxonomy | string | タクソノミー名 |
description | string | 説明 |
parent | int | 親タクソノミーのID。親タクソノミーがない場合は0となる |
count | int | 投稿数 |
注意
タクソノミー情報は、投稿記事の付随情報のことで、カテゴリーや投稿タグなどが含まれている。 get_categoriesや get_tagsでは、このget_termsを使用して情報を取得している。
パラメータ$argsで指定する検索条件はデフォルトでは'hide_empty'がtrueのため、投稿のないタクソノミーは取得できない。投稿数に関係なくすべてのカテゴリー情報を取得する場合は、'get=all'を指定するのが便利。
なお'parent'が指定された場合は、'child_of=0'、'hierarchical=false'、'pad_counts=false'へと強制的に変更される。
また'get=all'が指定された場合は、'child_of=0'、'hide_empty=0'、'hierarchical=false'、'pad_counts=false'へと強制的に変更される。
[4.5.0]パラメータの仕様が変更となり、基本的に第1パラメータのみを使用するようになった(ただし、互換性維持のためそれ以前のパラメータでも動作している)。
[4.6.0]検索機能を備えたWP_Term_Queryクラスの登場により、'get_terms'以外のフィルターはそちらに移動。'get_terms'フィルターのパラメータに検索に使用したWP_Term_Queryオブジェクトが追加された。
[4.8.0]suppress_filterが追加され、get_termsフィルターの処理前の内容を取得できるようになった。
使用例
- すべてのカテゴリー情報を取得する。
<?php // 4.5.0以降 $categories = get_terms( array( 'taxonomy'=>'category', 'get'=>'all' ) ); // 4.4.3以前 $categories = get_terms( 'category', 'get=all' ) ); ?>
- すべての投稿タグ情報を取得する。
<?php // 4.5.0以降 $tags = get_terms( array( 'taxonomy'=>'post_tag', 'get'=>'all' ) ); // 4.4.3以前 $tags = get_terms( 'post_tag', 'get=all' ) ); ?>
フィルター
[4.4.0]パラメータ$argsとマージする前にデフォルトのクエリー条件を調整する'get_terms_defaults'フィルターを呼び出す。パラメータ$defaultsにはデフォルトのクエリー条件(連想配列)が、$taxonomiesには本関数が受け取った内容がfalseが格納される。アクション
実行するアクションはありません。ソースファイル
/wp-includes/taxonomy.php最終更新 : 2020年12月14日 16:32
関連
お勧め
Contact Form 7に確認フェーズを(2012年12月16日 更新)
Contact Form 7はWordPressによるサイト製作でお世話になることが多いプラグインの1つ。ただ、クライアント様によっては、入力、確認、送信の3フェーズにしたいという要望があり、そんな時は別の方法を採用していたのですが、JavaScript(jQuery)を使ってページ遷移しなくてもいいなら確認フェーズは用意できるかなと思い、作り込んでみた。投稿一覧に独自リンクを追加する(2013年10月16日 更新)
管理者ページの「投稿一覧」や「固定ページ一覧」の各投稿記事はマウスポインタを移動すると、「編集」や「クイック編集」といったリンクが表示される。このリンクに独自のリンクを追加する方法を調べてみた。HTML編集モードに定型文ボタンを追加する(2011年6月1日 更新)
投稿編集ページにはビジュアル編集モードとHTML編集モードがあり、それらを拡張するプラグインも多数存在している。そういったプラグインを利用するのもいいのだが、仕組みを理解するのも悪くないはず。というわけで、ここではHTML編集モードのボタンの仕組みと定型文を挿入するボタンを追加する方法を紹介する。投稿日の検索が自由自在に(2015年3月7日 更新)
WordPress 3.7.0ではWP_Date_Queryクラスが追加され、WP_Queryクラス(もちろん query_posts関数でも)で利用できるようになった。このWP_Date_Queryにより、○年○月○日以前や以降の投稿情報を取得したり、○年○月○日から○年○月○日の範囲の投稿情報を取得したりといったことが、容易に行えるようになった。
プラグインのヘッダー情報を国際化対応しよう(2018年5月27日 更新)
バージョン4.8がリリースされてひと段落。あらためてプラグイン一覧ページを見てみると「Akismet」が「Akismet Anti-Spam (アンチスパム)」と表示されていた。説明文だけじゃなくプラグイン名も国際化対応できたのね。