WordPress 4.3 引入了站點圖標功能,讓用戶可以為網站定義一個代表性圖標,也就是我們熟知的網站 favicon。本文將深入探討站點圖標及其 API,包括其功能和過濾器。
站點圖標是什麼?
如果您熟悉網頁開發,那麼您可能已經知道站點圖標是什麼了。它就是 WordPress 對 favicon 的稱呼。 Favicon 是網站打開時在瀏覽器標籤頁上顯示的圖標,也是您在智能手機主屏幕上保存網頁快捷方式時顯示的圖標。設置站點圖標後,它還會顯示在您的 WordPress 管理面板中。
WordPress 4.3 默認啟用站點圖標顯示功能,無需額外操作。只要您更新 WordPress 到 4.3 版本,就可以直接使用此功能。
如何定義站點圖標?
您可以通過主題自定義器定義站點圖標。訪問方式有兩種:
在主題自定義器的“站點標識”選項中,您可以上傳或選擇圖片作為站點圖標。 WordPress 建議圖片尺寸至少為 512 像素寬和高。
選擇圖片後,您可以裁剪圖片,選擇要作為站點圖標的正方形區域。裁剪不會修改原始文件。
裁剪完成後,點擊“裁剪圖像”按鈕,WordPress 會自動調整圖片大小。點擊“保存並發布”按鈕保存更改。
您可以在任何時候使用主題自定義器移除或更改站點圖標。
獲取當前站點圖標
主題或插件開發者無需擔心站點圖標的基本用法:選擇圖片後,WordPress 會自動將其顯示為 favicon。
但如果您需要在主題或插件中獲取當前站點圖標,可以使用 WordPress 提供的四個函數:
has_site_icon()
: 檢查是否已設置站點圖標,返回布爾值 (true 或 false)。 if (has_site_icon()) { // 已设置站点图标 } else { // 未设置站点图标 }
get_site_icon_url()
和 site_icon_url()
: 獲取站點圖標 URL。 get_site_icon_url()
可以指定博客 ID 和大小,site_icon_url()
直接輸出 URL。 if (has_site_icon()) { echo '<img alt="Site Icon" src="' . get_site_icon_url(null, 200) . '">'; }
wp_site_icon()
: 輸出必要的 meta 標籤,用於告知瀏覽器或操作系統 favicon 的可用尺寸。 wp_site_icon(); // 通常放在 `<head>` 标签内
自定義站點圖標尺寸
WordPress 默認生成幾種尺寸的站點圖標。您可以使用 site_icon_image_sizes
和 site_icon_meta_tags
兩個過濾器自定義尺寸和 meta 標籤。
總結
WordPress 站點圖標 API 功能簡潔實用,方便用戶和開發者管理網站 favicon。 記住,這個 API 主要用於 favicon,不應用於其他用途。
(FAQs 部分略去,因為與已有的內容高度重複,且篇幅較長。)
以上是您需要了解的有關新的WordPress網站圖標API的詳細內容。更多資訊請關注PHP中文網其他相關文章!