wp_editor()函数是WordPress中用于集成TinyMCE编辑器的函数。该函数自WordPress 3.3版本引入,允许开发者在WordPress的任何位置嵌入一个富文本编辑器,支持富文本格式和媒体嵌入功能。
函数参数
wp_editor()
函数的参数包括:
- $content:编辑器初始内容,必填。
- $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数值,规定用户用键盘的tab键切换表单元素时的顺序。
- editor_css:给编辑器添加css样式,适用于visual和html模式,必须包含<style>标签。
- teeny:是否开启精简模式,这种模式下只加载基本插件,默认为false。
- tinymce:用数组形式直接向tinyMCE传递参数。
- quicktags:加载Quicktags,即HTML模式下的那些按钮,可以用数组形式直接向Quicktags传递参数。
- dfw:是否用DFW替换默认的全屏编辑器,默认为false12。
使用场景和示例代码
在WordPress中,wp_editor()
函数常用于文章编辑界面、自定义表单等需要富文本编辑功能的场景。例如,在文章编辑界面,可以使用以下代码在侧边栏添加一个额外的编辑器:
add_action('dbx_post_sidebar', 'add_editor');
function add_editor() {
wp_editor('', 'new_editor', array(
'textarea_name' => 'new_content',
'media_buttons' => false,
'teeny' => true,
));
}
这段代码会在文章编辑界面的侧边栏添加一个新的TinyMCE编辑器
没有回复内容