- 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細)
「関数リファレンス/get taxonomies」の版間の差分
(初めての翻訳。) |
|||
1行目: | 1行目: | ||
− | + | == 解説 == | |
− | + | 登録済みタクソノミーのオブジェクトのリストを取得します。 | |
− | + | == 使用例 == | |
− | + | <pre> | |
− | + | <?php get_taxonomies( $args, $output, $operator ) ?> | |
− | + | </pre> | |
− | == | + | == 引数 == |
− | {{Parameter|$args| | + | {{Parameter|$args|配列|タクソノミーを検索する為の「キー -> 値」の配列です。すべての引数にマッチするタクソノミーだけを取得します。|オプション}} |
+ | 以下のキーが使えます。 | ||
* name | * name | ||
− | * object_type ( | + | * object_type (配列) |
* label | * label | ||
* singular_label | * singular_label | ||
28行目: | 29行目: | ||
* _builtin | * _builtin | ||
− | {{Parameter|$output| | + | {{Parameter|$output|文字列|出力形式を指定します。タクソノミーの 'names' または 'objects' です。|オプション|'names'}} |
− | {{Parameter|$operator| | + | {{Parameter|$operator|文字列|$args に引数を2つ以上入れた場合の結合方法 ( and または or ) です。|オプション|and}} |
− | == | + | == 戻り値 == |
− | + | ||
− | + | ||
+ | ; 配列 : タクソノミーの名前またはオブジェクトのリスト。名前の場合、タクソノミーの名前を次のような配列として取得します。 | ||
<pre> | <pre> | ||
Array ( [special_taxonomy] => special_taxonomy [custom_taxonomy] => custom_taxonomy ) | Array ( [special_taxonomy] => special_taxonomy [custom_taxonomy] => custom_taxonomy ) | ||
</pre> | </pre> | ||
− | + | オブジェクトの場合、次のようなオブジェクトの配列になります。 | |
− | + | ||
<pre> | <pre> | ||
Array ( [special_taxonomy] => stdClass Object [custom_taxonomy] => stdClass Object ) | Array ( [special_taxonomy] => stdClass Object [custom_taxonomy] => stdClass Object ) | ||
</pre> | </pre> | ||
− | + | オブジェクトはそれぞれ、以下のようなフィールドを持ちます。 | |
<pre> | <pre> | ||
stdClass Object ( | stdClass Object ( | ||
86行目: | 85行目: | ||
</pre> | </pre> | ||
− | == | + | == 例 == |
− | === | + | === デフォルト === |
− | + | 次のように呼び出すと [[関数リファレンス/get_taxonomies|get_taxonomies]] は登録済みタクソノミーを返します。 | |
+ | <pre> | ||
+ | <?php $taxonomies=get_taxonomies(); ?> | ||
+ | </pre> | ||
− | + | === すべての登録済みタクソノミーのリストを出力 === | |
− | |||
<pre> | <pre> | ||
<?php | <?php | ||
103行目: | 104行目: | ||
</pre> | </pre> | ||
− | === | + | === すべてのカスタムタクソノミーのリストを出力 === |
− | + | ||
+ | 次のように呼び出すと、すべてのカスタムタクソノミー(組み込みのものを除く)を返します。 | ||
<pre> | <pre> | ||
<?php | <?php | ||
112行目: | 114行目: | ||
); | ); | ||
− | $output = 'names'; | + | $output = 'names'; |
− | $operator = 'and'; | + | $operator = 'and'; |
$taxonomies = get_taxonomies( $args, $output, $operator ); | $taxonomies = get_taxonomies( $args, $output, $operator ); | ||
if ( $taxonomies ) { | if ( $taxonomies ) { | ||
− | foreach ( $taxonomies | + | foreach ( $taxonomies as $taxonomy ) { |
echo '<p>' . $taxonomy . '</p>'; | echo '<p>' . $taxonomy . '</p>'; | ||
} | } | ||
123行目: | 125行目: | ||
</pre> | </pre> | ||
− | === | + | === 名前を指定してタクソノミーを出力 === |
− | + | ||
+ | 以下の例は 'object' 形式の出力を取得して、 'genre' という名前のタクソノミーを表示します。 | ||
<pre> | <pre> | ||
<?php | <?php | ||
130行目: | 133行目: | ||
'name' => 'genre' | 'name' => 'genre' | ||
); | ); | ||
− | $output = 'objects'; | + | $output = 'objects'; |
− | $taxonomies=get_taxonomies($args,$output); | + | $taxonomies = get_taxonomies( $args, $output ); |
− | if | + | if ( $taxonomies ) { |
− | foreach ($taxonomies | + | foreach ( $taxonomies as $taxonomy ) { |
echo '<p>' . $taxonomy->name . '</p>'; | echo '<p>' . $taxonomy->name . '</p>'; | ||
} | } | ||
140行目: | 143行目: | ||
</pre> | </pre> | ||
− | == | + | == ソースファイル == |
− | <tt>get_taxonomies()</tt> | + | |
+ | <tt>get_taxonomies()</tt> は {{Trac|wp-includes/taxonomy.php}} にあります。 | ||
+ | |||
+ | == 変更履歴 == | ||
− | + | * [[Version 3.0|3.0.0]] から導入されました。 | |
− | + | == 関連情報 == | |
− | |||
{{Term Tags}} | {{Term Tags}} | ||
2014年6月9日 (月) 21:26時点における版
目次
解説
登録済みタクソノミーのオブジェクトのリストを取得します。
使用例
<?php get_taxonomies( $args, $output, $operator ) ?>
引数
- $args
- (配列) (オプション) タクソノミーを検索する為の「キー -> 値」の配列です。すべての引数にマッチするタクソノミーだけを取得します。
- 初期値: なし
以下のキーが使えます。
- name
- object_type (配列)
- label
- singular_label
- show_ui
- show_tagcloud
- public
- update_count_callback
- rewrite
- query_var
- manage_cap
- edit_cap
- delete_cap
- assign_cap
- _builtin
- $output
- (文字列) (オプション) 出力形式を指定します。タクソノミーの 'names' または 'objects' です。
- 初期値: 'names'
- $operator
- (文字列) (オプション) $args に引数を2つ以上入れた場合の結合方法 ( and または or ) です。
- 初期値: and
戻り値
- 配列
- タクソノミーの名前またはオブジェクトのリスト。名前の場合、タクソノミーの名前を次のような配列として取得します。
Array ( [special_taxonomy] => special_taxonomy [custom_taxonomy] => custom_taxonomy )
オブジェクトの場合、次のようなオブジェクトの配列になります。
Array ( [special_taxonomy] => stdClass Object [custom_taxonomy] => stdClass Object )
オブジェクトはそれぞれ、以下のようなフィールドを持ちます。
stdClass Object ( [hierarchical] => [update_count_callback] => [rewrite] => [query_var] => [public] => [show_ui] => [show_tagcloud] => [_builtin] => [labels] => stdClass Object ( [name] => [singular_name] => [search_items] => [popular_items] => [all_items] => [parent_item] => [parent_item_colon] => [edit_item] => [view_item] => [update_item] => [add_new_item] => [new_item_name] => [separate_items_with_commas] => [add_or_remove_items] => [choose_from_most_used] => [menu_name] => [name_admin_bar] => ) [show_in_nav_menus] => [cap] => stdClass Object ( [manage_terms] => [edit_terms] => [delete_terms] => [assign_terms] => ) [name] => [object_type] => Array () [label] )
例
デフォルト
次のように呼び出すと get_taxonomies は登録済みタクソノミーを返します。
<?php $taxonomies=get_taxonomies(); ?>
すべての登録済みタクソノミーのリストを出力
<?php $taxonomies=get_taxonomies('','names'); foreach ($taxonomies as $taxonomy ) { echo '<p>'. $taxonomy. '</p>'; } ?>
すべてのカスタムタクソノミーのリストを出力
次のように呼び出すと、すべてのカスタムタクソノミー(組み込みのものを除く)を返します。
<?php $args = array( 'public' => true, '_builtin' => false ); $output = 'names'; $operator = 'and'; $taxonomies = get_taxonomies( $args, $output, $operator ); if ( $taxonomies ) { foreach ( $taxonomies as $taxonomy ) { echo '<p>' . $taxonomy . '</p>'; } } ?>
名前を指定してタクソノミーを出力
以下の例は 'object' 形式の出力を取得して、 'genre' という名前のタクソノミーを表示します。
<?php $args=array( 'name' => 'genre' ); $output = 'objects'; $taxonomies = get_taxonomies( $args, $output ); if ( $taxonomies ) { foreach ( $taxonomies as $taxonomy ) { echo '<p>' . $taxonomy->name . '</p>'; } } ?>
ソースファイル
get_taxonomies() は wp-includes/taxonomy.php
にあります。
変更履歴
- 3.0.0 から導入されました。
関連情報
タームタグ: is_term(), term_exists(), get_objects_in_term(), get_term(), get_term_by(), get_term_children(), get_term_link(), get_terms(), get_the_terms(), get_the_term_list(), has_term(), sanitize_term(), the_terms(), get_object_taxonomies() is_object_in_taxonomy() the_taxonomies() wp_get_object_terms(), wp_set_object_terms(), wp_get_post_terms(), wp_set_post_terms(), wp_delete_object_term_relationships()
最新英語版: WordPress Codex » Function_Reference/get_taxonomies (最新版との差分)