当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Function_Reference/get_taxonomies 19:02, 18 February 2013 Veraxus 版)
 
(最新版のマージ <!--18:43, 2 November 2014‎ Realloc 版 -->)
 
(2人の利用者による、間の9版が非表示)
1行目: 1行目:
{{NeedTrans}}
+
<div id="Description">
 +
== 説明 ==
 +
</div>
 +
登録済みタクソノミーのオブジェクトのリストを取得します。
  
== Description ==
+
<div id="Usage">
 
+
== 使い方 ==
Get a list of registered taxonomy objects.
+
</div>
 
+
<pre>
== Usage ==
+
<?php get_taxonomies( $args, $output, $operator ) ?>
 
+
</pre>
%%% <?php get_taxonomies( $args, $output, $operator ) ?> %%%
+
  
== Parameters ==
+
<div id="Parameters">
 +
== パラメータ ==
 +
</div>
  
{{Parameter|$args|array|An array of key -> value arguments to match against the taxonomies. Only taxonomies having attributes that match all arguments are returned.|optional}}
+
{{Parameter|$args|配列|タクソノミーを検索する為の「キー -> 値」の配列です。すべての引数にマッチするタクソノミーだけを取得します。|オプション}}
 +
以下のキーが使えます。
 
* name  
 
* name  
* object_type (array)
+
* object_type (配列)
 
* label
 
* label
 
* singular_label
 
* singular_label
28行目: 33行目:
 
* _builtin  
 
* _builtin  
  
{{Parameter|$output|string|The type of output to return, either taxonomy 'names' or 'objects'.|optional|'names'}}
+
{{Parameter|$output|文字列|出力形式を指定します。タクソノミーの 'names' または 'objects' です。|オプション|'names'}}
  
{{Parameter|$operator|string|Operator (and/or) to use with multiple $args.|optional|and}}
+
{{Parameter|$operator|文字列|$args に引数を2つ以上入れた場合の結合方法 ( and または or ) です。|オプション|and}}
 
+
== Return Value ==
+
 
+
; array : A list of taxonomy names or objects.  If returning names, you will get an array of the taxonomy names such as
+
  
 +
<div id="Return_Value">
 +
== 戻り値 ==
 +
</div>
 +
; 配列 : タクソノミーの名前またはオブジェクトのリスト。名前の場合、タクソノミーの名前を次のような配列として取得します。
 
<pre>
 
<pre>
 
Array ( [special_taxonomy] => special_taxonomy [custom_taxonomy] => custom_taxonomy )
 
Array ( [special_taxonomy] => special_taxonomy [custom_taxonomy] => custom_taxonomy )
 
</pre>
 
</pre>
  
If returning objects, you will get an array of objects such as:
+
オブジェクトの場合、次のようなオブジェクトの配列になります。
 
+
 
<pre>
 
<pre>
 
Array ( [special_taxonomy] => stdClass Object  [custom_taxonomy] => stdClass Object  )
 
Array ( [special_taxonomy] => stdClass Object  [custom_taxonomy] => stdClass Object  )
 
</pre>
 
</pre>
  
wherein each object will contain the following fields:
+
オブジェクトはそれぞれ、以下のようなフィールドを持ちます。
 
<pre>
 
<pre>
 
stdClass Object (  
 
stdClass Object (  
86行目: 90行目:
 
</pre>
 
</pre>
  
== Examples ==
+
<div id="Examples">
=== Default Usage ===
+
== 例 ==
 +
</div>
 +
<div id="Default_Usage">
 +
=== デフォルトの使い方 ===
 +
</div>
 +
次のように呼び出すと [[関数リファレンス/get_taxonomies|get_taxonomies]] は登録済みのカスタム分類を返します。
 +
<pre>
 +
<?php $taxonomies = get_taxonomies(); ?>
 +
</pre>
  
The call to [[Function Reference/get_taxonomies|get_taxonomies]] returns the registered taxonomies.
+
<div id="Output_a_list_all_registered_taxonomies">
 +
=== すべての登録済みカスタム分類のリストを出力 ===
 +
</div>
 +
<pre>
 +
<?php
  
<?php $taxonomies=get_taxonomies(); ?>
+
$taxonomies = get_taxonomies();  
 +
foreach ( $taxonomies as $taxonomy ) {
 +
    echo '<p>' . $taxonomy . '</p>';
 +
}
  
===Output a list all registered taxonomies===
 
<pre>
 
<?php
 
$taxonomies=get_taxonomies('','names');
 
foreach ($taxonomies as $taxonomy ) {
 
  echo '<p>'. $taxonomy. '</p>';
 
}
 
 
?>
 
?>
 
</pre>
 
</pre>
  
===Output a list of all public custom taxonomies===
+
<div id="Output_a_list_of_all_public_custom_taxonomies">
This return all custom (not builtin) taxonomies.
+
=== すべてのカスタムタクソノミーのリストを出力 ===
 +
</div>
 +
次のように呼び出すと、すべてのカスタムタクソノミー(組み込みのものを除く)を返します。
 
<pre>
 
<pre>
 
<?php  
 
<?php  
123行目: 137行目:
 
</pre>
 
</pre>
  
===Output a named taxonomy===
+
<div id="Output_a_named_taxonomy">
This example uses the 'object' output to retrieve and display the taxonomy called 'genre':
+
=== 名前を指定してタクソノミーを出力 ===
 +
</div>
 +
以下の例は 'object' 形式の出力を取得して、 'genre' という名前のタクソノミーを表示します。
 
<pre>
 
<pre>
 
<?php  
 
<?php  
130行目: 146行目:
 
   'name' => 'genre'
 
   'name' => 'genre'
 
);
 
);
$output = 'objects'; // or objects
+
$output = 'objects'; // or names
 
$taxonomies=get_taxonomies($args,$output);  
 
$taxonomies=get_taxonomies($args,$output);  
 
if  ($taxonomies) {
 
if  ($taxonomies) {
140行目: 156行目:
 
</pre>
 
</pre>
  
== Source File ==
+
<div id="Source_File">
<tt>get_taxonomies()</tt> is located in {{Trac|wp-includes/taxonomy.php}}.
+
== ソースファイル ==
 +
</div>
 +
<tt>get_taxonomies()</tt> {{Trac|wp-includes/taxonomy.php}} にあります。
  
== Change Log ==
+
<div id="Change_Log">
 +
== 変更履歴 ==
 +
</div>
 +
* [[Version 3.0|3.0.0]] から導入されました。
  
* Since: 3.0.0
+
<div id="Related">
 
+
== 関連情報 ==
== Related ==
+
</div>
{{Term Tags}}
+
{{Taxonomy Tags}}
 +
<!-- {{Term Tags}} -->
  
 
{{Tag Footer}}
 
{{Tag Footer}}
  
{{原文|Function_Reference/get_taxonomies|127496}}<!--19:02, 18 February 2013 Veraxus -->
+
{{原文|Function_Reference/get_taxonomies|147772}}<!--18:43, 2 November 2014‎ Realloc 版 -->
 
+
[[Category:Template Tags]]
+
[[Category:Taxonomies]]
+
  
 +
{{DEFAULTSORT:Get_taxonomies}}
 +
[[Category:テンプレートタグ]]
 +
[[Category:タクソノミー]]
 +
[[Category:wp3.0]]
 
[[en:Function_Reference/get_taxonomies]]
 
[[en:Function_Reference/get_taxonomies]]

2015年8月14日 (金) 08:30時点における最新版

登録済みタクソノミーのオブジェクトのリストを取得します。

使い方

<?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(); 
foreach ( $taxonomies as $taxonomy ) {
    echo '<p>' . $taxonomy . '</p>';
}

?>

すべてのカスタムタクソノミーのリストを出力

次のように呼び出すと、すべてのカスタムタクソノミー(組み込みのものを除く)を返します。

<?php 
$args = array(
  'public'   => true,
  '_builtin' => false
  
); 
$output = 'names'; // or objects
$operator = 'and'; // 'and' or 'or'
$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'; // or names
$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 から導入されました。

カスタム分類: 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_taxonomies最新版との差分