has_site_icon()
云策文档标注
概述
has_site_icon() 函数用于检查站点是否设置了站点图标(Site Icon)。它基于 get_site_icon_url() 函数返回布尔值,判断图标是否存在。
关键要点
- 函数接受一个可选参数 $blog_id,用于指定博客ID,默认为当前博客。
- 返回值为布尔类型,表示站点是否有站点图标。
- 函数内部调用 get_site_icon_url() 并检查其返回值来确定图标状态。
- 自 WordPress 4.3.0 版本引入,是站点图标功能的一部分。
代码示例
function has_site_icon( $blog_id = 0 ) {
return (bool) get_site_icon_url( 512, '', $blog_id );
}注意事项
- 该函数依赖于 get_site_icon_url(),如果后者返回空值,则 has_site_icon() 返回 false。
- 在多站点环境中,可以通过 $blog_id 参数检查特定站点的图标状态。
原文内容
Determines whether the site has a Site Icon.
Parameters
$blog_idintoptional-
ID of the blog in question. Default current blog.
Source
function has_site_icon( $blog_id = 0 ) {
return (bool) get_site_icon_url( 512, '', $blog_id );
}
Changelog
| Version | Description |
|---|---|
| 4.3.0 | Introduced. |