get_the_author_meta:WordPress私的マニュアル

get_the_author_meta

(2.8.0以降)
get_the_author_meta - 投稿者情報を取得する

説明

string get_the_author_meta( [ string $field = '' [ , mixed $user_id = false ] ] )

投稿者情報を取得する。

パラメータ

$field

ユーザ情報のフィールド名（省略時は''）。主な値は次の通り。

フィールド名	意味
ID（id）	ユーザID
login	ログイン名
nicename	ユーザのスラッグ
email	メールアドレス
url	ユーザサイトのURL
registered	登録日時
status	ステータス
display_name	ユーザの表示名

$user_id
ユーザID（省略時はfalse）。

返り値

パラメータ$fieldで指定されたユーザ情報を返す。

注意

投稿者IDを省略した場合は、現在の投稿記事の投稿者情報（$authordata）を参照し、指定されたフィールドの値を返します。

使用例

現在の投稿記事の投稿者IDを取得する。
<?php $user_id = get_the_author_meta( 'id' ); ?>
投稿者IDが10の投稿者情報'nicename'を取得する。
<?php $value = get_the_author_meta( 'nicename', 10 ); ?>

フィルター

[2.8.0]メタ情報を返す前に'get_the_author_'.$fieldフィルター（$fieldは本関数が受け取った値か、その前に'user_'が付いたもので、'login'の場合はget_the_author_user_login）を呼び出す。パラメータ$fieldにはフィールド名（'user_'が付く場合あり）、$valueには返す値、$user_idは対象のユーザIDが格納される。[4.3.0]で本関数が受け取った$user_idの値が格納されるパラメータ$original_user_idが追加された。

return apply_filters( return apply_filters( 'get_the_author_' . $field, $value, $user_id, $original_user_id );

アクション

実行するアクションはありません。

ソースファイル

/wp-includes/author-template.php

参考

Code Reference: get_the_author_meta