do_favicon
云策文档标注
概述
do_favicon 是一个 WordPress 动作钩子,在模板加载器检测到 favicon.ico 请求时触发,允许开发者自定义 favicon 处理逻辑。
关键要点
- do_favicon 是一个动作钩子,用于响应 favicon.ico 请求。
- 它由模板加载器触发,可用于添加自定义 favicon 输出或重定向。
- 首次引入于 WordPress 5.4.0 版本。
代码示例
add_action( 'do_favicon', 'custom_favicon_handler' );
function custom_favicon_handler() {
// 自定义 favicon 处理代码,例如输出自定义图标或重定向
header( 'Content-Type: image/x-icon' );
readfile( get_template_directory() . '/custom-favicon.ico' );
exit;
}注意事项
- 使用此钩子时,需确保正确处理 HTTP 头部和输出,以避免冲突或错误。
- 在自定义处理中,可能需要调用 exit 来终止默认 favicon 加载。
原文内容