钩子文档

icon_dir_uri

💡 云策文档标注

概述

icon_dir_uri 是一个 WordPress 过滤器,用于修改图标目录的 URI。它允许开发者自定义图标资源的路径,常用于处理 MIME 类型或附件的图标显示。

关键要点

  • icon_dir_uri 是一个过滤器钩子,用于过滤图标目录的 URI。
  • 默认 URI 为 includes_url( 'images/media' ),指向 WordPress 核心的媒体图标目录。
  • 常用于 wp_mime_type_icon() 函数中,以检索 MIME 类型或附件的图标。
  • 自 WordPress 2.0.0 版本引入,是一个长期可用的核心功能。

代码示例

$icon_dir_uri = apply_filters( 'icon_dir_uri', includes_url( 'images/media' ) );

注意事项

使用此过滤器时,应确保返回的 URI 路径有效且可访问,以避免图标加载失败。建议在主题或插件中谨慎修改,以保持与 WordPress 核心的兼容性。


📄 原文内容

Filters the icon directory URI.

Parameters

$uristring
Icon directory URI.

Source

$icon_dir_uri = apply_filters( 'icon_dir_uri', includes_url( 'images/media' ) );

Changelog

Version Description
2.0.0 Introduced.