get_term

（2.3.0以降）
get_term - IDを指定してカテゴリー・タグ情報を取得する

説明

mixed get_term( mixed $term [ , string $taxonomy = '' [ , string $output = OBJECT [ , string $filter = 'raw' ] ] ] )

IDを指定してカテゴリー・タグ情報を取得する。

パラメータ

$term
ID（term_id）またはカテゴリー・タグ情報のオブジェクトを指定。
$taxonomy
タクソノミー名として'category'、'post_tag'、'link_category'などを指定（[4.4.0]省略時は''）。
$output
出力型を示すOBJECT、ARRAY_A、ARRAY_Nの何れか（省略時はOBJECT）。
$filter
フィルター名（省略時は'raw'）。

返り値

カテゴリー・タグが見つかった場合はそのカテゴリー・タグ情報をパラメータ$outputで指定された型で返す。カテゴリー・タグが見つからなかった場合はnullを返す。また、パラメータ$termが空の場合、$taxonomyが無効なタクソノミー名の場合は WP_Errorのオブジェクトを返す。 $outputがOBJECTの場合（デフォルト）、メンバー変数は次の通り。

プロパティ名	データ型	意味
term_id	int	ID
name	string	名前
slug	string	スラッグ
term_group	int	グループID
term_taxonomy_id	int	タクソノミーID
taxonomy	string	タクソノミー名。カテゴリーの場合は'category'、タグの場合は'post_tag'となる
description	string	説明
parent	int	親カテゴリーID。親カテゴリーがない場合は0となる
count	int	投稿数

注意

返り値はWP_Errorのオブジェクトの場合あるので、返り値がオブジェクトであっても is_wp_error関数で確認するのが望ましい。またパラメータ$termにカテゴリー・タグ情報のオブジェクトを指定した場合、フィルター処理を行った後、$outputで指定した型に変換したデータを返す。

[4.4.0]パラメータ$taxonomyは省略可能になった。

使用例

IDが10のカテゴリー情報を取得する。
<?php $cat = get_term( 10, 'category' ); ?>

フィルター

[2.3.0]ターム情報を取得した直前に'get_term'フィルターを呼び出す。パラメータ$_termには取得したターム情報が、$taxonomyには本関数が受け取った値が格納されている。

$_term = apply_filters( 'get_term', $_term, $taxonomy );

[2.3.0]'get_term'フィルターの直前に"get_$taxonomy"フィルターを呼び出す（$taxonomyはタクソノミー名）。パラメータ$_termには取得したターム情報が、$taxonomyには本関数が受け取った値が格納されている。

$_term = apply_filters( "get_$taxonomy", $_term, $taxonomy );

アクション

実行するアクションはありません。

ソースファイル

/wp-includes/taxonomy.php

最終更新 : 2018年05月27日 10:52

参考

Code Reference: get_term

お勧め

スマートフォン向けの振り分けを自前で行う（2012年1月23日更新）

PC向けのサイトをスマートフォン対応する場合、WPtouchやktai styleに代表されるスマートフォン対応のテンプレート切り替えプラグインを使用するのが一般的。そういったプラグインはテンプレート切り替え以外の機能も備えており、そういった機能は必ずしも必要ではない。そんなわけで、ここでは超シンプルなスマートフォン向けのテンプレート切り替えを実現する方法を紹介する。

使っていないか確認しないとね！（2017年11月18日更新）

2003年に誕生したWordPress。その歴史の中には、廃止予定（deprecated）となっている関数がいくつも存在する。それらの関数をテーマやプラグインで使用するべきではないし、使用しているなら代替の関数に書き換えるべきである。ここでは~~3.2~~4.9.0現在、廃止予定となっている関数をまとめて紹介する。

プラグインのロード順を制御する（2014年6月9日更新）

これまでプラグインがどのような順番でロードされるか意識していなかったのだが、とある自作プラグインを他のプラグインよりも先にロードさせたくなったので調べてみた。

wp_titleからwp_get_document_titleへ（2018年5月27日更新）

先週、WordPress 4.4 beta1（以降4.4 beta1）が公開されました。この4.4 beta1では新テーマ「Twenty Sixteen」が追加されたほか、wp-includesディレクトリ以下のファイルが大幅に変更された感じです。

初期状態で「抜粋」ウィジェットを表示する（2014年1月7日更新）

投稿編集ページのウィジェットは標準で表示されるものとされないものがある。フォーラムに『投稿の編集画面にデフォルトで抜粋を表示させたい』という投稿があったので、ちょっと調べてみた。