WordPress模板开发之mce_external_languages的使用解析

WordPress中的`mce_external_languages`是用于自定义TinyMCE编辑器的语言文件的钩子。

`mce_external_languages`钩子在加载TinyMCE编辑器时被触发，并允许你指定自定义的语言文件。语言文件是用于本地化编辑器界面的翻译文件，它包含了编辑器菜单、按钮等文本的翻译。

以下是使用`mce_external_languages`钩子的用法详解：

1. 注册钩子：在主题的`functions.php`文件或自定义插件中注册钩子。

function my_custom_mce_external_languages($locales) {
// 返回一个包含自定义语言文件路径的数组
$locales['my_language'] = get_template_directory_uri() . '/languages/my_language.js';
return $locales;
}
add_filter('mce_external_languages', 'my_custom_mce_external_languages');

2. 创建语言文件：在你主题或插件的`languages`目录中创建一个名为`my_language.js`的文件。

javascript
tinyMCE.addI18n('my_language', {
"My Plugin": "我的插件",
"My Button": "我的按钮"
});

3. 使用自定义语言文件：在编辑器中加载自定义语言文件。你可以在任何你想要加载编辑器的地方使用以下代码片段。

$settings = array(
'tinymce' => array(
'language' => 'my_language' // 这里指定要加载的自定义语言文件
)
);
wp_editor('', 'my_editor', $settings);

这样，当加载编辑器时，将会加载你自定义的语言文件，并将编辑器中的文本翻译为你指定的语言。

总结：
`mce_external_languages`钩子允许你自定义TinyMCE编辑器的语言文件，以便本地化编辑器界面的文本。你需要在`mce_external_languages`钩子中注册一个回调函数，返回一个包含自定义语言文件路径的数组。然后在你的自定义语言文件中指定编辑器中文本的翻译。最后，在加载编辑器时，通过设置`language`参数来加载自定义的语言文件。