钩子文档

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.