- 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細)
関数リファレンス/get object taxonomies
提供: WordPress Codex 日本語版
< 関数リファレンス
目次
説明
指定された投稿タイプまたは投稿オブジェクトに関連付けられた、すべてのタクソノミー(カスタム分類)を取得します。
使い方
<?php get_object_taxonomies( $object, $output ); ?>
パラメータ
- $object
- (配列|文字列|オブジェクト) (必須) 投稿タイプの名前、または一個の投稿オブジェクト(配列 posts の要素)
- 初期値: なし
- $output
- (文字列) (オプション) 戻り値のタイプを、タクソノミーの 'names' (名前)または 'objects' (オブジェクト)の何れかで指定。
- 初期値: 'names'
戻り値
- (配列)
- 指定された投稿タイプまたは投稿オブジェクトに関連付けられた、すべてのタクソノミーの名前またはオブジェクト
例
投稿タイプに付けられたタクソノミーの名前
<?php $taxonomy_names = get_object_taxonomies( 'post' ); print_r( $taxonomy_names ); ?>
上記からは例えば次のような出力が得られます:
Array ( [0] => category [1] => post_tag [2] => post_format )
投稿タイプに付けられたタクソノミーのオブジェクト
パラメータ $output に 'objects' を指定すると、 get_taxonomies() に示されたようなタクソノミーのオブジェクトが返されます。
<?php $taxonomy_objects = get_object_taxonomies( 'post', 'objects' ); print_r( $taxonomy_objects ); ?>
上記は次のように出力します:
Array ( [category] => stdClass Object ( [hierarchical] => 1 [update_count_callback] => [rewrite] => [query_var] => category_name [public] => 1 [show_ui] => 1 [show_tagcloud] => 1 [_builtin] => 1 [labels] => stdClass Object ( ... ) ... [name] => category [label] => Categories ) [post_tag] => stdClass Object ( ... ) [post_format] => stdClass Object ( .... ) )
投稿オブジェクトに付けられたタクソノミーの名前
(ループの中で)現在の投稿に付けられたタクソノミーを取得するには、投稿タイプの代わりに現在の投稿オブジェクトをパラメータにします。
<?php function get_current_post_taxonomies(){ global $post; $taxonomy_names = get_object_taxonomies( $post ); print_r( $taxonomy_names ); } add_action( 'wp_head’, ‘get_current_post_taxonomies' ); ?>
上記は次のように出力します:
Array ( [0] => category [1] => post_tag [2] => post_format )
変更履歴
バージョン 2.3.0 にて導入されました。
ソースファイル
get_object_taxonomies() は wp-includes/taxonomy.php
にあります。
関連項目
カスタム分類: get_taxonomy(), taxonomy_exists(), register_taxonomy(), get_taxonomies(), the_taxonomies(), get_taxonomy_labels(), get_taxonomy_template(), is_object_in_taxonomy(), get_the_taxonomies(), get_post_taxonomies(), get_object_taxonomies(), is_taxonomy_hierarchical()
関数リファレンス、テンプレートタグ目次もご覧ください。
最新英語版: WordPress Codex » Function Reference/get object taxonomies (最新版との差分)