# get_avatar_url()

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

Тип: функция.
Появился в версии: 4.2.0.

## Сигнатура

```php
get_avatar_url( mixed $id_or_email, array $args = null ): string|false
```

## Описание

Получает URL аватара.

## Параметры

- `$id_or_email` `mixed` — обязательный. Аватар, для которого нужно получить URL. Принимает ID пользователя, хеш SHA-256 или MD5 Gravatar, email пользователя, объект WP_User, объект WP_Post или объект WP_Comment.
- `$args` `array` — необязательный, по умолчанию `null`. Аргументы, используемые вместо аргументов по умолчанию.
  
  size intВысота и ширина аватара в пикселях. Значение по умолчанию 96.
  
  default stringURL изображения по умолчанию или тип изображения по умолчанию. Принимает:
  
  '404' (вернуть 404 вместо изображения по умолчанию)
  
  'retro' (8-битное пикселизированное лицо в стиле аркадных автоматов)
  
  'robohash' (робот)
  
  'monsterid' (монстр)
  
  'wavatar' (мультяшное лицо)
  
  'identicon' ("лоскутный" геометрический узор)
  
  'initials' (аватар на основе инициалов с цветным фоном)
  
  'color' (сгенерированный цвет фона)
  
  'mystery', 'mm' или 'mysteryman' (The Oyster Man)
  
  'blank' (прозрачный GIF)
  
  'gravatar_default' (логотип Gravatar) По умолчанию используется значение опции 'avatar_default' с запасным вариантом 'mystery'.
  
  force_default boolВсегда ли показывать изображение по умолчанию, никогда не показывая Gravatar.
  
  Значение по умолчанию false.
  
  rating stringДо какого рейтинга отображать аватары. Принимает:
  
  'G' (подходит для любой аудитории)
  
  'PG' (возможно оскорбительно, обычно для аудитории от 13 лет)
  
  'R' (предназначено для взрослой аудитории старше 17 лет)
  
  'X' (ещё более взрослое, чем указанное выше) По умолчанию используется значение опции 'avatar_rating'.
  
  scheme stringИспользуемая схема URL. Допустимые значения см. в set_url_scheme().
  
  processed_args arrayПосле возврата функции значением будет обработанный/очищенный $args плюс предположение "found_avatar". Передаётся по ссылке.

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

`string|false`

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

Файл: `wp-includes/link-template.php:4332`

```php
function get_avatar_url( $id_or_email, $args = null ) {
	$args = get_avatar_data( $id_or_email, $args );
	return $args['url'];
}
```

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

- 4.2.0 — Introduced.

## Связанные

Использует: [`get_avatar_data`](https://chugunov.pro/api-wordpress/functions/get_avatar_data/).
Используется в: [`get_block_editor_settings`](https://chugunov.pro/api-wordpress/functions/get_block_editor_settings/), `WP_Customize_Manager::get_lock_user_data`, [`rest_get_avatar_urls`](https://chugunov.pro/api-wordpress/functions/rest_get_avatar_urls/), [`wp_check_locked_posts`](https://chugunov.pro/api-wordpress/functions/wp_check_locked_posts/), [`wp_refresh_post_lock`](https://chugunov.pro/api-wordpress/functions/wp_refresh_post_lock/), [`get_avatar`](https://chugunov.pro/api-wordpress/functions/get_avatar/).

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