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 ); ?>

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

関連

参考

Code Reference: get_category

お勧め

囲み型ショートコードとwpautop（2018年5月27日 更新）

ショートコードは投稿記事の閲覧時に動的に内容を変更できる優れもの。galleryやcaptionなどいくつかのショートコードが標準で組み込まれており、一部のプラグインではその機能を利用する手段としてショートコードが利用されている。

使っていないか確認しないとね！（フィルター編）（2019年4月24日 更新）

先週末にWordPress 5.2 Beta3（以降5.2Beta3）が公開され、正式リリースまであとわずか。ソースコードの変更点を見ていくと、wp-login.phpの中に非推奨となったフィルターが目に留まった。

Login rebuilder 2.5.0の新機能紹介（2018年12月10日 更新）

今回追加したものは、任意の名前でロックファイルを設定し、そのファイルが存在する場合は常にログイン不可にする機能である。この機能を有効にしておくことで、何らかの理由により認証に関する情報が漏洩した場合でも不正なログインを防ぐことができる。

時代はWP_Queryなのか（2011年8月1日 更新）

WordPressのテーマ作成において、メインの投稿記事とは別に特定の条件を指定した投稿内容を表示することが多々ある。つい最近まで get_posts関数を使用することが多かったのだが、最近はWP_Queryクラスを使用することが多くなってきた。

query_posts（WP_Queryクラス）で'tax_query'を使いこなす（2011年9月14日 更新）

2日にわたって投稿した「query_posts（WP_Queryクラス）でカテゴリーを絞り込む」「query_posts（WP_Queryクラス）で投稿タグを絞り込む」の続き。今日はカテゴリーや投稿タグ以外ののタクソノミーによる絞り込み、複数のタクソノミーの絞り込みの組み合わせについてまとめてみる。