media_buttons_context
云策文档标注
概述
media_buttons_context 是一个已弃用的过滤器,用于过滤 WordPress 3.5.0 版本之前的旧版媒体按钮。开发者应改用 'media_buttons' 动作。
关键要点
- 这是一个已弃用的过滤器,自 WordPress 3.5.0 起被 'media_buttons' 动作取代。
- 参数 $string 是一个字符串,表示媒体按钮的上下文,默认为空。
- 源代码中使用 apply_filters_deprecated() 函数来应用此过滤器,并指定了替代方案。
- 相关函数 media_buttons() 用于向编辑器添加媒体按钮。
注意事项
在开发新功能时,应避免使用此过滤器,转而使用 'media_buttons' 动作以确保兼容性和最佳实践。
原文内容
Filters the legacy (pre-3.5.0) media buttons.
Description
Use ‘media_buttons’ action instead.
Parameters
$stringstring-
Media buttons context. Default empty.
Source
$legacy_filter = apply_filters_deprecated( 'media_buttons_context', array( '' ), '3.5.0', 'media_buttons' );
Changelog
| Version | Description |
|---|---|
| 3.5.0 | Deprecated. Use ‘media_buttons’ action instead. |
| 2.5.0 | Introduced. |