Описание функции wp_enqueue_media()
Функция wp_enqueue_media() подключает все необходимые скрипты и стили для работы с медиа-библиотекой WordPress. Она позволяет использовать встроенные медиа-функции, такие как загрузка изображений и файлов, а также предоставляет интерфейс для выбора медиа-контента.
Эта функция обычно используется в контексте админ-панели и на страницах редактирования записей или страниц, где требуется возможность работы с медиа-контентом.
Параметры
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив аргументов для настройки медиа-интерфейса
Возможные значения:
title: Заголовок окна выбора медиа
button: Текст кнопки выбора (по умолчанию ‘Выбрать’)
Возвращаемое значение
Тип: void
Описание: Функция не возвращает значения
Примеры использования
Базовый пример подключения медиа-функций в админке
function my_enqueue_media() {
wp_enqueue_media();
}
add_action('admin_enqueue_scripts', 'my_enqueue_media');
Убедитесь, что этот код находится в файле плагина или в functions.php вашей темы
Подключение медиа с пользовательским заголовком и текстом кнопки
function my_enqueue_media() {
wp_enqueue_media(array(
'title' => 'Выберите изображение',
'button' => array(
'text' => 'Выбрать изображение'
)
));
}
add_action('admin_enqueue_scripts', 'my_enqueue_media');
Пользовательские параметры помогут улучшить пользовательский интерфейс
Безопасность
Валидация входных данных: Параметры функции не требуют дополнительной валидации, так как используются по умолчанию
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: При выводе пользовательских данных используйте функции экранирования, такие как esc_html()
— Связанные функции
JavaScript объект для работы с медиа в WordPress
Обрабатывает загрузку файлов
— Примечания
– Ограничения
Функция не может быть использована вне админ-панели
– Частые проблемы
- Не отображается интерфейс выбора медиа, если функция не была вызвана
- Проблемы с работой в нестандартных темах или плагинах, которые изменяют админку
