get_avatar_url() — описание функции WordPress на русском

Сигнатура

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

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

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

Версия	Описание
4.2.0	Introduced.