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

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

Это событие используется для добавления 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.

Примеры

0

#1 Добавление скрипта на страницу настроек плагина

Вставка скрипта в футер страницы настроек с hook_suffix = settings_page_myplugin.

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

Список изменений

С версии 4.6.0 Введена.

Где вызывается хук

В файле: /wp-admin/admin-footer.php
admin_print_footer_scripts-(hook_suffix)
wp-admin/admin-footer.php 88
do_action( "admin_print_footer_scripts-{$hook_suffix}" ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
wp-admin/includes/template.php 2225
do_action( "admin_print_footer_scripts-{$hook_suffix}" ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores

Где используется хук в WordPress

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