get_category

(1.5.1以降)
get_category - カテゴリー情報を取得する

説明

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_idintID
namestring名前
slugstringスラッグ
term_groupintグループID
term_taxonomy_idintタクソノミーID
taxonomystringタクソノミー名。カテゴリーの場合は'category'、タグの場合は'post_tag'となる
descriptionstring説明
parentint親カテゴリーID。親カテゴリーがない場合は0となる
countint投稿数
cat_IDintID（term_idのエイリアス）
cat_namestring名前（nameのエイリアス）
category_nicenamestringスラッグ（slugのエイリアス）
category_descriptionstring説明（descriptionのエイリアス）
category_parentint親カテゴリーID（parentのエイリアス）
category_countint投稿数（countのエイリアス）

注意

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

使用例

  • IDが10のカテゴリー情報を取得する。
    <?php $cat = get_category( 10 ); ?>
  • IDが10のカテゴリー情報を連想配列で取得する。
    <?php $cat = get_category( 10, ARRAY_A ); ?>

関連

参考

Code Reference: get_category

お勧めコンテンツ

CSSやJavaScriptファイルのバージョン番号を変える（2017年3月14日 登録）

WordPress 4.7系の脆弱性をついた攻撃も落ち着いた感じなので、標準でヘッダーやフッター内に出力されるWordPressのバージョン番号について一考しました。

サイドバーの初期化はwidgets_initアクションで（2011年7月14日 登録）

ウィジェットを使ってみたくなり新テーマ「Twenty Eleven」を覗いてみると、codexに記載されていた内容と少し違っている。これって「Twenty Ten」ですでに変更されていたんだね。

タイトルが一致する投稿を検索する（2014年2月20日 登録）

WordPressが提供する投稿ページの文字列検索機能の実現には、query_posts関数（WP_Queryクラス）が大きな役割を担っている。ここで紹介するのは、高機能ゆえに使いこなすのが難しいquery_posts関数（WP_Queryクラス）の使用法の一例である。

カスタム投稿タイプの投稿保存には専用アクションを使おう（2014年7月4日 登録）

カスタム投稿タイプを登録して、専用ウィジェット（meta_box）を使って拡張情報を入力させ、それらの情報をsave_postアクションで保存する。これまではこんな感じだったのだが、久しぶりにカスタム投稿タイプを使ったら、save_postアクションの前にsave_postに投稿タイプ名がくっついたアクションが追加されていた。

全投稿を取得するのはnopaging=1でいい（2011年8月29日 登録）

query_posts関数（またはWP_Queryクラス）を使う場合、取得する件数の指定を省略すると管理者ページの「表示設定」－「1ページに表示する最大件数」の指定値分だけの投稿情報を取得する。それでは条件にマッチするすべての投稿情報を取得するには？

最終更新日時 : 2011-05-25 19:47