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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Function Reference/get tag 21:37, 27 February 2009 CharlesClarkson)
 
(全体を和訳。説明部分をソースに沿って正確に記述。)
1行目: 1行目:
== Description ==
+
<div id="Description">
Retrieve post tag by tag ID or tag object.
+
== 説明 ==
 +
</div>
  
If you pass the <tt>$tag</tt> parameter an object, which is assumed to be the tag row object retrieved the database. It will cache the tag data.
+
タグ ID またはタグオブジェクトで指定したタグの行オブジェクトを取得します。
  
If you pass <tt>$tag</tt> an integer of the tag ID, then that tag will be retrieved from the database, if it isn't already cached, and pass it back.
+
内部で [[関数リファレンス/get_term|<tt>get_term()</tt>]] を呼んでおり、''get_term'' と ''get_post_tag'' のフィルターをフックします。
 +
<tt>$filter</tt> が <var>raw</var> でなければ無害化も行います。
 +
<tt>$tag</tt> がタグオブジェクトで、<tt>$filter</tt> が <tt>empty()</tt> 関数で <var>true</var> となる値(<var>空文字</var>, <var>0</var>, <var>'0'</var>, <var>null</var> など)の場合、<tt>$tag</tt> をキャッシュします。
  
If you look at [[Function_Reference/get_term|<tt>get_term()</tt>]], then both types will be passed through several filters and finally sanitized based on the <tt>$filter</tt> parameter value.
 
  
== Usage ==
+
<div id="Usage">
%%%<?php &get_tag( $tag, $output, $filter ) ?>%%%
+
== 使い方 ==
 +
</div>
  
== Parameters ==
+
<?php &get_tag( $tag, $output, $filter ) ?>
{{Parameter|$tag|integer&#124;object|}}
+
{{Parameter|$output|string|Constant OBJECT, ARRAY_A, or ARRAY_N|optional|OBJECT}}
+
{{Parameter|$filter|string|Default is raw or no WordPress defined filter will applied.|optional|'raw'}}
+
  
== Return Values ==
+
<div id="Parameters">
; (object&#124;array) : Return type based on <tt>$output</tt> value.
+
== パラメータ ==
 +
</div>
 +
 
 +
{{Parameter|$tag|整数&#124;オブジェクト|}}
 +
{{Parameter|$output|文字列|OBJECT, ARRAY_A または ARRAY_N|オプション|OBJECT}}
 +
{{Parameter|$filter|string|初期値の 'raw' では無害化を行いません。|オプション|'raw'}}
 +
 
 +
<div id="Return_Values">
 +
== 戻り値 ==
 +
</div>
 +
 
 +
; (オブジェクト&#124;配列) : 戻り値の型は <tt>$output</tt> の指定によります.
 +
 
 +
<div id="Examples">
 +
== 用例 ==
 +
</div>
  
== Examples ==
 
 
<!-- Need creative examples. Feel free to link to external examples. -->
 
<!-- Need creative examples. Feel free to link to external examples. -->
  
== Notes ==
+
<div id="Notes">
 +
== 注 ==
 +
</div>
 +
 
 +
<div id="Change_Log">
 +
== 変更履歴 ==
 +
</div>
 +
 
 +
* [[Version 2.3|2.3]] : 新規テンプレートタグ
 +
 
 +
<div id="Source_File">
 +
== ソースファイル ==
 +
</div>
  
== Change Log ==
+
<tt>&get_tag()</tt> は {{Trac|wp-includes/category.php}} にあります。
Since: 2.3.0
+
  
== Source File ==
+
<div id="Related">
<!-- Need links to current source code files -->
+
== 関連資料 ==
<tt>&get_tag()</tt> is located in <tt>wp-includes/category.php</tt>.
+
</div>
  
== Related ==
+
{{Tag Tag Tags}}
<!--
+
{{PHP Function Tag Footer}}
    To Do:
+
    Need to find related functions.
+
    Need to create groups of functions and create templates to add them to a page quickly.
+
    Some functions may be related to many groups of functions.
+
-->
+
  
 
{{原文|Function Reference/get tag|68026}}<!-- 21:37, 27 February 2009 CharlesClarkson -->
 
{{原文|Function Reference/get tag|68026}}<!-- 21:37, 27 February 2009 CharlesClarkson -->
 +
{{DEFAULTSORT:get_the_tag_list}}
 +
[[Category:wp2.3]]
 
[[Category:Functions]]
 
[[Category:Functions]]
[[Category:New_page_created]]
 
 
[[en:Function Reference/get tag]]
 
[[en:Function Reference/get tag]]

2010年4月23日 (金) 22:40時点における版

タグ ID またはタグオブジェクトで指定したタグの行オブジェクトを取得します。

内部で get_term() を呼んでおり、get_termget_post_tag のフィルターをフックします。 $filterraw でなければ無害化も行います。 $tag がタグオブジェクトで、$filterempty() 関数で true となる値(空文字, 0, '0', null など)の場合、$tag をキャッシュします。


使い方

<?php &get_tag( $tag, $output, $filter ) ?>

パラメータ

$tag
整数|オブジェクト) (必須
初期値: なし
$output
文字列) (オプション) OBJECT, ARRAY_A または ARRAY_N
初期値: OBJECT
$filter
string) (オプション) 初期値の 'raw' では無害化を行いません。
初期値: 'raw'

戻り値

(オブジェクト|配列) 
戻り値の型は $output の指定によります.

用例


変更履歴

  • 2.3 : 新規テンプレートタグ

ソースファイル

&get_tag()wp-includes/category.php にあります。


タグ: get_tag(), get_tag_link(), get_tags(), get_the_tag_list(), get_the_tags(), is_tag(), the_tags(), single_tag_title(), tag_description(), wp_generate_tag_cloud(), wp_tag_cloud()


テンプレートタグへの PHP 関数型パラメータの渡し方関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: WordPress Codex » Function Reference/get tag最新版との差分