admin_print_footer_scripts-(hook_suffix)
Срабатывает при подключении скриптов в футере определенной страницы админки.
Это событие используется для добавления JavaScript-кода или подключения дополнительных скриптов непосредственно перед закрывающим тегом </body>
в админке, но только на определённой странице, соответствующей hook_suffix
.
Полезно для случаев, когда нужно вставить специфический JS только на одной странице админки, а не везде.
Исползуйте admin_print_scripts-(hook_suffix), когда нужно сделать тоже самое только в <head>
части документа.
Использование
add_action( 'admin_print_footer_scripts-(hook_suffix)', 'wp_kama_admin_print_footer_scripts_hook_suffix_action' ); /** * Function for `admin_print_footer_scripts-(hook_suffix)` action-hook. * * @return void */ function wp_kama_admin_print_footer_scripts_hook_suffix_action(){ // action... }
- $hook_suffix(строка)
Уникальный идентификатор текущей страницы админки. Используется в названии хука.
$hook_suffix может быть одним из значений глобальных переменных (в зависимости от типа страницы):
$hook_suffix = $page_hook; // результат add_menu_page() и add_submenu_page() // или $hook_suffix = $plugin_page; // plugin_basename( $_GET['page'] ) // или $hook_suffix = $pagenow; // название php файла которые
Смотрите код wp-admin/admin.php
Список возможных значений динамического параметра
$hook_suffix
:Для $pagenow
index.php
— главная страница панели управления (Dashboard)edit.php
— список записейpost.php
— редактирование записиpost-new.php
— создание новой записиedit-tags.php
— управление метками и рубрикамиupload.php
— медиафайлыmedia-new.php
— загрузка нового медиафайлаedit-comments.php
— комментарииthemes.php
— темы оформленияcustomize.php
— кастомайзерwidgets.php
— виджетыnav-menus.php
— меню навигацииplugins.php
— список плагиновplugin-install.php
— установка плагиновusers.php
— список пользователейuser-new.php
— добавление нового пользователяprofile.php
— профиль текущего пользователяedit.php
— список страницedit.php
— список записей произвольного типаoptions-general.php
— общие настройкиoptions-writing.php
— настройки написанияoptions-reading.php
— настройки чтенияoptions-discussion.php
— настройки обсужденийoptions-media.php
— настройки медиафайловoptions-permalink.php
— настройки постоянных ссылокtools.php
— инструментыimport.php
— импортexport.php
— экспортadmin.php
— страницы плагинов и пользовательские страницы
Для $page_hook
Для кастомных страниц, добавленных через add_menu_page() или add_submenu_page(), создается уникальный$page_hook
, который возвращается функций регистрации и выглядит как:toplevel_page_myplugin
myplugin_page_settings
.
Примеры
#1 Добавление скрипта на страницу настроек плагина
Вставка скрипта в футер страницы настроек с hook_suffix = settings_page_myplugin
.
add_action( 'admin_print_footer_scripts-settings_page_myplugin', function() { ?> <script> console.log('Скрипт загружен на страницу настроек плагина'); </script> <?php } );
Список изменений
С версии 4.6.0 | Введена. |
Где вызывается хук
do_action( "admin_print_footer_scripts-{$hook_suffix}" ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
do_action( "admin_print_footer_scripts-{$hook_suffix}" ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores