函数文档

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.

Return

bool Whether the site has a site icon or not.

Source

function has_site_icon( $blog_id = 0 ) {
	return (bool) get_site_icon_url( 512, '', $blog_id );
}

Changelog

Version Description
4.3.0 Introduced.