Описание функции wp_editor()
Функция wp_editor() создает графический редактор WYSIWYG для ввода текста. Используется в административной панели WordPress для редактирования содержимого постов, страниц и других пользовательских данных.
Редактор поддерживает форматирование текста, вставку медиа и другие функции, что делает его удобным инструментом для авторов контента.
Параметры
$content
Тип: string
Обязательный: Да
По умолчанию: »
Описание: Содержимое, которое будет отображаться в редакторе
Возможные значения:
$editor_id
Тип: string
Обязательный: Да
По умолчанию: »
Описание: Уникальный идентификатор редактора
Возможные значения:
$settings
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив настроек для редактора
Возможные значения:
tinymce: Кнопки инструментов для TinyMCE, Дополнительные кнопки инструментов
media_buttons: 1,
textarea_name: Имя текстовой области
Возвращаемое значение
Тип: string
Описание: HTML-код для редактора WYSIWYG
Возможные значения:
• HTML-код редактора при успешном выполнении
• null в случае ошибки
Примеры использования
Базовый пример создания редактора с текстом
$content = 'Привет, мир!';
wp_editor($content, 'my_editor');
Отобразит редактор с текстом ‘Привет, мир!’
Создание редактора с настройками для медиа-кнопок
$settings = array(
'media_buttons' => true,
'textarea_name' => 'post_content'
);
wp_editor($content, 'my_editor', $settings);
Включит кнопку для вставки медиа
Безопасность
Валидация входных данных: Параметры должны быть валидными строками и массивами
Санитизация: Содержимое автоматически очищается перед выводом
Рекомендации: При использовании пользовательских значений используйте esc_html() для защиты от XSS
— Связанные функции
Подключает необходимые скрипты и стили для редактора
— Хуки
Фильтрует настройки редактора перед его отображением
— Примечания
– Ограничения
Не поддерживает кастомные HTML-теги по умолчанию
– Частые проблемы
- Не отображается редактор при неправильных ID
- Проблемы с настройками конфликта скриптов
