钩子文档

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 加载。

📄 原文内容

Fired when the template loader determines a favicon.ico request.

Source

do_action( 'do_favicon' );

Changelog

Version Description
5.4.0 Introduced.