get_avatar_url()

Функция get_avatar_url() возвращает ссылку на аватар (Gravatar) пользователя. Подробнее про аватар можно прочитать в статье посвященной функции get_avatar().

get_avatar_url( $id_or_email, $args = null )

$id_or_email

(смешанный) Обязательный параметр, который поддерживает следующие данные:

Адрес электронной почты, которым не обязательно должен быть зарегистрирован на сайте.
Объект WP_User или ID пользователя.
Объект WP_Comment.
Объект WP_Post.
MD5-хэш Gravatar.

$args

(массив) Дополнительные параметры:

size

(целое) Ширина и высота аватарки.

$default

(строка) Ссылка на картинку по умолчанию, если у пользователя не установлена фотография в аватарке. Можно использовать следующие параметры:

404 – Пустой,
retro – Ретро (картинка 8 bit),
monsterid – Монстр,
mystery, mm или mysterman – Человек-загадка
indenticon – Зелёная фигура,
wavatar – Жёлтая звёздочка,
gravatar_default – Логотип Gravatar.

По умолчанию используется mystery.

force_default

(логическое) Если указать true, то стандартные картинки Gravatar будут в приоритете над пользовательскими фотографиями. По умолчанию false, соответственно, фотографии пользователей в приоритете.

rating

(строка) Это рейтинг – G, PG, R или X, — который можно указать в сервисе Gravatar. Более подробно можно посмотреть здесь.

scheme

(строка) Протокол URL, например http, https, login, login_post, admin, relative, rest, rpc или null.

processed_args

(массив) Этим параметром можно передать дополнительные данные, которые будут добавлены в массив данных при возврате их функцией get_avatar_data().

Пример 1

Выведем просто ссылку без параметров $args. Сделаем мы это внутри цикла.

$comments = get_comments( 
    array(
        'number' => 10,
        'orderby' => 'comment_date',
        'order' => 'DESC',
    ) 
);
 
foreach ( $comments as $comment ) :
...
	echo get_avatar_url( $comment->comment_author_email ); //выведет ссылку типа http://1.gravatar.com/avatar/1e3403ee77c498fc94a2127e2c3d97c0?s=96&d=mm&r=g
...
endforeach;

Пример 2

А теперь добавим немного параметров. Для этого получим ID текущего пользователя через функцию get_current_user_id().

echo get_avatar_url( 
	get_current_user_id(), 
	array( 
		'size'   => '75', //выведем ссылку на аватарку размером 75х75
		'rating' => 'X', //самый пошлый рейтинг
		'scheme' => 'http', //мало ли нам так захотелось)
 	) 
); // выведет ссылку http://1.gravatar.com/avatar/1e3403ee77c498fc94a2127e2c3d97c0?s=75&d=mm&r=x
// по ссылке видно, что часть параметров зашито в url, например s=75