钩子文档

tiny_mce_plugins

💡 云策文档标注

概述

tiny_mce_plugins 过滤器用于修改 WordPress 中 TinyMCE 编辑器的默认插件列表。它允许开发者控制哪些默认插件被加载到 TinyMCE 实例中,并支持基于编辑器 ID 进行定制。

关键要点

  • 过滤器名称:tiny_mce_plugins,用于过滤默认 TinyMCE 插件数组。
  • 参数:$plugins(默认插件数组)和 $editor_id(编辑器唯一标识符,如 'content' 或 'classic-block')。
  • 用途:在脚本加载时应用,例如通过 wp_tinymce_inline_scripts() 和 _WP_Editors::editor_settings() 函数。
  • 版本历史:从 WordPress 3.3.0 引入,5.3.0 版本添加了 $editor_id 参数。

代码示例

$plugins = array_unique( apply_filters( 'tiny_mce_plugins', $plugins, $editor_id ) );

📄 原文内容

Filters the list of default TinyMCE plugins.

Description

The filter specifies which of the default plugins included in WordPress should be added to the TinyMCE instance.

Parameters

$pluginsarray
An array of default TinyMCE plugins.
$editor_idstring
Unique editor identifier, e.g. 'content'. Accepts 'classic-block' when called from block editor’s Classic block.

Source

$plugins = array_unique( apply_filters( 'tiny_mce_plugins', $plugins, $editor_id ) );

Changelog

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