当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

関数リファレンス/get avatar

提供: WordPress Codex 日本語版
< 関数リファレンス
2015年6月7日 (日) 14:32時点におけるF46vib (トーク | 投稿記録)による版 (パラメータ)

移動先: 案内検索

このページ「関数リファレンス/get avatar」は未翻訳です。和訳や日本語情報を加筆してくださる協力者を求めています

説明

ユーザーID もしくは 電子メールアドレス から ユーザー の アバター を取得します。一般的に コメント欄 で使われます。

この関数は pluggable/en です。しかしながら、グラバターの出力を変更したいプラグインの作成者は、互換性のため、代わりにget_avatarフィルタを使用する必要があります。

使い方

<?php echo get_avatar( $id_or_email, $size, $default, $alt ); ?>

パラメータ

id_or_email
int/string/object) (必須) 作者の ユーザーID (int/string) か 電子メールアドレス (string) か コメント ループ での コメント オブジェクト. ノート: コメント投稿者のグラバターを表示するために、多くの コメント テンプレート において $comment をここで使うことが出来ます。In other templates within The Loop (for WordPress 2.7 and lower), you can use get_the_author_id() (deprecated in WordPress 2.8). For WordPress 2.8, please use get_the_author_meta('user_email').
初期値: なし
size
integer) (オプション) グラバターのサイズを指定します (最大 512)
初期値: 96
default
string) (オプション) 画像へのURL, デフォルト: "Mystery Man"
初期値: なし
alt
string) (オプション) 画像の代替テキストを指定します
初期値: なし

戻り値

文字列 
img 要素。 この関数は何も出力しません。戻り値をエコーする必要があります。

用例

For comments:

<?php echo get_avatar( $comment, 32 ); ?>

For a post's author, in The Loop:

<?php echo get_avatar( get_the_author_meta( 'ID' ), 32 ); ?>

For a random email address:

<?php echo get_avatar( 'email@example.com', 32 ); ?>

  • Uses the get_avatar filter to filter the returned string.
  • This function is pluggable and so can be overridden by plugins and themes. The default functionality cannot be relied upon in these cases.


変更履歴

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

ソースファイル

get_avatar()wp-includes/pluggable.phpにあります。

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

関連

コメント関数: cancel_comment_reply_link(), comment_author(), comment_author_email(), comment_author_email_link(), comment_author_IP(), comment_author_link(), comment_author_rss(), comment_author_url(), comment_author_url_link(), comment_class(), comment_date(), comment_excerpt(), comment_form_title(), comment_form(), comment_ID(), comment_id_fields() / en, comment_reply_link(), comment_text(), comment_text_rss(), comment_time(), comment_type(), comments_link, comments_number(), comments_open(), comments_popup_link(), comments_popup_script(), comments_rss_link(), get_avatar(), next_comments_link(), paginate_comments_links(), permalink_comments_rss(), previous_comments_link(), wp_list_comments()



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