wp_editor с версии 3.3

Описание

Создает поле формы textarea со стандартным визуальным и HTML редактором WP (TinyMCE). Можно использовать в шаблоне, на страницах типа: запись, постоянная страница и т.д.

Функция возвращает html код формы.

Использование

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

Шаблон использования

<?php
$args = array( 'wpautop' => 1
	,'media_buttons' => 1
	,'textarea_name' => '' //нужно указывать!
	,'textarea_rows' => 20
	,'tabindex' => null
	,'editor_css' => ''
	,'editor_class' => ''
	,'teeny' => 0
	,'dfw' => 0
	,'tinymce' => 1
	,'quicktags' => 1
);
wp_editor( '', 'editor_id', $args );
?>

Параметры

$content (строка)

Заранее установленный текст в поле формы.
По умолчанию: нет

$editor_id (строка) (обязательный)

Идентификатор для полей textarea и TinyMCE. Может содержать только буквы в нижнем регистре (тире, подчеркивание использовать нельзя).
По умолчанию: нет

$settings (массив)

Массив аргументов (см. ниже).
По умолчанию: нет

Аргументы параметра $settings

wpautop (логический)

Автоматическое форматирование тегов переноса строк. 0 - значит, что в html редакторе нужно указывать теги переноса или параграфа (<br />, <p>...</p>).
По умолчанию: 1

media_buttons (логический)

Показывать медиа кнопку (вставка/загрузка).
По умолчанию: 1

textarea_name (строка)

значение атрибута name у поля textarea.
По умолчанию: $editor_id

textarea_rows (число)

Количество строк у поля формы. Высота поля ввода текста. По-умолчанию берется значение их настроек админ-панели.
По умолчанию: get_option('default_post_edit_rows', 10)

tabindex (число)

Значение атрибута tabindex у поля textarea.
По умолчанию: нет

editor_css (строка)

Дополнительные CSS стили для редактора. Нужно указывать в теге <style>. Указанный здесь текст будет расположен прям перед формой.
По умолчанию: нет

editor_class (строка)

Дополнительные CSS классы к полю textarea.
По умолчанию: ''

teeny (логический)

Скрыать или нет кнопку расширяющую возможности визуального редактора. 1 - скроет кнопу.
По умолчанию: 0

dfw (логический)

Заменить полноэкранный режим по умолчанию на DFW (нужны специальные DOM элементы и CSS).
По умолчанию: 0

tinymce (логический/массив)

Загружать визуальный редактор TinyMCE или нет. Можно указать параметры редактора напрямую в массиве array().
По умолчанию: 1

quicktags (логический/массив)

Загружать HTML редактор или нет. Можно указать параметры напрямую в массиве array().
По умолчанию: 1

Примеры

1. Выведем поле ввода текста с редактором TinyMCE и HTML редактором, где-нибудь на страницах сайта. Для этого вставим следующий код в шаблон, в то место где нужно вывести такое поле:

<?php wp_editor( '', 'wp_editor', array('textarea_name' => 'content') ); ?>

wp_editor()

function wp_editor( $content, $editor_id, $settings = array() ) {
	if ( ! class_exists( '_WP_Editors' ) )
		require( ABSPATH . WPINC . '/class-wp-editor.php' );

	_WP_Editors::editor($content, $editor_id, $settings);
}

Ещё из раздела

Смотрите также: Функции WordPress и Теги Шаблона.