функция
since 3.2.0
is_random_header_image()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
is_random_header_image( string $type = 'any' ): boolОписание
Всегда true, если пользователь явно выбирает эту опцию в разделе «Внешний вид → Заголовок».
Также true, если в теме зарегистрировано несколько изображений заголовка, конкретное изображение не выбрано, а тема включает случайные заголовки с помощью add_theme_support().
Оригинал (английский)
Always true if user expressly chooses the option in Appearance > Header.
Also true if theme has multiple header images registered, no specific header image is chosen, and theme turns on random headers with add_theme_support() .
Параметры
$type
string
необязательный
= 'any'
Пул случайных изображений для использования. Возможные значения: 'any', 'default', 'uploaded'. Значение по умолчанию — 'any'.
Возвращаемое значение
bool
Исходный код
wp-includes/theme.php:1467
function is_random_header_image( $type = 'any' ) {
$header_image_mod = get_theme_mod( 'header_image', get_theme_support( 'custom-header', 'default-image' ) );
if ( 'any' === $type ) {
if ( 'random-default-image' === $header_image_mod
|| 'random-uploaded-image' === $header_image_mod
|| ( empty( $header_image_mod ) && '' !== get_random_header_image() )
) {
return true;
}
} else {
if ( "random-$type-image" === $header_image_mod ) {
return true;
} elseif ( 'default' === $type
&& empty( $header_image_mod ) && '' !== get_random_header_image()
) {
return true;
}
}
return false;
}История изменений
| Версия | Описание |
|---|---|
| 3.2.0 | Introduced. |
