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

お勧め

サイトヘルス機能を使ってみた（2019年4月12日 更新）

先月末にWordPress 5.2 Beta1が、今日はWordPress 5.2 Beta2（以降5.2Beta2）が公開された。5.2ではブロックエディターの機能が強化され、サイトの安全性とパフォーマンス向上に役立つとされるサイトヘルス機能が追加される。

管理者ページに文言を表示する（2012年4月19日 更新）

お客様向けに管理者ページをカスタマイズする機会が増えてきている。カスタマイズするページや表示場所、表示内容によっていくつかの手段があるが、今回はページの冒頭部分に任意の文言を表示する方法を紹介する。

WordPressのコーディングスタンダードとPSR-2がかみ合わない（2018年5月27日 更新）

先日パソコンのストレージを換装して開発環境を再構築。エディタのEclipseは「Neon（4.6）」から「Oxygen（4.7）」へ切り替わった。コードを書き始めるとそこはかとなく違和感があり、調べていくとPHPの「Code Style（Formatter）」が「PSR-2」に設定されていることが原因だった。

Widgets on dashboard：プラグイン作ってみました（2014年5月7日 更新）

サイトバーなどのページ構成パーツとしてウィジェットを利用し、ある程度頻繁に更新している場合、毎回ウィジェットページを表示するのはちょっとだけ面倒かも。そんなわけで、シンプルにダッシュボードで直接編集できればいいかなと思い、調べてみました。

5.7の機能拡張：投稿一覧画面向けのフィルター（2021年2月18日 更新）

昨日、予定通り公開された「WordPress 5.7 Beta 3（以降Beta 3）」。WordPressはバージョンアップ毎にアクションやフィルターが追加されており、今回のバージョンアップでは投稿一覧画面に影響を与えるフィルターが追加されていた。