Home > Reference > [WP]Category, Tag and Taxonomy Functions

[WP]Category, Tag and Taxonomy Functions

公式にあるFunction Referenceの自分用適当メモその2。
Category, Tag and Taxonomy Functionsの関数リストを上から順に書き散らした。
分からないのは華麗にスルー。

またまた長いけどこのまま行くことにした。途中で力尽きた

補足:
IDは作成順に振られますが、Category・LinkCategory・TagのIDは全部ひっくるめての通し番号になります。
なので、いきなりCategoryのID番号が飛ぶことがあります。

Category functions in category.php
カテゴリーに関連する関数。

get_all_category_ids

登録されている全てのカテゴリーIDを配列で返す。

get_categories(parameters)

parametersの指定にマッチしたカテゴリーをオブジェクト形式で返す。
パラメータはwp_list_categoriesと似てる。

get_category($category_id,$output,$filter)

指定したIDのカテゴリーをオブジェクト形式で返す。
$outputの引数をARRAY_Aにすると連想配列、ARRAY_Nにすると普通の配列で返す。

get_category_by_path($category_path, $full_match(bool), $output)

パスで指定したカテゴリーを返す。
?cat=n形式ではないURLのことらしい

get_category_by_slug($slug)

slugで指定したカテゴリーを返す。

get_cat_ID($category_name)

$cat_nameで指定したカテゴリーのIDを返す。日本語使えない。

get_cat_name($category_id)

IDで指定したカテゴリーの名前を返す。

cat_is_ancestor_of($cat1, $cat2)

$cat1で指定したカテゴリが$cat2の親である場合にtrueを返す。(どれだけ下の階層でもヒットすればtrue)
引数はカテゴリーIDで、数値でないと常にfalseになる。('1','4')ではなく(1,4)で指定。

Tag Functions in category.php
タグの関数。

get_tags()

タグを配列形式で返す。ループ外でも使用できる。

PHP:
  1. [0] => stdClass Object (
  2. [term_id] => 3
  3. [name] => wordpress
  4. [slug] => wordpress
  5. [term_group] => 0
  6. [term_taxonomy_id] => 3
  7. [taxonomy] => post_tag
  8. [description] =>
  9. [parent] => 0
  10. [count] => 1
  11. )
  12. )

get_tag($tag_id,$output,$filter)

指定したIDのタグを返す。デフォルトはオブジェクト形式。
$outputの引数をARRAY_Aにすると連想配列、ARRAY_Nにすると普通の配列。

Term Functions in taxonomy.php
categoryとかpostみたいな分類名についての関数。

is_taxonomy($taxonomy)

$taxonomyで指定した分類名が存在したらtrue、しなければfalseを返す。

is_taxonomy_hierarchical($taxonomy)

$taxonomyで指定したオブジェクトが階層的かどうか調べる。
階層が成立するか、という感じ?

get_term($term_id, $taxonomy, $output, $filter)

$term_idと$taxonomyで指定したオブジェクトを返す。

以下同じ結果になる

PHP:
  1. <div style="background-color:#CCCCCC">
  2. <?php
  3. print_r(get_category('1'));
  4. ?>
  5. </div>
  6. <div style="background-color:#ffCCCC">
  7. <?php
  8. $tarm = get_term(1,'category');
  9. print_r($tarm);
  10. ?>
  11. </div>

get_term_by($field, $value, $taxonomy, $output, $filter)

$taxonomyで指定した範囲内で、$fieldで指定したエリア'slug'、'name'、'id'に$valueで指定した値があるものをオブジェクトで返す。

PHP:
  1. $tarm = get_term_by('id','1','category');
  2. print_r($tarm);
  3. //実行結果
  4. //stdClass Object ( [term_id] => 1 [name] => Default [slug] => uncategorized [term_group] => 0 [term_taxonomy_id] => 1 [taxonomy] => category [description] => [parent] => 0 [count] => 1 )

get_term_children

get_terms

is_term

register_taxonomy

wp_get_object_terms

get_category_link

このエントリをはてなブックマークに追加このエントリをdel.icio.usに追加このエントリをLivedoor Clipに追加このエントリをYahoo!ブックマークに追加このエントリをFC2ブックマークに追加このエントリをNifty Clipに追加このエントリをPOOKMARK. Airlinesに追加このエントリをBuzzurl(バザール)に追加このエントリをChoixに追加このエントリをnewsingに追加

Comments:2

WebbingStudio 09-04-09 (木) 16:25

貴重なまとめ記事をありがとうございます。とても参考になりました!

MovableTypeにはカテゴリーの上下関係を調べる条件タグがあるのですが、
WordPressでは見当たらず、自分で関数を書いたりしていました。

cat_is_ancestor_of()という関数があったのですねorz
英語力が必要だと痛感しました。

Tenderfeel 09-04-13 (月) 14:31

いえ、中途半端な記事で申し訳ないです(== ;)
テンプレートタグにない便利な関数がコアにあったりしてるんですが、
それが利用できるのがWordoressのいいところかなと思ってます。

Comment Form
Remember personal info

Trackbacks:3

Trackback URL for this entry
http://tenderfeel.xsrv.jp/wordpress/reference/207/trackback/
Listed below are links to weblogs that reference
[WP]Category, Tag and Taxonomy Functions from WebTecNote
trackback from ウェビンブログ 09-04-11 (土) 16:08

<strong>MovableType・WordPressでカテゴリーの親子関係を判定する</strong>

先日の記事で、階層カテゴリーの親子関係の判定のために「最上層のIDを取得する方法」について書いたわけですが。
めげずに調べていたところ、こちらの記事でもっと簡潔な方法がが…

trackback from 機械忍者 09-08-30 (日) 0:50

<strong>特定のエントリーのタグ情報を引っ張り出す方法</strong>

やりたかったことは、
・amazonのwidgetにある「Amazonライブリンク」にキーワードをエントリー毎に投げたい
ってことでした。

※Amazonライブリンク
「ストア(本、ゲームとか)」を選択し…

pingback from 子孫含むカテゴリでの条件分岐【WordPress】 | tycolとweb 10-06-15 (火) 16:51

[...] フォーラム 条件分岐について [WP]Category, Tag and Taxonomy Functions [...]

Home > Reference > [WP]Category, Tag and Taxonomy Functions

最近の投稿
最近の修正
  • そしてこのSQLはわれながらよく書いたと思う 2010-11-15
  • CSVの列っていう方がいいのかな…118項目だった 2010-11-15
  • 楽天のCSVの項目が116個もあった衝撃 2010-11-15
  • オフィスで香水臭振りまくのは迷惑だと知れ 2010-11-15
  • ぐあー フレグランステロやー 2010-11-15
  • More updates...

Powered by Twitter Tools

Tag Cloud
おすすめサーバー・他
メタ情報

Return to page top