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

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

「関数リファレンス/get taxonomy」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Function Reference/get taxonomy 10:45, 30 November 2013 Mistercat 版)
 
(関連項目: {{Tag Footer}})
 
(他の1人の利用者による、間の9版が非表示)
1行目: 1行目:
{{Languages|
+
<div id="Description">
{{en|Function Reference/get_taxonomy}}
+
== 説明 ==
{{it|Riferimento_funzioni/get_taxonomy}}
+
</div>
}}
+
  
== Description ==
+
タクソノミーの設定情報(メタデータ)が入ったオブジェクトを取得します。
Get the object containing a taxonomy's settings (metadata). 
+
  
Note that it does NOT return the list of terms associated with the taxonomy. To do this, you should use <tt>[[Function_Reference/wp_list_categories#Display_Terms_in_a_custom_taxonomy |wp_list_categories()]]</tt>
+
この関数はタクソノミーに関連付けられたターム(項目)のリストを返す'''のではない'''ことに注意して下さい。
 +
項目のリストを取得するには
 +
<tt>[[テンプレートタグ/wp list categories#Display_Terms_in_a_custom_taxonomy|wp_list_categories()]]</tt>
 +
を使います。
  
== Usage ==
+
<div id="Usage">
%%%<?php get_taxonomy( $taxonomy ) ?>%%%
+
== 使い方 ==
 +
</div>
  
==Parameters==
+
<?php get_taxonomy( $taxonomy ) ?>
{{Parameter|$taxonomy|string|The name of the taxonomy}}
+
  
==Return Values==
+
<div id="Parameters">
; <tt>(object)</tt> : Returns an object containing the taxonomy metadata on success.
+
== パラメータ ==
 +
</div>
  
Returns <tt>false</tt> if the taxonomy does not exist.
+
{{Parameter|$taxonomy|文字列|タクソノミーの名前}}
  
== Examples ==
+
<div id="Return Values">
For example for a custom taxonomy named "features" associated with a custom post type named "rentals".
+
== 戻り値 ==
 +
</div>
 +
 
 +
; <tt>(オブジェクト)</tt> : タクソノミーのメタデータが入ったオブジェクト(取得に成功した場合)。
 +
 
 +
タクソノミーが見つからない時は <tt>false</tt> を返します。
 +
 
 +
<div id="Examples">
 +
== 例 ==
 +
</div>
 +
 
 +
例えば "features" という名前のカスタム分類(タクソノミー)があって
 +
"rentals" という名前のカスタム投稿タイプに関連付けられているとします。
  
 
   $rental_features = get_taxonomy('features');
 
   $rental_features = get_taxonomy('features');
38行目: 52行目:
 
   [labels] =>  
 
   [labels] =>  
 
     stdClass Object (  
 
     stdClass Object (  
         [name] => Features
+
         [name] => 特徴
         [singular_name] => Feature
+
         [singular_name] => 特徴
         [search_items] => Search Features
+
         [search_items] => 特徴を検索
         [popular_items] => Popular Features
+
         [popular_items] => よくある特徴
         [all_items] => All Features
+
         [all_items] => すべての特徴
         [parent_item] => Parent Feature
+
         [parent_item] => この特徴の親
         [parent_item_colon] => Parent Feature:  
+
         [parent_item_colon] => この特徴の親:  
         [edit_item] => Edit Feature
+
         [edit_item] => 特徴を編集
         [update_item] => Update Feature
+
         [update_item] => 特徴を更新
         [add_new_item] => Add New Feature
+
         [add_new_item] => 新しい特徴を追加
         [new_item_name] => New Feature Name
+
         [new_item_name] => 新しい特徴の名前
         [separate_items_with_commas] => Separate Features with commas
+
         [separate_items_with_commas] => 特徴をコンマで区切る
         [add_or_remove_items] => Add or remove Features
+
         [add_or_remove_items] => 特徴の追加または削除
         [choose_from_most_used] => Choose from the most used Features
+
         [choose_from_most_used] => よく使われる特徴から選択
 
     )  
 
     )  
 
   [show_in_nav_menus] => 1  
 
   [show_in_nav_menus] => 1  
   [label] => Features
+
   [label] => 特徴
   [singular_label] => Feature
+
   [singular_label] => 特徴
 
   [cap] =>  
 
   [cap] =>  
 
     stdClass Object (  
 
     stdClass Object (  
66行目: 80行目:
 
   [object_type] =>  
 
   [object_type] =>  
 
     Array ( [0] => rentals [1] => rentals )  
 
     Array ( [0] => rentals [1] => rentals )  
)
+
  )
  
== Notes ==
+
<div id="Notes">
 +
== 参考 ==
 +
</div>
  
* Uses global: $wp_taxonomies (array)
+
* グローバル変数 $wp_taxonomies (配列) を使用します。
  
== Change Log ==
+
<div id="Change Log">
 +
== 改訂履歴 ==
 +
</div>
  
* Since: [[Version 2.3|2.3.0]]
+
* [[Version 2.3|2.3.0]] にて導入されました。
  
== Source File ==
+
<div id="Source File">
 +
== ソースファイル ==
 +
</div>
  
<tt>get_taxonomy()</tt> is located in {{Trac|wp-includes/taxonomy.php}}.
+
<tt>get_taxonomy()</tt> {{Trac|wp-includes/taxonomy.php}} にあります。
  
== Related ==
+
<div id="Related">
 +
== 関連項目 ==
 +
</div>
  
 
{{Taxonomy Tags}}
 
{{Taxonomy Tags}}
  
{{原文|Function Reference/get taxonomy|138643}}<!-- 10:45, 30 November 2013 Mistercat 版 -->
+
{{Tag Footer}}
 +
 
 +
{{原文|Function Reference/get taxonomy|138643}} <!-- 10:45, 30 November 2013 Mistercat 版 -->
  
[[Category:Functions]]
+
{{DEFAULTSORT:Get_taxonomy}}
 +
[[Category:関数]]
 +
[[Category:タクソノミー]]
  
 
[[en:Function Reference/get taxonomy]]
 
[[en:Function Reference/get taxonomy]]

2015年6月6日 (土) 08:49時点における最新版

タクソノミーの設定情報(メタデータ)が入ったオブジェクトを取得します。

この関数はタクソノミーに関連付けられたターム(項目)のリストを返すのではないことに注意して下さい。 項目のリストを取得するには wp_list_categories() を使います。

使い方

<?php get_taxonomy( $taxonomy ) ?>

パラメータ

$taxonomy
文字列) (必須) タクソノミーの名前
初期値: なし

戻り値

(オブジェクト) 
タクソノミーのメタデータが入ったオブジェクト(取得に成功した場合)。

タクソノミーが見つからない時は false を返します。

例えば "features" という名前のカスタム分類(タクソノミー)があって "rentals" という名前のカスタム投稿タイプに関連付けられているとします。

 $rental_features = get_taxonomy('features');
 print_r($rental_features);
 
 stdClass Object ( 
 [hierarchical] => 
 [update_count_callback] => 
 [rewrite] => 
     Array ( [slug] => features [with_front] => 1 ) 
 [query_var] => features 
 [public] => 1 
 [show_ui] => 1 
 [show_tagcloud] => 1 
 [_builtin] => 
 [labels] => 
   stdClass Object ( 
       [name] => 特徴 
       [singular_name] => 特徴 
       [search_items] => 特徴を検索 
       [popular_items] => よくある特徴 
       [all_items] => すべての特徴 
       [parent_item] => この特徴の親 
       [parent_item_colon] => この特徴の親: 
       [edit_item] => 特徴を編集 
       [update_item] => 特徴を更新 
       [add_new_item] => 新しい特徴を追加 
       [new_item_name] => 新しい特徴の名前 
       [separate_items_with_commas] => 特徴をコンマで区切る 
       [add_or_remove_items] => 特徴の追加または削除 
       [choose_from_most_used] => よく使われる特徴から選択 
    ) 
 [show_in_nav_menus] => 1 
 [label] => 特徴 
 [singular_label] => 特徴 
 [cap] => 
   stdClass Object ( 
       [manage_terms] => manage_categories 
       [edit_terms] => manage_categories 
       [delete_terms] => manage_categories 
       [assign_terms] => edit_posts 
   ) 
 [name] => features 
 [object_type] => 
   Array ( [0] => rentals [1] => rentals ) 
 )

参考

  • グローバル変数 $wp_taxonomies (配列) を使用します。

改訂履歴

  • 2.3.0 にて導入されました。

ソースファイル

get_taxonomy()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 taxonomy最新版との差分