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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Function Reference/get term children 17:54, 20 November 2013 Dbetts 版を流し込み。)
 
(最初の和訳。)
1行目: 1行目:
{{NeedTrans}}
+
<div id="Description">
 +
== 説明 ==
 +
</div>
 +
子のタームをすべて、ひとつの配列にまとめます。
  
== Description ==
+
この関数は指定されたタームの子タームを、再帰的にすべて取得してひとつの配列に入れます。
Merge all term children into a single array.
+
階層のあるタクソノミーについてのみ有用です。
  
This recursive function will merge all of the children of <tt>$term</tt> into the same array. Only useful for taxonomies which are hierarchical.
+
もしタームが指定されたタクソノミーに無ければ、空の配列を返します。
  
Will return an empty array if <tt>$term</tt> does not exist in <tt>$taxonomy</tt>.
+
<div id="Usage">
 
+
== 使い方 ==
== Usage ==
+
</div>
 
  <?php get_term_children( $term, $taxonomy ) ?>
 
  <?php get_term_children( $term, $taxonomy ) ?>
  
== Parameters ==
+
<div id="Parameters">
{{Parameter|$term|string|ID of Term to get children}}
+
== パラメータ ==
{{Parameter|$taxonomy|string|Taxonomy Name}}
+
</div>
 +
{{Parameter|$term|文字列|子タームを取得するタームの ID}}
 +
{{Parameter|$taxonomy|文字列|タクソノミーの名前}}
  
== Return Values ==
+
<div id="Return Values">
; (array&#124;WP_Error) : Array of Term IDs. WP_Error returned if <tt>$taxonomy</tt> does not exist
+
== 戻り値 ==
 +
</div>
 +
; (配列&#124;WP_Error) : ターム ID の配列。タクソノミーが存在しなければ WP_Error を返す。
  
== Examples ==
+
<div id="Examples">
=== A Basic Example ===
+
== ==
 +
</div>
 +
<div id="A Basic Example">
 +
=== 基本的な例 ===
 +
</div>
  
Used to get an array of children taxonomies and write them out with links in an unordered list.
+
子タームの配列を取得して、リンクを付けて順序なしリスト形式で書き出します。
  
 
<pre><nowiki><?php
 
<pre><nowiki><?php
36行目: 47行目:
 
?> </nowiki></pre>
 
?> </nowiki></pre>
  
This would return something like.
+
次のような出力が得られるでしょう。
  
 
<pre><nowiki><ul>  
 
<pre><nowiki><ul>  
<li><a href="link_to_term_page">Term 1</a></li>
+
<li><a href="link_to_term_page">ターム 1</a></li>
<li><a href="link_to_term_page">Term 2</a></li>
+
<li><a href="link_to_term_page">ターム 2</a></li>
 
</ul></nowiki></pre>
 
</ul></nowiki></pre>
  
== Notes ==
+
<div id="Notes">
* Uses: [[Class Reference/wpdb|<tt>$wpdb</tt>]]
+
== 参考 ==
* Uses: [[Function_Reference/_get_term_hierarchy|<tt>_get_term_hierarchy()</tt>]]
+
</div>
* Uses: get_term_children Used to get the children of both <tt>$taxonomy</tt> and the parent <tt>$term</tt>
+
* グローバル変数 (<tt>object</tt>) [[クラスリファレンス/wpdb|<tt>$wpdb</tt>]] を使用します。
 +
* [[関数リファレンス/_get_term_hierarchy|<tt>_get_term_hierarchy()</tt>]] を使用します。
 +
* get_term_children 関数を再帰的に使って、<tt>$taxonomy</tt> と親の <tt>$term</tt> から子タームを取得します。
  
== Change Log ==
+
<div id="Change Log">
Since: 2.3.0
+
== 変更履歴 ==
 +
</div>
 +
バージョン [[Version 2.3|2.3.0]] にて導入されました。
  
== Source File ==
+
<div id="Source File">
<!-- Need links to current source code files -->
+
== ソースファイル ==
<tt>get_term_children()</tt> is located in {{Trac|wp-includes/taxonomy.php}}.
+
</div>
 +
<tt>get_term_children()</tt> {{Trac|wp-includes/taxonomy.php}} にあります。
  
== Related ==
+
<div id="Related">
 +
== 関連項目 ==
 +
</div>
 
{{Term Tags}}
 
{{Term Tags}}
  
63行目: 81行目:
  
 
{{DEFAULTSORT:Get_term_children}}
 
{{DEFAULTSORT:Get_term_children}}
[[Category:Functions]]
+
[[Category:関数]]
[[Category:New_page_created]]
+
  
 
[[en:Function Reference/get term children]]
 
[[en:Function Reference/get term children]]

2014年7月30日 (水) 23:20時点における版

子のタームをすべて、ひとつの配列にまとめます。

この関数は指定されたタームの子タームを、再帰的にすべて取得してひとつの配列に入れます。 階層のあるタクソノミーについてのみ有用です。

もしタームが指定されたタクソノミーに無ければ、空の配列を返します。

使い方

<?php get_term_children( $term, $taxonomy ) ?>

パラメータ

$term
文字列) (必須) 子タームを取得するタームの ID
初期値: なし
$taxonomy
文字列) (必須) タクソノミーの名前
初期値: なし

戻り値

(配列|WP_Error) 
ターム ID の配列。タクソノミーが存在しなければ WP_Error を返す。

基本的な例

子タームの配列を取得して、リンクを付けて順序なしリスト形式で書き出します。

<?php
$term_id = 10;
$taxonomy_name = 'products';
$termchildren = get_term_children( $term_id, $taxonomy_name );

echo '<ul>';
foreach ( $termchildren as $child ) {
	$term = get_term_by( 'id', $child, $taxonomy_name );
	echo '<li><a href="' . get_term_link( $child, $taxonomy_name ) . '">' . $term->name . '</a></li>';
}
echo '</ul>';
?> 

次のような出力が得られるでしょう。

<ul> 
<li><a href="link_to_term_page">ターム 1</a></li>
<li><a href="link_to_term_page">ターム 2</a></li>
</ul>

参考

  • グローバル変数 (object) $wpdb を使用します。
  • _get_term_hierarchy() を使用します。
  • get_term_children 関数を再帰的に使って、$taxonomy と親の $term から子タームを取得します。

変更履歴

バージョン 2.3.0 にて導入されました。

ソースファイル

get_term_children()wp-includes/taxonomy.php にあります。

タームタグ: 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 term children最新版との差分