Описание
Создает поле формы 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 (массив)
- Массив аргументов (см. ниже).
По умолчанию: нет - 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
Аргументы параметра $settings
Примеры
1. Выведем поле ввода текста с редактором TinyMCE и HTML редактором, где-нибудь на страницах сайта. Для этого вставим следующий код в шаблон, в то место где нужно вывести такое поле:
<?php wp_editor( '', 'wp_editor', array('textarea_name' => 'content') ); ?>
wp_editor()
из файла: /wp-includes/general-template.php WP 3.3.2function 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 и Теги Шаблона.