Описание load-{$plugin_page}
— Action
Хук load-{$plugin_page} позволяет выполнять действия при загрузке страниц плагинов в административной панели WordPress. Он срабатывает после того, как загружены все необходимые файлы плагина, но перед выводом контента на экран, что позволяет добавлять или изменять функциональность страниц плагина
Примеры использования
Пример добавления кастомного JavaScript на страницу настроек плагина:
add_action('load-my_plugin_settings', function() {
wp_enqueue_script('my-custom-script', plugins_url('js/custom.js', __FILE__));
});
В этом примере мы подключаем кастомный JavaScript-файл на странице настроек плагина
Пример проверки прав доступа перед загрузкой страницы плагина:
add_action('load-my_plugin_settings', function() {
if (!current_user_can('manage_options')) {
wp_die('У вас нет прав доступа к этой странице');
}
});
Этот код проверяет, имеет ли текущий пользователь права на управление опциями, и, если нет, выводит сообщение об ошибке
Пример изменения заголовка страницы плагина при загрузке:
add_action('load-my_plugin_settings', function() {
add_filter('admin_title', function($title) {
return 'Настройки моего плагина - ' . get_bloginfo('name');
});
});
Мы изменяем заголовок страницы админки, добавляя название плагина
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо выполнить действия или изменить поведение страницы плагина перед её выводом
– Производительность
Не забывайте о производительности, так как излишние действия могут замедлить загрузку страниц админки
– Предупреждения
Убедитесь, что код, выполняемый в этом хуке, не вызывает ошибок, так как это может привести к сбоям в отображении страницы
Альтернативы
Тип: action
Этот хук позволяет подключать скрипты и стили на всех страницах админки
Используйте его, если нужно подключить ресурсы на нескольких страницах, а не только на одной
Тип: action
Этот хук позволяет добавлять новые пункты меню в админку
Используйте его, если необходимо создать страницу плагина в меню админки
