関数リファレンス/get the author meta

説明

この関数はユーザーのメタデータを返します。ループ内で使う場合、ユーザー ID を指定する必要はなく、現在の投稿の作者に関するデータが返されます。ループ外で使う場合はユーザー ID を指定する必要があります。

get_the_author_meta() は PHP 内で使うデータを返すため、その情報を表示したい場合は the_author_meta() を使ってください。

そのユーザーには指定したメタフィールドが存在しない場合、空の文字列が返されます。

使い方

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

パラメータ

$field 

(文字列) 返すデータ項目のフィールド名。有効な値:

• user_login
• user_pass
• user_nicename
• user_email
• user_url
• user_registered
• user_activation_key
• user_status
• roles
• display_name
• nickname
• first_name
• last_name
• description (ユーザーのプロフィール情報)
• jabber
• aim
• yim
• googleplus
• twitter
• user_level
• user_firstname
• user_lastname
• rich_editing
• comment_shortcuts
• admin_color
• plugins_per_page
• plugins_last_view
• ID

$userID 

(文字列) 関数にユーザー ID が渡された場合、特定のユーザー ID に関するデータが返される。ループ内以外の場合は必須。ループ内では現在の投稿者の ID が使われる。

用例

ユーザーのメールアドレスを取得する

現在の投稿の投稿者のメールアドレスを取得し、後で使うために $user_email 変数に格納する。この関数はデータを「返す」だけで、表示するわけではないことを忘れないで下さい。

<?php $user_email = get_the_author_meta('user_email'); ?>

ユーザーの表示名にメールアドレスをリンクして表示する

ユーザー ID 25 の投稿者のメールアドレスを取得し、表示名をアンカーテキストとしてリンクを出力する。

<p>投稿者にメールを送る: <a href="mailto:<?php echo get_the_author_meta('user_email', 25); ?>"><?php the_author_meta('display_name', 25); ?></a></p>

注

プラグインによってはユーザーのプロフィールにフィールドを追加するものがあり、これによって wp_usermeta データベーステーブルに新しいキーバリューペアが追加されます。この追加データはフィールドのキーを $field パラーメータとして関数に渡すこととで取得できます。

更新履歴

2.8.0 以降。

ソースファイル

get_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()

関数リファレンス、テンプレートタグ目次もご覧ください。

最新英語版： WordPress Codex » Function Reference/get_the_author_meta （最新版との差分）