admin_print_footer_scripts-(hook_suffix) │ хук-событие │ WP 4.6.0

Срабатывает при подключении скриптов в футере определенной страницы админки.

Это событие используется для добавления JavaScript-кода или подключения дополнительных скриптов непосредственно перед закрывающим тегом </body> в админке, но только на определённой странице, соответствующей hook_suffix.

Полезно для случаев, когда нужно вставить специфический JS только на одной странице админки, а не везде.

Использование

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.

Примеры

add_action( 'admin_print_footer_scripts-settings_page_myplugin', function() {
	?>
	<script>
		console.log('Скрипт загружен на страницу настроек плагина');
	</script>
	<?php
} );

Добавить свой пример