钩子文档

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 );

Changelog

Version Description
3.3.0 The $editor_id parameter was added.
2.0.0 Introduced.