您需要了解的有关新的WordPress网站图标API

WordPress 4.3 引入了站点图标功能，让用户可以为网站定义一个代表性图标，也就是我们熟知的网站 favicon。本文将深入探讨站点图标及其 API，包括其功能和过滤器。

站点图标是什么？

如果您熟悉网页开发，那么您可能已经知道站点图标是什么了。它就是 WordPress 对 favicon 的称呼。Favicon 是网站打开时在浏览器标签页上显示的图标，也是您在智能手机主屏幕上保存网页快捷方式时显示的图标。设置站点图标后，它还会显示在您的 WordPress 管理面板中。

WordPress 4.3 默认启用站点图标显示功能，无需额外操作。只要您更新 WordPress 到 4.3 版本，就可以直接使用此功能。

如何定义站点图标？

您可以通过主题自定义器定义站点图标。访问方式有两种：

• 通过管理菜单，在“外观”菜单下找到“自定义”选项。
• 点击管理栏中的“自定义”按钮（WordPress 4.3 新增）。

在主题自定义器的“站点标识”选项中，您可以上传或选择图片作为站点图标。WordPress 建议图片尺寸至少为 512 像素宽和高。

选择图片后，您可以裁剪图片，选择要作为站点图标的正方形区域。裁剪不会修改原始文件。

裁剪完成后，点击“裁剪图像”按钮，WordPress 会自动调整图片大小。点击“保存并发布”按钮保存更改。

您可以在任何时候使用主题自定义器移除或更改站点图标。

获取当前站点图标

主题或插件开发者无需担心站点图标的基本用法：选择图片后，WordPress 会自动将其显示为 favicon。

但如果您需要在主题或插件中获取当前站点图标，可以使用 WordPress 提供的四个函数：

• has_site_icon(): 检查是否已设置站点图标，返回布尔值 (true 或 false)。

<code class="language-php">if (has_site_icon()) {
    // 已设置站点图标
} else {
    // 未设置站点图标
}</code>

• get_site_icon_url() 和 site_icon_url(): 获取站点图标 URL。get_site_icon_url() 可以指定博客 ID 和大小，site_icon_url() 直接输出 URL。

<code class="language-php">if (has_site_icon()) {
    echo '<img alt="Site Icon" src="'%20.%20get_site_icon_url(null,%20200)%20.%20'">';
}</code>

• wp_site_icon(): 输出必要的 meta 标签，用于告知浏览器或操作系统 favicon 的可用尺寸。

<code class="language-php">wp_site_icon(); // 通常放在 `` 标签内</code>

自定义站点图标尺寸

WordPress 默认生成几种尺寸的站点图标。您可以使用 site_icon_image_sizes 和 site_icon_meta_tags 两个过滤器自定义尺寸和 meta 标签。

总结

WordPress 站点图标 API 功能简洁实用，方便用户和开发者管理网站 favicon。 记住，这个 API 主要用于 favicon，不应用于其他用途。

(FAQs 部分略去，因为与已有的内容高度重复，且篇幅较长。)

以上是您需要了解的有关新的WordPress网站图标API的详细内容。更多信息请关注PHP中文网其他相关文章！