函数文档

get_random_header_image()

💡 云策文档标注

概述

get_random_header_image() 函数用于从主题注册的头部图像中随机获取一个图像的 URL。它返回一个字符串,表示头部图像的路径,如果没有图像则返回空字符串。

关键要点

  • 函数返回随机头部图像的 URL 字符串,若无图像则返回空字符串
  • 内部调用 _get_random_header_data() 函数来获取随机头部图像数据
  • 适用于 WordPress 主题开发,用于自定义头部图像的随机显示

代码示例

function get_random_header_image() {
	$random_image = _get_random_header_data();

	if ( empty( $random_image->url ) ) {
		return '';
	}

	return $random_image->url;
}

📄 原文内容

Gets random header image URL from registered images in theme.

Return

string Path to header image.

Source

function get_random_header_image() {
	$random_image = _get_random_header_data();

	if ( empty( $random_image->url ) ) {
		return '';
	}

	return $random_image->url;
}

Changelog

Version Description
3.2.0 Introduced.