関数リファレンス/get object taxonomies

説明

指定された投稿タイプまたは投稿オブジェクトに関連付けられた、すべてのタクソノミー（カスタム分類）を取得します。

使い方

<?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 （最新版との差分）