函数has_header_image()用于检查当前主题是否支持自定义标题图像,并且是否已经为当前页面设置了标题图像。

语法:

has_header_image()

返回值:
- 如果当前主题支持自定义标题图像并且为当前页面设置了标题图像,则返回true。
- 如果当前主题不支持自定义标题图像或者未为当前页面设置标题图像,则返回false。

示例用法:

if ( has_header_image() ) {
// 代码块1
} else {
// 代码块2
}

示例解析:
上述示例代码中,如果当前主题支持自定义标题图像并且为当前页面设置了标题图像,则执行代码块1;否则,执行代码块2。

注意事项:
- 该函数仅适用于WordPress主题中,且要求主题支持自定义标题图像功能。
- 该函数只能确定当前页面是否设置了标题图像,并不能获取具体的标题图像URL或其他信息。要获取标题图像的相关信息,可以使用函数get_custom_header()。
- 如果要在页面模板或主题文件中使用该函数,需要确保该函数被调用的位置位于header.php文件中调用函数get_header()之后。因为get_header()函数会自动加载头部模板(header.php),其中通常包含了标题图像的相关信息。