В этом коротком руководстве мы обозначим, для чего хорошо подойдет wp_editor.
Что такое wp_editor?
Это функция WordPress, которая создает визуальный (WYSIWYG) редактор по типу того, который вы видите в панели администратора при создании Записей или Страниц. Эта маленькая удобная функция доступна, начиная с WordPress 3.3.
Если вам нужно больше информации о wp_editor — есть подробная страница на Codex. WordPress использует отдельную версию редактора TinyMCE, ее можно найти здесь. Чтобы посмотреть файлы, зайдите в папку wp-includes/js/tinymce в директории установки WordPress.
Так выглядит стандартный редактор в панели администратора.
Зачем это нам нужно?
Для того, чтобы использовать эту возможность также в темах и плагинах! Оформление контента может быть удобным не только в записях. Мы можем использовать разные редакторы на одной странице, просто правильно используя переменные content и ID.
Примеры
Эта часть статьи подразумевает, что у вас хотя бы базовые навыки PHP программирования. Переменные $content и $editor_id — обязательны, они должны быть установлены всегда. Переменная $settings — массив, в котором возможности редактора могут быть включены или выключены.
Пожалуйста, обратите внимание, что большинство объяснений — в комментариях, прочтите их.
Следующие фрагменты кода (1, 2, 3 и 4) покажут, как использовать функцию.
/**
* Обязательные переменные
*/
wp_editor( $content, $editor_id );
/**
* Базовый синтаксис
*/
wp_editor( $content, $editor_id, $settings = array() );
/**
* 1.
* Первая переменная установит контент, который будет отображаться блоке,
* вторая – содержит HTML атрибут редактора id
* (символы в нижнем регистре без подчеркиваний или дефисов).
*/
wp_editor( 'Hello World! This is our first test! Enjoy!', 'ourmaineditor' );
/**
* 2.
* Этот код выводит блок редактора и кнопку Submit.
* У блока будет 15 строк, квик-теги загружаться не будут.
* Используется настройка PressThis.
*/
$args = array(
'textarea_rows' => 15,
'teeny' => true,
'quicktags' => false
);
wp_editor( 'This is the default text!', 'editor', $args );
submit_button( 'Save content' );
/**
* 3.
* Мы можем пересоздать редактор записи с помощью функции get_post,
* которая получит существующую запись (в данном случае 117)
* из базы данных.
*/
$post = get_post( 117, 'OBJECT' );
wp_editor( $post, 'editor' );
/**
* 4.
* Пользовательские кнопки для редактора.
* Это список, разделенный запятой после каждой опции,
* например link, unlink, bold, ...
*/
$settings = array(
'textarea_name' => 'content',
'media_buttons' => false,
'tinymce' => array(
'theme_advanced_buttons1' => 'formatselect,|,bold,italic,underline,|,' .
'bullist,blockquote,|,justifyleft,justifycenter' .
',justifyright,justifyfull,|,link,unlink,|' .
',spellchecker,wp_fullscreen,wp_adv'
)
);
wp_editor( '', 'content', $settings );
Пользовательская настройка редактора
Вы можете настроить возможности редактора с помощью этого описания из Codex. Чтобы покопаться глубже, вы можете также посмотреть файл class-wp-editor.php в папке wp-includes из корневой директории WordPress.
Источник: WP.tutsplus.com
Комментарии к записи: 0