Question

is_random_header_image( string $type = 'any' )

Check if random header image is in use.

---

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().

---

参数

$type

(string) (Optional) The random pool to use. any|default|uploaded

Default value: 'any'

---

返回值

(bool)

---

源代码

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;
}

---

更新日志

Version	description
3.2.0	Introduced.

---

相关函数

Uses

• wp-includes/theme.php: get_theme_support()
• wp-includes/theme.php: get_random_header_image()
• wp-includes/theme.php: get_theme_mod()

---

Used By

• wp-admin/includes/template.php: _media_states()
• wp-admin/custom-header.php: Custom_Image_Header::show_header_selector()
• wp-includes/theme.php: get_header_image()
• wp-includes/theme.php: get_custom_header()

---

User Contributed Notes