Question

Alert: This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness.

_get_random_header_data()

Get random header image data from registered images in theme.

---

description

---

返回值

(object)

---

源代码

File: wp-includes/theme.php

function _get_random_header_data() {
	static $_wp_random_header = null;

	if ( empty( $_wp_random_header ) ) {
		global $_wp_default_headers;
		$header_image_mod = get_theme_mod( 'header_image', '' );
		$headers = array();

		if ( 'random-uploaded-image' == $header_image_mod )
			$headers = get_uploaded_header_images();
		elseif ( ! empty( $_wp_default_headers ) ) {
			if ( 'random-default-image' == $header_image_mod ) {
				$headers = $_wp_default_headers;
			} else {
				if ( current_theme_supports( 'custom-header', 'random-default' ) )
					$headers = $_wp_default_headers;
			}
		}

		if ( empty( $headers ) )
			return new stdClass;

		$_wp_random_header = (object) $headers[ array_rand( $headers ) ];

		$_wp_random_header->url =  sprintf( $_wp_random_header->url, get_template_directory_uri(), get_stylesheet_directory_uri() );
		$_wp_random_header->thumbnail_url =  sprintf( $_wp_random_header->thumbnail_url, get_template_directory_uri(), get_stylesheet_directory_uri() );
	}
	return $_wp_random_header;
}

---

更新日志

Version	description
3.4.0	Introduced.

---

相关函数

Uses

• wp-includes/theme.php: current_theme_supports()
• wp-includes/theme.php: get_uploaded_header_images()
• wp-includes/theme.php: get_theme_mod()
• wp-includes/theme.php: get_template_directory_uri()
• wp-includes/theme.php: get_stylesheet_directory_uri()

---

Used By

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

---

User Contributed Notes