atom_site_icon()
云策文档标注
概述
atom_site_icon() 函数用于在 Atom 源中显示站点图标。它通过调用 get_site_icon_url() 获取图标 URL，并使用 convert_chars() 进行字符转换以确保输出安全。
关键要点
- atom_site_icon() 专门用于 Atom 源，输出站点图标链接
- 依赖 get_site_icon_url() 获取图标 URL，默认尺寸为 32 像素
- 使用 convert_chars() 处理 URL 中的特殊字符，防止 XSS 攻击
- 首次引入于 WordPress 4.3.0 版本
代码示例
function atom_site_icon() {
$url = get_site_icon_url( 32 );
if ( $url ) {
echo '' . convert_chars( $url ) . "n";
}
}注意事项
- 此函数仅适用于 Atom 源，不适用于其他类型的源或页面
- 确保站点图标已设置，否则 get_site_icon_url() 可能返回空值
- convert_chars() 用于安全输出，避免在源中引入潜在的安全漏洞
原文内容
Displays Site Icon in atom feeds.
Description
See also
Source
function atom_site_icon() {
$url = get_site_icon_url( 32 );
if ( $url ) {
echo '<icon>' . convert_chars( $url ) . "</icon>n";
}
}
Changelog
| Version | Description |
|---|---|
| 4.3.0 | Introduced. |