Функция GET_AVATAR_DATA() в WordPress

Функция get_avatar_data() используется в WordPress для получения данных о аватаре пользователя по различным параметрам. С её помощью вы можете настроить аватары на вашем сайте, например, изменить их размер или установить изображение по умолчанию.

Как работает функция

Возвращаемое значение

Функция возвращает массив, который включает как переданные аргументы, так и дополнительные значения.

Использование функции

get_avatar_data( $id_or_email, $args );

Параметры

• $id_or_email (смешанный, обязательный): может быть идентификатором пользователя, MD5-хеше Gravatar, адресом электронной почты, объектом WP_User, WP_Post или WP_Comment.
• $args (массив): аргументы для настройки данных аватара вместо значений по умолчанию.

Основные параметры в $args

• size (int): высота и ширина аватара в пикселях. По умолчанию 96.
• height (int): высота отображаемого аватара. По умолчанию равна size.
• width (int): ширина отображаемого аватара. По умолчанию равна size.
• default (string): URL изображения по умолчанию или его тип. Принимает значения такие как:
  • '404' (возврат 404 вместо изображения)
  • 'retro' (пиксельное лицо в стиле 8-бит)
  • 'robohash' (робот)
  • 'monsterid' (монстр)
  • и другие.
• force_default (true|false): показывать ли изображение по умолчанию, а не Gravatar. По умолчанию false.
• rating (string): рейтинг показов аватаров. Принимает значения:
  • 'G' (подходит всем)
  • 'PG' (возможно, оскорбительное)
  • 'R' (для взрослых)
  • 'X' (для очень взрослых).
• extra_attr (string): HTML-атрибуты для вставки в элемент IMG. Не обрабатываются.

Примеры использования

1. Получение аватара автора текущего поста

global $post;
$ava_data = get_avatar_data( $post, array( "size" => 52, "default" => "monsterid" ) );

Результат:

Array
(
    [size] => 52
    [height] => 52
    [width] => 52
    [default] => monsterid
    [force_default] => 
    [rating] => g
    [scheme] => 
    [processed_args] => 
    [extra_attr] => 
    [found_avatar] => 1
    [url] => http://1.gravatar.com/avatar/155e695ab2251ee3c482c1e3e690683b?s=52&d=monsterid&r=g
)

2. Получение аватара по адресу электронной почты

$ava_data = get_avatar_data( '[email protected]', array( "size" => 48, "default" => "identicon" ) );

Результат:

Array
(
    [size] => 48
    [height] => 48
    [width] => 48
    [default] => identicon
    [force_default] => 
    [rating] => g
    [scheme] => 
    [processed_args] => 
    [extra_attr] => 
    [found_avatar] => 1
    [url] => http://1.gravatar.com/avatar/4b508f04b661ba693130539bd29f5c0d?s=48&d=identicon&r=g
)

3. Получение аватара текущего пользователя

$ava_data = get_avatar_data( wp_get_current_user(), array( "size" => 24, "default" => "wavatar" ) );

Результат:

Array
(
    [size] => 24
    [height] => 24
    [width] => 24
    [default] => wavatar
    [force_default] => 
    [rating] => g
    [scheme] => 
    [processed_args] => 
    [extra_attr] => 
    [found_avatar] => 1
    [url] => http://1.gravatar.com/avatar/155e695ab2251ee3c482c1e3e690683b?s=24&d=wavatar&r=g
)

Примечания

• Изменения: С версии WordPress 4.2.0 была введена эта функция, а начиная с версии 6.7.0 все URL Gravatar используют HTTPS.
• Аватары всегда обслуживаются через HTTPS, чтобы избежать ненужных перенаправлений.

Заключение

Функция get_avatar_data() позволяет эффективно управлять аватарами пользователей в WordPress, предоставляя множество настроек для их адаптации под ваши нужды. Используйте её для улучшения визуального представления вашего сайта и создания уникального пользовательского опыта.