хук-фильтр
since 4.2.0
pre_get_avatar
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
apply_filters( 'pre_get_avatar', string|null $avatar, mixed $id_or_email, array $args )Описание
Возврат значения, отличного от null, фактически прерывает выполнение get_avatar(), пропуская значение через фильтр «get_avatar» и досрочно возвращая его.
Оригинал (английский)
Returning a non-null value will effectively short-circuit get_avatar() , passing the value through the ‘get_avatar’ filter and returning early.
Фильтруемое значение
HTML аватара пользователя. Значение по умолчанию — null.
Параметры
$avatar
string|null
обязательный
HTML аватара пользователя. Значение по умолчанию — null.
$id_or_email
mixed
обязательный
Аватар, который нужно получить. Принимает идентификатор пользователя, MD5-хеш Gravatar, email пользователя, объект WP_User, объект WP_Post или объект WP_Comment.
$args
array
обязательный
Аргументы, переданные в get_avatar_url(), после обработки.
Исходный код
wp-includes/pluggable.php:3251
$avatar = apply_filters( 'pre_get_avatar', null, $id_or_email, $args );История изменений
| Версия | Описание |
|---|---|
| 4.2.0 | Introduced. |
