説明
mixed get_category( mixed $category [ , string $output = OBJECT [ , string $filter = 'raw' ] ] )
IDを指定してカテゴリー情報を取得する。
パラメータ
- $categoryカテゴリーIDまたはカテゴリー情報のオブジェクトを指定。
- $output出力型を示すOBJECT、ARRAY_A、ARRAY_Nの何れか（省略時はOBJECT）。
- $filterフィルター名（省略時は'raw'）。
返り値
カテゴリーが見つかった場合はそのカテゴリー情報をパラメータ$outputで指定された型で返す。カテゴリーが見つからなかった場合は 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 | 投稿数 |
| cat_ID | int | ID（term_idのエイリアス） |
| cat_name | string | 名前（nameのエイリアス） |
| category_nicename | string | スラッグ（slugのエイリアス） |
| category_description | string | 説明（descriptionのエイリアス） |
| category_parent | int | 親カテゴリーID（parentのエイリアス） |
| category_count | int | 投稿数（countのエイリアス） |
注意
返り値はWP_Errorのオブジェクトの場合あるので、返り値がオブジェクトであっても is_wp_error関数で確認するのが望ましい。 またパラメータ$termにカテゴリー・タグ情報のオブジェクトを指定した場合、フィルター処理を行った後、$outputで指定した型に変換したデータを返す。使用例
- IDが10のカテゴリー情報を取得する。<?php $cat = get_category( 10 ); ?>
- IDが10のカテゴリー情報を連想配列で取得する。<?php $cat = get_category( 10, ARRAY_A ); ?>
最終更新 : 2018年05月27日 10:53
関連
お勧め
query_posts（WP_Queryクラス）でカテゴリーを絞り込む（2011年9月14日 更新）
久しぶりに query_posts関数を見直してみると、見知らぬパラメータがいくつか追加されていた。気になったのでカテゴリー関係の指定を'tax_query'パラメータを交えて整理してみた。the_date関数で投稿日を確実に表示する（2011年12月20日 更新）
投稿記事の投稿日時を表示する際、 the_date関数を使用することが多いだろう。このthe_date関数はphpのdate関数と同じパラメータを指定することで、好みの日時フォーマットで投稿日時を表示できるのだが、ある条件の場合に投稿日時を表示しない。最初にこの現象に遭遇したときは、ちょっと悩まされた。スクリプトファイルのバージョンパラメータを変更する（2018年5月27日 更新）
Java Scriptやスタイルシートの指定を直接head要素内に記述せず、wp_enqueue_scriptsフィルターなどを使って指定する場合、WordPressのバージョン番号が付与されている。このバージョン番号は、妥当なんだろうか。
ログアウト後はいつもサイトトップ（2018年5月27日 更新）
ログアウト後に表示（リダイレクト）されるページは、標準ではログインページ（wp-login.php）である。4.2.0ではログアウト処理後のページリダイレクト前に呼び出されるフィルターが追加された。
カレンダーウィジェットをAjaxで切り替える（2011年8月22日 更新）
ウィジェットベースでテーマを構築していてカレンダーを表示してみた。標準では、前月や次月のリンク先はそれぞれの月のアーカイブページとなっているのだが、記事を探すだけであればカレンダー部分だけを更新するほうが便利なのではと考え、そのアイデアを実装してみた。