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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索

説明

この関数はユーザーのメタデータを返します。ループ内で使う場合、ユーザー 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最新版との差分