钩子文档

mce_buttons_4

💡 云策文档标注

概述

mce_buttons_4 是一个 WordPress 过滤器,用于自定义 TinyMCE 编辑器(可视化标签页)第四行的按钮列表。它允许开发者根据编辑器 ID 动态调整按钮配置。

关键要点

  • 过滤器名称:mce_buttons_4
  • 参数:$mce_buttons_4(数组,第四行按钮列表)和 $editor_id(字符串,编辑器唯一标识符)
  • 用途:在可视化编辑器中修改或添加第四行按钮,支持经典编辑器和块编辑器中的 Classic block
  • 相关函数:wp_tinymce_inline_scripts() 和 _WP_Editors::editor_settings()
  • 版本历史:从 WordPress 2.5.0 引入,3.3.0 添加了 $editor_id 参数

代码示例

$mce_buttons_4 = apply_filters( 'mce_buttons_4', array(), $editor_id );

📄 原文内容

Filters the fourth-row list of TinyMCE buttons (Visual tab).

Parameters

$mce_buttons_4array
Fourth-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_4 = apply_filters( 'mce_buttons_4', array(), $editor_id );

Changelog

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