_get_random_header_data

The timeline below displays how wordpress function _get_random_header_data has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 5.9

/**
 * Gets random header image data from registered images in theme.
 *
 * @since 3.4.0
 *
 * @access private
 *
 * @global array $_wp_default_headers
 *
 * @return object
 */
function _get_random_header_data()
{
    global $_wp_default_headers;
    static $_wp_random_header = null;
    if (empty($_wp_random_header)) {
        $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;
}

WordPress Version: 5.5

/**
 * Gets random header image data from registered images in theme.
 *
 * @since 3.4.0
 *
 * @access private
 *
 * @global array $_wp_default_headers
 *
 * @return object
 */
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;
}

WordPress Version: 4.3

/**
 * Get random header image data from registered images in theme.
 *
 * @since 3.4.0
 *
 * @access private
 *
 * @global array  $_wp_default_headers
 * @staticvar object $_wp_random_header
 *
 * @return object
 */
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;
}

WordPress Version: 3.7

/**
 * Get random header image data from registered images in theme.
 *
 * @since 3.4.0
 *
 * @access private
 *
 * @return string Path to header image
 */
function _get_random_header_data()
{
    static $_wp_random_header;
    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;
}