# get_avatar

URL: https://chugunov.pro/api-wordpress/filters/get_avatar/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: хук-фильтр.
Появился в версии: 2.5.0.

## Сигнатура

```php
apply_filters( 'get_avatar', string $avatar, mixed $id_or_email, int $size, string $default_value, string $alt, array $args )
```

## Описание

Фильтрует HTML-код аватара пользователя.

## Параметры

- `$avatar` `string` — обязательный. HTML-код аватара пользователя.
- `$id_or_email` `mixed` — обязательный. Аватар, который нужно получить. Принимает идентификатор пользователя, MD5-хеш Gravatar, email пользователя, объект WP_User, объект WP_Post или объект WP_Comment.
- `$size` `int` — обязательный. Высота и ширина аватара в пикселях.
- `$default_value` `string` — обязательный. URL изображения по умолчанию или тип изображения по умолчанию. Принимает:
  
  '404' (возвращать 404 вместо изображения по умолчанию)
  
  'retro' (8-битное пикселизированное лицо в стиле аркадных автоматов)
  
  'robohash' (робот)
  
  'monsterid' (монстр)
  
  'wavatar' (мультяшное лицо)
  
  'identicon' («лоскутный» геометрический узор)
  
  'mystery', 'mm' или 'mysteryman' (человек-загадка)
  
  'blank' (прозрачный GIF)
  
  'gravatar_default' (логотип Gravatar)
- `$alt` `string` — обязательный. Альтернативный текст для использования в теге изображения аватара.
- `$args` `array` — обязательный. Аргументы, переданные в get_avatar_data(), после обработки.

## Фильтруемое значение

HTML-код аватара пользователя.

## Исходный код

Файл: `wp-includes/pluggable.php:3353`

```php
return apply_filters( 'get_avatar', $avatar, $id_or_email, $args['size'], $args['default'], $args['alt'], $args );
```

## История изменений

- 4.2.0 — Added the $args parameter.
- 2.5.0 — Introduced.

## Связанные

Используется в: [`get_avatar`](https://chugunov.pro/api-wordpress/functions/get_avatar/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/hooks/get_avatar/