• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

関数リファレンス/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最新版との差分