wp_editor

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

Значение параметра editor_id это буквы в нижнем регистре, без тире и подчеркиваний: editpost, mycustomeditor и т.д. Чтобы не было ошибок при использовании WYSIWYG редактора, не нарушайте это правило.

Хуков нет.

Возвращает

Выводит на экран html код формы.

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

wp_editor( $content, $editor_id, $settings = array() );

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

wp_editor('content', 'editor_id', 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,
	'drag_drop_upload' => false
) );
$content(строка) (обязательный)
Заранее установленный текст в поле формы.
По умолчанию: нет
$editor_id(строка) (обязательный)
Идентификатор для полей textarea и TinyMCE. Может содержать только буквы в нижнем регистре (тире, подчеркивание использовать нельзя).
По умолчанию: нет
$settings(массив)
Массив аргументов (см. ниже).
По умолчанию: нет

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

wpautop(логический)
1 – применять функцию wpautop().
По умолчанию: 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 – скроет кнопу.
dfw(логический)
Заменить полноэкранный режим по умолчанию на DFW (нужны специальные DOM элементы и CSS).
tinymce(логический/массив)

Загружать визуальный редактор TinyMCE или нет. Можно указать параметры редактора напрямую в массиве array(). Возможные элементы массива: из файла: /wp-includes/class-wp-editor.php:

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

#2. Заполним поле контентом поста 51:

$post_id = 51;
$post = get_post( $post_id, OBJECT, 'edit' );

$content = $post->post_content;
$editor_id = 'editpost';

wp_editor( $content, $editor_id );

#3. Изменение настроек формы

Мы также может изменить настройки выводимой формы, если базовые нас не устраивают. Например, мы может убрать кнопку добавления медиафайлов:

$settings = array( 'media_buttons' => false );

wp_editor( $content, $editor_id, $settings );

Заметки

Несмотря на то что кнопка с комбинациями клавиш, которые можно использовать визуальном редакторе TyniMCE находится на виду, мало кто знает эти самые комбинации. А еще меньше тех, кто их использует. И порой это очень зря… Взгляните на возможные комбинации и выберите себе хотя бы парочку, наверняка там есть то, что вам постоянно приходится наживать на панели:

Комбинации клавиш в визуальном редакторе WordPress

Код из


wp-includes/general-template.php

WP 4.7.2

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

Комментарии:


Оставить комментарий

Your email address will not be published. Required fields are marked *