钩子文档

icon_dir

💡 云策文档标注

概述

icon_dir 是一个 WordPress 过滤器,用于修改图标目录的绝对路径。它允许开发者自定义图标存储位置,常用于媒体和附件相关功能。

关键要点

  • icon_dir 是一个过滤器钩子,参数为图标目录的绝对路径字符串。
  • 默认路径为 ABSPATH . WPINC . '/images/media',可通过 apply_filters 调用修改。
  • 与多个函数相关,如 wp_mime_type_icon() 和 wp_get_attachment_image_src(),用于图标和附件处理。

代码示例

$icon_dir = apply_filters( 'icon_dir', ABSPATH . WPINC . '/images/media' );

注意事项

  • 此过滤器自 WordPress 2.0.0 版本引入,使用时需确保兼容性。
  • 路径参数应为绝对路径,避免相对路径导致错误。

📄 原文内容

Filters the icon directory path.

Parameters

$pathstring
Icon directory absolute path.

Source

$icon_dir = apply_filters( 'icon_dir', ABSPATH . WPINC . '/images/media' );

Changelog

Version Description
2.0.0 Introduced.