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

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

「テンプレートタグ/the author meta」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(言語間リンク等挿入、リンク調整/未翻訳)
(en:Template Tags/the_author_meta 23:59, 8 September 2013 Emiluzelac 版を反映して残りを和訳。)
 
(4人の利用者による、間の4版が非表示)
1行目: 1行目:
{{NeedTrans}}
+
<div id="Description">
== Description ==
+
== 解説 ==
 +
</div>
  
The '''the_author_meta''' Template Tag displays the desired meta data for a user. If this tag is used within [[The Loop]], the user ID value need not be specified, and the displayed data is that of the current post author. A user ID can be specified if this tag is used outside [[The Loop]].
+
[[テンプレートタグ/the author meta|the_author_meta]] テンプレートタグを使えば、あるユーザーが持つメタデータから好きなものを表示することができます。このタグを[[The Loop|ループ]]の中で使った場合、ユーザー ID を指定する必要はなく、表示されるデータは現在の投稿の作成者のものになります。[[The Loop|ループ]]の外で使う場合、ユーザー ID を指定する必要があります。
  
Use [[関数リファレンス/get_the_author_meta|get_the_author_meta()]]/[[:en:Function Reference/get_the_author_meta|en]] if you need to return (not display) the information.
+
指定したメタデータが存在しなければ、何も表示されません。
  
Note: '''the_author_meta''' was first available with [[Version 2.8]].
+
'''注:'''この情報を PHP で使うために戻り値として使用したい(表示しない)場合は、[[関数リファレンス/get_the_author_meta|get_the_author_meta()]] を使ってください。
  
== Usage ==
+
<div id="Usage">
 +
== 使用法 ==
 +
</div>
  
 
  <?php the_author_meta( $field, $userID ); ?>
 
  <?php the_author_meta( $field, $userID ); ?>
  
== Parameters ==
+
<div id="Parameters">
 +
== パラメータ ==
 +
</div>
  
; $field : (''string'') Field name for the data item to be displayed.  Valid values:
+
; $field : (''文字列'') 表示したいデータのフィールド名。有効な値は以下の通りです。
 
:*<tt>user_login</tt>
 
:*<tt>user_login</tt>
 
:*<tt>user_pass</tt>
 
:*<tt>user_pass</tt>
42行目: 47行目:
 
:*<tt>ID</tt>
 
:*<tt>ID</tt>
  
; $userID : (''integer'') If the user ID fields is used, then this function display the specific field for this user ID.
+
{{Parameter|$userID|整数|これが指定されると、この ID を持つユーザーの情報が表示されます。|オプション|false}}
  
== Examples ==
+
== 戻り値 ==
  
=== Display the Author's AIM screenname ===
+
このテンプレートタグは値を返しません。
  
Displays the value in the author's '''AIM''' (AOL Instant Messenger screenname) field.
+
<div id="Examples">
 +
== 例 ==
 +
</div>
  
&lt;p&gt;This author's AIM address is <?php the_author_meta('aim'); ?>&lt;/p&gt;
+
<div id="Display_the_Author's_AIM_screenname">
 +
=== 投稿作成者の AIM アカウント名を表示する ===
 +
</div>
  
=== Display a User Email Address ===
+
投稿の作成者の '''AIM''' (AOL Instant Messenger アカウント) フィールドを表示します。
  
Displays the email address for user ID 25.
+
<pre><p>この著者の AIM アカウントは <?php the_author_meta( 'aim' ); ?> です。</p></pre>
 +
 
 +
<div id="Display_a_User_Email_Address">
 +
=== 特定のユーザーのメールアドレスを表示する ===
 +
</div>
 +
 
 +
ID 25 であるユーザーのメールアドレスを表示します。
 +
 
 +
<pre><p>ID 25 のユーザーのアドレスは <?php the_author_meta( 'user_email', 25 ); ?> です。</p></pre>
 +
 
 +
== 高度な使い方 ==
 +
 
 +
プラグインを使ってユーザー登録時や管理画面から <tt>wp_usermeta</tt> テーブル(<tt>wp_</tt> はデータベース接頭辞)に新しい値を追加することができます。以下は、あるプラグインが meta_key を "twitter" と設定し、その meta_value が "wordpress" となっている場合の例です。
 +
 
 +
<pre><p>投稿者の Twitter ID: <?php the_author_meta( 'twitter' ); ?></p></pre>
 +
 
 +
と書くと、次のように表示されます。
 +
 
 +
<div style="border:1px solid blue; width:50%; padding:10px">投稿者の Twitter ID: wordpress</div>
  
&lt;p&gt;The email address for user id 25 is <?php the_author_meta('user_email',25); ?>&lt;/p&gt;
 
  
 
== 変更履歴 ==
 
== 変更履歴 ==
62行目: 88行目:
 
* [[Version 2.8|2.8]] : 新規テンプレートタグ
 
* [[Version 2.8|2.8]] : 新規テンプレートタグ
  
== Source File ==
+
== ソースファイル ==
 
+
<tt>the_author_meta()</tt> is located in {{BrowseSource|wp-includes/author-template.php|trunk|2.8}}.
+
  
== Related ==
+
<tt>the_author_meta()</tt> は {{Trac|wp-includes/author-template.php}} 内にあります。
  
 +
<div id="Related">
 +
== 関連情報 ==
 +
</div>
 
{{Tag Author Tags}}
 
{{Tag Author Tags}}
  
 
{{PHP Function Tag Footer}}
 
{{PHP Function Tag Footer}}
  
{{原文|Template Tags/the_author_meta|72611}}<!-- 14:42, May 24, 2009 Ramiy 版 -->
+
{{原文|Template Tags/the_author_meta|135276}} <!-- 23:59, 8 September 2013 Emiluzelac 版 -->
  
 
{{DEFAULTSORT:The_author_meta}}
 
{{DEFAULTSORT:The_author_meta}}
 +
[[Category:テンプレートタグ]]
 
[[Category:wp2.8]]
 
[[Category:wp2.8]]
  
 
[[en:Template Tags/the_author_meta]]
 
[[en:Template Tags/the_author_meta]]
 +
[[tr:Tema_Etiketleri/the_author_meta]]

2014年9月8日 (月) 12:06時点における最新版

the_author_meta テンプレートタグを使えば、あるユーザーが持つメタデータから好きなものを表示することができます。このタグをループの中で使った場合、ユーザー ID を指定する必要はなく、表示されるデータは現在の投稿の作成者のものになります。ループの外で使う場合、ユーザー ID を指定する必要があります。

指定したメタデータが存在しなければ、何も表示されません。

注:この情報を PHP で使うために戻り値として使用したい(表示しない)場合は、get_the_author_meta() を使ってください。

使用法

<?php the_author_meta( $field, $userID ); ?>

パラメータ

$field 
(文字列) 表示したいデータのフィールド名。有効な値は以下の通りです。
  • user_login
  • user_pass
  • user_nicename
  • user_email
  • user_url
  • user_registered
  • user_activation_key
  • user_status
  • display_name
  • nickname
  • first_name
  • last_name
  • description
  • jabber
  • aim
  • yim
  • user_level
  • user_firstname
  • user_lastname
  • user_description
  • rich_editing
  • comment_shortcuts
  • admin_color
  • plugins_per_page
  • plugins_last_view
  • ID
$userID
整数) (オプション) これが指定されると、この ID を持つユーザーの情報が表示されます。
初期値: false

戻り値

このテンプレートタグは値を返しません。

投稿作成者の AIM アカウント名を表示する

投稿の作成者の AIM (AOL Instant Messenger アカウント) フィールドを表示します。

<p>この著者の AIM アカウントは <?php the_author_meta( 'aim' ); ?> です。</p>

特定のユーザーのメールアドレスを表示する

ID が 25 であるユーザーのメールアドレスを表示します。

<p>ID 25 のユーザーのアドレスは <?php the_author_meta( 'user_email', 25 ); ?> です。</p>

高度な使い方

プラグインを使ってユーザー登録時や管理画面から wp_usermeta テーブル(wp_ はデータベース接頭辞)に新しい値を追加することができます。以下は、あるプラグインが meta_key を "twitter" と設定し、その meta_value が "wordpress" となっている場合の例です。

<p>投稿者の Twitter ID: <?php the_author_meta( 'twitter' ); ?></p>

と書くと、次のように表示されます。

投稿者の Twitter ID: wordpress


変更履歴

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

ソースファイル

the_author_meta()wp-includes/author-template.php 内にあります。

作成者タグ: the_author(), get_the_author(), the_author_link(), get_the_author_link(), the_author_meta(), get_the_author_meta(), the_author_posts(), get_the_author_posts(), the_author_posts_link(), get_author_posts_url(), get_the_modified_author(), the_modified_author(), wp_dropdown_users(), wp_list_authors()


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


最新英語版: WordPress Codex » Template Tags/the_author_meta最新版との差分