mce_buttons_3
云策文档标注
概述
mce_buttons_3 是一个 WordPress 过滤器,用于修改 TinyMCE 编辑器(可视化标签页)第三行的按钮列表。它允许开发者自定义按钮配置,并支持通过 $editor_id 参数针对特定编辑器实例进行过滤。
关键要点
- 过滤器名称:mce_buttons_3,用于过滤 TinyMCE 第三行按钮数组。
- 参数:$mce_buttons_3(按钮数组)和 $editor_id(编辑器标识符,如 'content' 或 'classic-block')。
- 应用场景:常用于主题或插件开发中,以添加、移除或重新排列编辑器按钮。
- 版本历史:自 WordPress 2.0.0 引入,3.3.0 版本添加了 $editor_id 参数。
代码示例
$mce_buttons_3 = apply_filters( 'mce_buttons_3', array(), $editor_id );注意事项
- 确保在适当钩子(如 admin_init)中添加过滤器函数,以避免影响其他编辑器实例。
- 使用 $editor_id 参数可以针对特定编辑器(如块编辑器中的 Classic block)进行定制。
原文内容
Filters the third-row list of TinyMCE buttons (Visual tab).
Parameters
$mce_buttons_3array-
Third-row list of buttons.
$editor_idstring-
Unique editor identifier, e.g.
'content'. Accepts'classic-block'when called from block editor’s Classic block.
Source
$mce_buttons_3 = apply_filters( 'mce_buttons_3', array(), $editor_id );