wp_get_post_terms

（2.8.0以降）
wp_get_post_terms - 投稿記事のタクソノミー情報を取得する

説明

mixed wp_get_post_terms( [ int $post_id = 0 [ , string $taxonomy = 'post_tag' [ , array $args = array() ] ] ] )
投稿記事のタクソノミー情報を取得する。

パラメータ

  • $post_id
    投稿ID（数値）を指定（省略時は0）。
  • $taxonomy
    'category'、'post_tag'などのタクソノミー名を指定（省略時は'post_tag'）。
  • $args
    取得するタクソノミー情報の条件を連想配列で指定（省略時はarray()）。
    キーワード意味
    orderbyソート対象を示すcount、name、slug、term_group、term_order、noneなど（省略時は'name'：名前）
    orderソート順を示すASCかDESC（省略時はDESC）
    fields取得する項目を示すall、ids、names、slugsなど（省略時はall）

返り値

マッチしたすべてのタクソノミー情報が格納された配列を返す。パラメータ$taxonomyで指定された名前が無効な場合などのエラー時には WP_Errorのオブジェクトを返す。タクソノミー情報のプロパティは次の通り。
プロパティ名データ型意味
term_idintID
namestring名前
slugstringスラッグ
term_groupintグループID
term_taxonomy_idintタクソノミーID
taxonomystringタクソノミー名。カテゴリーの場合は'category'、タグの場合は'post_tag'となる
descriptionstring説明
parentint親カテゴリーID。親カテゴリーがない場合は0となる
countint投稿数

注意

同じような使い方ができる get_the_terms関数がある。

使用例

  • 投稿IDが1の投稿タグ情報を取得する。
    <?php $terms = wp_get_post_terms( 1 ); ?>
  • 投稿IDが1のカテゴリー情報を取得する。
    <?php $terms = wp_get_post_terms( 1, 'category' ); ?>
  • 投稿IDが1の投稿タグ情報を名前の降順で取得する。
    <?php $terms = wp_get_post_terms( 1, 'post_tag', array( 'orderby'=>'name', 'order'=>'DESC' ) ); ?>

最終更新 : 2014年07月04日 00:18

関連

参考

Code Reference: wp_get_post_terms

お勧め

テキストエディタの文字を変更する（2018年5月27日 更新）

テキストエディタ（投稿ページの「テキスト」タブのエディタ）に標準では備わっていない機能を追加する自作プラグイン「html entities button」がほぼ1年ぶりにアップデート。ここではバージョン2.0.0で追加したテキストエディタのフォント切り替え機能について紹介する。

query_posts（WP_Queryクラス）でカスタムフィールドを使う（2011年9月15日 更新）

先週3回にわたってtax_queryパラメータを使ったカテゴリーや投稿タグ、投稿フォーマットの絞り込みを整理したが、その途中で目に付いたのが'meta_query'パラメータ。この'meta_query'パラメータは、カスタムフィールドの絞り込み条件を指定するためのもので、3.2で登場した新しいパラメータのようだ。

更新ボタンの横にスピナーを実装する（2019年5月14日 更新）

WordPressの管理画面ではAJAXを使って何らかの処理を行う際、数秒間の空き時間にアイコンがクルクル回る「スピナー」を表示しているところがある。今作っているプラグインでこの「スピナー」を使いたくなったので、実装方法を調べてみた。

公式ディレクトリに登録するならajax.googleapis.comのライブラリは利用しない（2018年5月27日 更新）

数日前、投稿一覧ページの絞り込みドロップダウンメニューを複数選択可能にするプラグイン「Posts filter multiselect」を公開したのですが、その際に指摘されたポイントを紹介します。

Login rebuilder 2.3.0の新機能を紹介（2018年5月27日 更新）

プラグイン「Login rebuilder」はログイン時の履歴（ログ）や不正なログインページへのアクセス履歴を保存している。これらの履歴情報はダッシュボートで確認できるが、バージョン2.3.0においてそれぞれがダウンロードできるようになった。