Хук admin_enqueue_scripts
используется для правильного подключения стилей и скриптов в админ-панели WordPress. Это аналог хука wp_enqueue_scripts
, но предназначенный для работы только в административной части сайта.
Когда использовать admin_enqueue_scripts
?
Этот хук особенно полезен, если вам нужно добавить кастомные стили или скрипты, которые будут загружаться только на страницах админ-панели. Например, вы разрабатываете плагин или тему, и хотите, чтобы определённые скрипты или стили использовались только в интерфейсе администрирования, а не на публичной части сайта.
Пример использования admin_enqueue_scripts
Допустим, вы хотите подключить CSS и JavaScript для кастомной страницы настроек вашего плагина или темы. Вот пример кода для файла functions.php
:
function my_admin_enqueue_scripts($hook) {
// Проверяем, что скрипты загружаются только на нужной странице админки
if ($hook != 'settings_page_my-plugin-settings') {
return;
}
// Подключаем файл стилей для админки
wp_enqueue_style('my-admin-style', get_template_directory_uri() . '/admin/css/admin-style.css');
// Подключаем файл скрипта для админки
wp_enqueue_script('my-admin-js', get_template_directory_uri() . '/admin/js/admin-script.js', array('jquery'), '1.0', true);
}
add_action('admin_enqueue_scripts', 'my_admin_enqueue_scripts');
Разбор кода:
$hook
: Аргумент$hook
позволяет нам определить, на какой странице в админ-панели происходит подключение. В примере мы проверяем, загружается ли страница настроек плагина (settings_page_my-plugin-settings
), чтобы подключить скрипты и стили только на этой странице.wp_enqueue_style()
: Подключает файл стилей. В примере это файлadmin-style.css
, который будет применяться только к админке.wp_enqueue_script()
: Подключает JavaScript файл. В данном случае, этоadmin-script.js
, который загружается после библиотеки jQuery.
Зачем использовать admin_enqueue_scripts
?
- Оптимизация: Скрипты и стили загружаются только там, где это необходимо, что улучшает производительность.
- Отсутствие конфликтов: Вы предотвращаете конфликт с публичной частью сайта, обеспечивая подключение только в админ-панели.
- Чистота кода: Проще управлять стилями и скриптами в административной части, особенно если вы создаёте сложные интерфейсы для настроек или других админ-функций.
Использование хука admin_enqueue_scripts
поможет вам сделать интерфейс админ-панели более функциональным, аккуратным и оптимизированным для пользователей, не затрагивая основную часть сайта.