WordPress 3.3新增功能wp_editor介绍

最后更新于 2013 年 2 月 6 日

WordPress 3.3版本新增了一个wp editor class （/wp-includes/class-wp-editor.php）。这个class使定制WordPress默认编辑器TinyMCE变的方便简单。特别是新增的函数wp_editor，用这个函数就能在WordPress任何地方将一个textarea渲染成TinyMCE编辑器。

函数原型和参数

<?php wp_editor( $content, $editor_id, $settings = array() ); ?>

• $content – textarea中的内容
• $editor_id – 编辑器的HTML ID，只能包含小写字母
• $settings – 设置选项，是一个数组，可以设置的参数包括：
  • wpautop – 是否开启wpautop，默认为true
  • media_buttons – 是否显示上传多媒体的按钮，默认true
  • textarea_name – textarea的name属性，默认与$editor_id相同
  • textarea_rows – textarea的rows属性，默认是get_option('default_post_edit_rows', 10)，这一项在后台设置
  • tabindex – tabindex数值，tabindex规定用户用键盘的tab键切换表单元素时的顺序。
  • editor_css – 给编辑器添加css样式，适用于visual和html模式，必须包含<style>标签
  • teeny – 是否开启精简模式，这种模式下只加载基本插件（不加载任何外部TinyMCE插件），加载的插件包括inlinepopups、fullscreen、wordpress、wplink和wpdialogs，默认为false
  • tinymce – 用数组形式直接向tinyMCE传递参数
  • quicktags – 加载Quicktags，即HTML模式下的那些按钮，可以用数组形式直接向Quicktags传递参数。
  • dfw – 是否用DFW替换默认的全屏编辑器（需要特殊的DOM元素和css支持），开启该模式时，加载的全屏插件是wpfullscreen，默认为false。

代码实例

1. 启用teeny模式

<?php wp_editor( '', 'myeditor', array(
            'teeny' => true )
	);
?>

效果如下图所示

2. 关闭teeny模式，关闭media_buttons

<?php wp_editor( '', 'myeditor', array(
	'media_buttons' => false )
    );
?>

效果如下图所示

3. 去掉WordPress自定义按钮，更换皮肤为default，默认是wp_theme

<?php wp_editor( '', 'myeditor', array(
		'media_buttons' => false,
		'tinymce' => array( 'plugins' => '','skin' => 'default') )
	  );
?>

效果如下

可选的皮肤：default、wp_theme、o2k7和highcontrast

4.控制每行显示哪些按钮，显示部分WordPress隐藏的按钮

<?php wp_editor( '', 'myeditor', array(
			'media_buttons' => false,
			'tinymce' => array( 'plugins' => '',
						'skin' => 'o2k7',
						'theme_advanced_buttons1' => 'undo,redo,|,bold,italic,underline,strikethrough|,justifyleft,justifycenter,justifyright,justifyfull,|,forecolor,backcolor',
						'theme_advanced_buttons2' => 'cut,copy,paste,|,bullist,numlist,blockquote,|,link,unlink,anchor,image,|,sub,sup,hr'
					 )
			)
	  );
?>

效果如下

使用tinymce参数向TinyMCE传参时，使用TinyMCE的格式，具体参考这里