説明
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
関連
お勧め
ブロックエディターの色設定を変えてみる(2019年12月11日 更新)
バージョン5.3で機能強化されたブロックエディター。対応を考えて新テーマ「Twenty Twenty」のソースコードを眺めていく。
「姓」の後に「名」を(2013年11月6日 更新)
WordPressのユーザー情報設定ページでは、「名(First name)」の後に「姓(Last name)」を入力するようになっている。日本向けのユーザー登録できるサイトの場合、この並び順はちょっと違和感があるので、「姓」「名」の順に入力できるようにした。
ホームディレクトリから過去のファイルを削除する(2013年1月27日 更新)
WordPressで構築したサイトのホームディレクトリには、現在使われていないファイルが残っている時がある。3.5.1もリリースされたことだし、これを機にホームディレクトリを整理整頓した。Login rebuilder 2.6.5の新機能紹介(2021年3月8日 更新)
今回追加したものは、管理者のダッシュボードに表示されるログウィジェットの日時について任意の書式を設定する機能である。これまで日時の書式はサイト設定を利用していたが、ログの日時については揃えた方が見やすいと思ったので、今回の機能で対応することにしました。
投稿情報を連想配列で参照する(2018年5月27日 更新)
投稿情報は、タイトルや本文、投稿日時といったいくつかのデータが含んでおり、多くの場合オブジェクトになっている。これを連想配列で扱いたい場合はキャストして型変換することが多かった。基本的にはキャストで問題ないのだが、ふと目に留まったto_arrayメソッドが興味深かったのでメモとして残しておく。