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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(Notes)
(最初の和訳。)
1行目: 1行目:
{{NeedTrans}}
+
<div id="Description">
 +
== 説明 ==
 +
</div>
  
== Description ==
+
ある投稿に付けられた[[カスタム分類|ターム]]を文字列として表示します。
  
Displays a string of linked [[Taxonomies | terms]] for a post.
+
<div id="Usage">
 
+
== 使い方 ==
== Usage ==
+
</div>
  
 
  <?php the_terms( $id, $taxonomy, $before, $sep, $after ); ?>
 
  <?php the_terms( $id, $taxonomy, $before, $sep, $after ); ?>
  
== Parameters ==
+
<div id="Parameters">
 +
== パラメータ ==
 +
</div>
  
{{Parameter|$id|integer|Post ID.}}
+
{{Parameter|$id|整数|投稿 ID}}
{{Parameter|$taxonomy|string|Taxonomy name.}}
+
{{Parameter|$taxonomy|文字列|タクソノミーの名前。}}
{{Parameter|$before|string|Text to display before the actual tags are displayed.|optional|Empty string}}
+
{{Parameter|$before|文字列|先頭のタームの前に表示する文字列。|オプション|空文字列}}
{{Parameter|$sep|string|Text or character to display between each tag link.|optional|', '}}
+
{{Parameter|$sep|文字列|ターム(およびリンク)を区切る文字列。|オプション|', '}}
{{Parameter|$after|string|Text to display after the last tag.|optional|Empty string}}
+
{{Parameter|$after|文字列|最後のタームに続けて表示する文字列。|オプション|空文字列}}
  
== Return Values ==
+
<div id="Return Values">
 +
== 戻り値 ==
 +
</div>
  
{{Return||false|Will return false on failure. Otherwise, it displays the linked terms of a custom taxonomies separated by user defined characters, and will not return a value.}}
+
{{Return||false|失敗すると false を返します。それ以外の場合、ユーザー定義の文字で区切ったカスタム分類のタームにリンクを付けて表示し、戻り値はありません。}}
  
== Examples ==
+
<div id="Examples">
 +
== 例 ==
 +
</div>
  
=== Get Categories of Current Post ===
+
<div id="Get Categories of Current Post">
 +
=== 現在の投稿のカテゴリーを表示 ===
 +
</div>
  
Get a list of current post's categories:
+
現在の投稿のカテゴリーをリスト表示します:
<pre><?php the_terms( $post->ID, 'category', 'categories: ', ' / ' ); ?></pre>
+
<pre><?php the_terms( $post->ID, 'category', 'カテゴリー: ', ' / ' ); ?></pre>
  
The output of above code will be: categories: TV / Speaker / Monitor
+
上記のコードの出力は例えば次のようになります: <code>カテゴリー: テレビ / スピーカー / モニター</code>
  
== Notes ==
+
<div id="Notes">
 +
== 参考 ==
 +
</div>
  
* Uses: <tt>[[関数リファレンス/get_the_term_list | get_the_term_list()]]</tt> - To retrieve the list of terms.
+
* <tt>[[関数リファレンス/get_the_term_list | get_the_term_list()]]</tt> を使ってタームのリストを取得します。
* Uses: <tt>[[関数リファレンス/apply_filters | apply_filters()]]</tt> - Calls <tt>[[Plugin_API/Filter_Reference/the_terms | 'the_terms']]</tt> with the list of terms, <tt>$taxonomy</tt>, <tt>$before</tt>, <tt>$sep</tt>, and <tt>$after</tt>.
+
* <tt>[[関数リファレンス/apply_filters | apply_filters()]]</tt> を使って、フィルター <tt>[[Plugin_API/Filter_Reference/the_terms | 'the_terms']]</tt> を呼び出します。パラメータはタームのリスト、<tt>$taxonomy</tt><tt>$before</tt><tt>$sep</tt> そして <tt>$after</tt> です。
  
== Change Log ==
+
<div id="Change Log">
 +
== 変更履歴 ==
 +
</div>
  
Since: [[Version_2.5 | 2.5.0]]
+
[[Version 2.5|2.5.0]] にて導入されました。
  
== Source File ==
+
<div id="Source File">
 +
== ソースファイル ==
 +
</div>
  
<tt>the_terms()</tt> is located in {{Trac|wp-includes/category-template.php}}.
+
<tt>the_terms()</tt> {{Trac|wp-includes/category-template.php}} にあります。
  
== Related ==
+
<div id="Related">
 +
== 関連項目 ==
 +
</div>
  
 
{{Term Tags}}
 
{{Term Tags}}
52行目: 70行目:
  
 
{{DEFAULTSORT:The_terms}}
 
{{DEFAULTSORT:The_terms}}
[[Category:Functions]]
+
[[Category:関数]]
 +
[[Category:タクソノミー]]
  
 
[[en:Function Reference/the_terms]]
 
[[en:Function Reference/the_terms]]

2014年7月31日 (木) 16:40時点における版

ある投稿に付けられたタームを文字列として表示します。

使い方

<?php the_terms( $id, $taxonomy, $before, $sep, $after ); ?>

パラメータ

$id
整数) (必須) 投稿 ID
初期値: なし
$taxonomy
文字列) (必須) タクソノミーの名前。
初期値: なし
$before
文字列) (オプション) 先頭のタームの前に表示する文字列。
初期値: 空文字列
$sep
文字列) (オプション) ターム(およびリンク)を区切る文字列。
初期値: ', '
$after
文字列) (オプション) 最後のタームに続けて表示する文字列。
初期値: 空文字列

戻り値

(false) 
失敗すると false を返します。それ以外の場合、ユーザー定義の文字で区切ったカスタム分類のタームにリンクを付けて表示し、戻り値はありません。

現在の投稿のカテゴリーを表示

現在の投稿のカテゴリーをリスト表示します:

<?php the_terms( $post->ID, 'category', 'カテゴリー: ', ' / ' ); ?>

上記のコードの出力は例えば次のようになります: カテゴリー: テレビ / スピーカー / モニター

参考

  • get_the_term_list() を使ってタームのリストを取得します。
  • apply_filters() を使って、フィルター 'the_terms' を呼び出します。パラメータはタームのリスト、$taxonomy$before$sep そして $after です。

変更履歴

2.5.0 にて導入されました。

ソースファイル

the_terms()wp-includes/category-template.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/the_terms最新版との差分