is_random_header_image( string $type = 'any' )
Check if random header image is in use.
Description Description
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().
Parameters Parameters
- $type
-
(string) (Optional) The random pool to use. any|default|uploaded
Default value: 'any'
Return Return
(bool)
Source Source
File: wp-includes/theme.php
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 || ( '' != get_random_header_image() && empty( $header_image_mod ) ) ) {
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;
}
Expand full source code Collapse full source code View on Trac
Changelog Changelog
| Version | Description |
|---|---|
| 3.2.0 | Introduced. |