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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Function Reference/get the terms 19:26, 15 April 2014 Sam 版を流し込み。)
 
(関数リファレンス/get term に(間違えて?)入っていた内容をこちらへ移動。2011年2月17日 (木) 16:08 Takahashi Fumiki 版から。)
1行目: 1行目:
{{NeedTrans}}
+
{{Old}}
  
== Description ==
+
<div id="Description">
 +
== 解説 ==
 +
</div>
  
Retrieve the terms of the taxonomy that are attached to the post.
+
投稿に割り当てられたタクソノミーを取得する。この関数はループ内でのみ使用される。〔※訳注 ループ外でも使用できる〕
  
== Usage ==
+
<div id="Usage">
 
+
== 使用例 ==
<?php get_the_terms( $id, $taxonomy ); ?>
+
</div>
 
+
== Parameters ==
+
 
+
{{Parameter|$id|int|Post ID|required|0}}
+
{{Parameter|$taxonomy|string&#124;array|Name of [[Taxonomies|taxonomy]] to retrieve terms from. For example: 'category', 'post_tag', 'taxonomy slug'}}
+
 
+
== Returns ==
+
 
+
; (array|false|wp_error) :  Array of term objects on success; <code>false</code> if the post contains no terms from the given taxonomy; <code>false</code> if the post doesn't exist; and a [[Class_Reference/WP_Error|Class_Reference/WP_Error]] object if an invalid taxonomy is entered.
+
 
+
A post with no terms assigned gives a <code>false</code> result, not an empty array.
+
 
+
Each term object will contain the following fields:
+
  
 
<pre>
 
<pre>
stdClass Object
+
&laquo;? php get_the_terms( $id, $taxonomy ) ?&raquo;
(
+
    [term_id] =>
+
    [name] =>
+
    [slug] =>
+
    [term_group] =>
+
    [term_order] =>
+
    [term_taxonomy_id] =>
+
    [taxonomy] =>
+
    [description] =>
+
    [parent] =>
+
    [count] =>
+
    [object_id] =>
+
)
+
 
</pre>
 
</pre>
  
== Example ==
+
<div id="Parameters">
 +
== 引数 ==
 +
</div>
  
=== A Basic Example ===
+
{{Parameter|$id|int|投稿ID|必須|0}}
Echoing the list of terms (for a taxonomy called on-draught). This is similar to the output from get_the_term_list, but without the terms being hyperlinked:
+
{{Parameter|$taxonomy|string|タクソノミー名}}
  
<pre>
+
<div id="Returns">
<?php
+
== 戻り値 ==
$terms = get_the_terms( $post->ID, 'on-draught' );
+
</div>
+
if ( $terms && ! is_wp_error( $terms ) ) :
+
  
$draught_links = array();
+
; (array|bool) :  取得できない場合は<tt>false</tt>。成功した場合はタームオブジェクトからなる配列。
  
foreach ( $terms as $term ) {
+
<div id="Example">
$draught_links[] = $term->name;
+
== 例 ==
}
+
</div>
+
$on_draught = join( ", ", $draught_links );
+
?>
+
  
<p class="beers draught">
+
<div id="A_Basic_Example">
On draught: <span><?php echo $on_draught; ?></span>
+
=== 基本的な例 ===
</p>
+
</div>
  
<?php endif; ?>
+
<div id="Notes">
 +
== 注意点 ==
 +
</div>
  
</pre>
+
結果を取得するために<tt>get_object_term_cache()</tt><tt>wp_get_object_terms()</tt>を使います。
=== Get terms for all custom taxonomies ===
+
place this function in theme functions.php
+
<pre>
+
<?php
+
// get taxonomies terms links
+
function custom_taxonomies_terms_links(){
+
  // get post by post id
+
  $post = get_post( $post->ID );
+
  
  // get post type by post
+
<div id="Change_Log">
  $post_type = $post->post_type;
+
== 改訂履歴 ==
 
+
</div>
  // get post type taxonomies
+
  $taxonomies = get_object_taxonomies( $post_type, 'objects' );
+
 
+
  $out = array();
+
  foreach ( $taxonomies as $taxonomy_slug => $taxonomy ){
+
 
+
    // get the terms related to post
+
    $terms = get_the_terms( $post->ID, $taxonomy_slug );
+
 
+
    if ( !empty( $terms ) ) {
+
      $out[] = "<h2>" . $taxonomy->label . "</h2>\n<ul>";
+
      foreach ( $terms as $term ) {
+
        $out[] =
+
          '  <li><a href="'
+
        .    get_term_link( $term->slug, $taxonomy_slug ) .'">'
+
        .    $term->name
+
        . "</a></li>\n";
+
      }
+
      $out[] = "</ul>\n";
+
    }
+
  }
+
 
+
  return implode('', $out );
+
}
+
?>
+
</pre>
+
Now you can use this function in your themes for your post types without the need to input anything
+
 
+
<pre>
+
<?php echo custom_taxonomies_terms_links(); ?>
+
</pre>
+
 
+
== Notes ==
+
 
+
It uses <tt>get_object_term_cache()</tt> or <tt>wp_get_object_terms()</tt> to retrieve results.
+
 
+
== Change Log ==
+
  
 
* Since: [[Version 2.5|2.5.0]]
 
* Since: [[Version 2.5|2.5.0]]
  
== Source File ==
+
<div id="Source File">
 
+
== ソースファイル ==
<tt>get_the_terms()</tt> is located in {{Trac|wp-includes/category-template.php}}.
+
</div>
 
+
== Related ==
+
 
+
{{Term Tags}}
+
  
{{Tag Footer}}
+
<tt>get_the_terms()</tt>は<tt>wp-includes/category-template.php</tt>にあります。
  
{{原文|Function Reference/get the terms|142711}} <!-- 19:26, 15 April 2014 Sam 版 -->
+
<div id="Related ">
 +
== 関連項目 ==
 +
</div>
 +
[[関数リファレンス/get_the_term_list|get_the_term_list()]],
 +
[[関数リファレンス/wp_get_object_terms|wp_get_object_terms()]]
  
{{DEFAULTSORT:Get_the_terms}}
 
[[Category:Functions]]
 
[[Category:Taxonomies]]
 
  
[[en:Function Reference/get the terms]]
+
[[Category:関数リファレンス]]

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

このページ「関数リファレンス/get the terms」は情報が古くなっている可能性があります。最新版英語)も合わせてご覧ください。翻訳にご協力くださる方はぜひご相談ください

投稿に割り当てられたタクソノミーを取得する。この関数はループ内でのみ使用される。〔※訳注 ループ外でも使用できる〕

使用例

«? php get_the_terms( $id, $taxonomy ) ?»

引数

$id
int) (必須) 投稿ID
初期値: 0
$taxonomy
string) (必須) タクソノミー名
初期値: なし

戻り値

(array|bool) 
取得できない場合はfalse。成功した場合はタームオブジェクトからなる配列。

基本的な例

注意点

結果を取得するためにget_object_term_cache()wp_get_object_terms()を使います。

改訂履歴

ソースファイル

get_the_terms()wp-includes/category-template.phpにあります。

get_the_term_list(), wp_get_object_terms()