Функция wp_enqueue_editor()
является важным инструментом в WordPress, который позволяет подключать скрипты и стили для инициализации редактора TinyMCE. Этот редактор предоставляет визуальный интерфейс для редактирования содержимого, делая процесс написания и форматирования текста более удобным и интуитивно понятным.
wp_enqueue_editor()
Описание
Функция wp_enqueue_editor()
выводит необходимые скрипты и стили для редактора TinyMCE, а также настройки по умолчанию. После загрузки страницы вы можете инициализировать редактор на любом поле textarea
с помощью JavaScript.
Возвращаемое значение
Функция не возвращает никаких значений (null).
Пример 1: Подключение и инициализация редактора
В этом примере мы подключаем редактор и инициализируем его на поле textarea
.
<?php
// Подключаем стили и скрипты для редактора
wp_enqueue_editor();
// Запускаем скрипт инициализации редактора
add_action( 'wp_footer', function() {
?>
<script>
var id = 'my_textarea_id'; // Замените на ID вашего textarea
wp.editor.initialize( id, {
tinymce: {
wpautop: true // Включение автоматического добавления <p> тегов
},
quicktags: true // Включение кнопок быстрого редактирования
});
</script>
<?php
}, 99);
Пример 2: Инициализация редактора с дополнительными настройками
Вы можете настроить редактор, добавляя дополнительные параметры в объект настройки.
<?php
// Подключаем стили и скрипты для редактора
wp_enqueue_editor();
// Запускаем скрипт инициализации редактора
add_action( 'wp_footer', function() {
?>
<script>
var id = 'my_textarea_id'; // Замените на ID вашего textarea
wp.editor.initialize( id, {
tinymce: {
wpautop: true,
toolbar: 'bold italic | link',
menubar: false // Отключение верхнего меню
},
quicktags: true
});
</script>
<?php
}, 99);
Инициализация редактора
Для инициализации визуального редактора используйте метод JavaScript wp.editor.initialize()
, который находится в файле wp-admin/js/editor.js
. Вы можете передать ему ID вашего элемента textarea
и настройки, которые хотите применить к редактору.
Настройки и параметры
tinymce
: Объект, содержащий параметры для настройки TinyMCE.quicktags
: Boolean значение, указывающее, должны ли быть включены кнопки быстрого редактирования.
Заключение
Функция wp_enqueue_editor()
предоставляет разработчикам WordPress мощный инструмент для работы с визуальным редактором TinyMCE. Правильное подключение и инициализация редактора делают процесс редактирования содержимого на сайте более удобным и функциональным. Используя примеры выше, вы можете легко интегрировать редактор в ваши темы и плагины.