MENU
  1. Home
  2. WordPress リファレンス
  3. Function
  4. get_avatar()

get_avatar()

広告
Function

get_avatar() は、 ユーザーのアバター画像（主にGravatarから取得される）をHTMLタグとして出力するテンプレートタグです。WordPressのユーザープロフィールに関連する画像を表示するために利用され、投稿者やコメント投稿者のアバターを動的に生成します。

目次

機能の説明

  • get_avatar() は、WordPressユーザー、コメント投稿者、またはメールアドレスに紐づくアバター画像を表示します。
  • デフォルトでは Gravatar サービスを使用しますが、独自のアバター画像システムを組み込むことも可能です。
  • コメント欄 での表示や 投稿の著者情報 によく使用されます。

シンプルなコード例

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

使い方の解説

  1. 第一引数: ユーザーのID、メールアドレス、またはWP_Userオブジェクトを渡します。
  2. 第二引数: 表示する画像のサイズ（ピクセル）を指定します。
  3. オプションの引数で デフォルト画像 や CSSクラス をカスタマイズすることも可能です。

使用例

<?php 
echo get_avatar(get_the_author_meta('ID'), 64, '', '投稿者のアバター');
?>
  • この例では、現在の投稿の 著者のID を使って、 64pxのアバター画像 を表示します。
  • 4つ目の引数 には画像の代替テキストを指定しています（例: “投稿者のアバター”）。

一緒に使うことが多い関連タグ

get_the_author_meta()

このタグは、投稿者の ユーザープロフィールから特定の情報（名前、メールなど）を取得します。

<?php 
echo get_avatar(get_the_author_meta('user_email'), 48); 
?>

get_the_author_meta('user_email') で著者のメールアドレスを取得し、それに基づくアバター画像を表示します。

wp_list_comments()

wp_list_comments() は、 コメント一覧を表示 するテンプレートタグです。コメントごとのアバター表示に対応しています。

<?php
wp_list_comments(array(
    'avatar_size' => 32,
    'style' => 'ul',
));
?>
  • avatar_size パラメーターで、コメント投稿者のアバターサイズを指定しています。
  • コメントの一覧がHTMLの <ul> タグで出力されます。

追加情報を取得したい場合

get_avatar_url() を使用してアバターのURLだけ取得する

get_avatar_url() で、アバターの画像URLを文字列として取得し、 カスタムHTMLやCSS で自由にデザインを調整できます。

<?php 
$avatar_url = get_avatar_url(get_the_author_meta('ID'));
echo '<img src="' . esc_url($avatar_url) . '" alt="投稿者のアバター">';
?>

このコードは アバターURLを取得 し、<img> タグ内で利用しています。独自デザインが必要な場合に便利です。

get_the_author_meta() で取得できる著者情報

<?php 
echo get_the_author_meta('display_name');
echo get_the_author_meta('user_description');
?>

そのテンプレートタグで出力できる情報

  • display_name：投稿者の表示名
  • user_email：投稿者のメールアドレス
  • user_description：投稿者の自己紹介
  • user_url：投稿者のウェブサイトURL

想定されるトラブル

アバター画像が表示されない

  • Gravatarで設定したメールアドレスが登録されていない。
  • テーマでget_avatar() が正しく実装されていない。

解決方法

  • Gravatarにログインし、 WordPressに登録したメールアドレス で画像を設定します。
  • テーマ内で get_avatar() の使用方法 を確認し、引数が正しいかチェックします。

デフォルトのアバター画像が気に入らない

<?php 
echo get_avatar(get_the_author_meta('ID'), 96, 'https://example.com/default-avatar.png');
?>
  • 管理画面の「ディスカッション」設定 で、デフォルトのアバター画像を変更します。
  • または、get_avatar() にカスタムのデフォルト画像URLを渡します。

Q&A

アバター画像のサイズをレスポンシブにしたい場合は？

CSSを使って、画像のサイズを調整します。次のようなスタイルを適用します。

.avatar {
    width: 100%;
    max-width: 96px;
    height: auto;
}

独自のユーザーアバターを設定する方法はありますか？

get_avatar() は基本的に Gravatar を使いますが、プラグインを利用することで 独自のアバターシステム を導入できます。たとえば「Simple Local Avatars」というプラグインが使われます。

get_avatar() の画像URLをカスタマイズしたい場合は？

get_avatar_url() を使うことで、画像のURLを取得できます。必要であればそのURLをフィルタリングすることも可能です。

add_filter('get_avatar_url', function($url, $id_or_email, $args) {
    return 'https://example.com/custom-avatar.png';
}, 10, 3);

まとめ

get_avatar() は、WordPressのユーザーやコメント投稿者のアバター画像を表示するための強力なテンプレートタグです。

Gravatarサービスを使用することで、 ユーザーのプロフィール画像を簡単に表示 できます。

さらに、get_the_author_meta() や wp_list_comments() などの関連タグと組み合わせることで、 コメント欄や著者情報の表示 を充実させることが可能です。

Function
よかったらシェアしてね！
  • URLをコピーしました！

コメント

コメントする

This site uses Akismet to reduce spam. Learn how your comment data is processed.

目次