admin_head │ хук-событие │ WP 2.1.0

Срабатывает внутри секции <head> на всех страницах админки WordPress.

Используется для вывода встроенных CSS/JS или другой HTML-разметки. Callback-функция не получает параметров.

Хук срабатывает на всех страницах админки. При необходимости ограничьте вывод с помощью get_current_screen().

Для подключения отдельных CSS- и JS-файлов используйте admin_enqueue_scripts.

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

add_action( 'admin_head', 'wp_kama_admin_head_action' );

/**
 * Function for `admin_head` action-hook.
 * 
 * @return void
 */
function wp_kama_admin_head_action(){
	// action...
}

Примеры

#1 Добавим CSS на главную страницу админки

Скроем настройку отображения приветственной панели.

add_action( 'admin_head', 'wp_kama_hide_welcome_panel_option' );

function wp_kama_hide_welcome_panel_option() {
	$screen = get_current_screen();

	if ( ! $screen || 'dashboard' !== $screen->id ) {
		return;
	}

	?>
	<style>
		[for="wp_welcome_panel-hide"] {
			display: none !important;
		}
	</style>
	<?php
}

#2 Добавим JavaScript в админку

add_action( 'admin_head', 'wp_kama_admin_head_script' );

function wp_kama_admin_head_script() {
	?>
	<script>
		console.log( 'Admin page loaded' );
	</script>
	<?php
}

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

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

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

В файле: /wp-admin/admin-header.php
admin_head
wp-admin/admin-header.php 168
do_action( 'admin_head' );
wp-admin/includes/media.php 609
do_action( 'admin_head' );
wp-admin/includes/template.php 2175
do_action( 'admin_head' );

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

wp-admin/export.php 46
add_action( 'admin_head', 'export_add_js' );
wp-admin/includes/admin-filters.php 42
add_action( 'admin_head', 'wp_color_scheme_settings' );
wp-admin/includes/admin-filters.php 48
add_action( 'admin_head', 'wp_admin_canonical_url' );
wp-admin/includes/admin-filters.php 49
add_action( 'admin_head', 'wp_site_icon' );
wp-admin/includes/admin-filters.php 50
add_action( 'admin_head', 'wp_admin_viewport_meta' );
wp-admin/network/settings.php 44
add_action( 'admin_head', 'network_settings_add_js' );
wp-admin/options-general.php 25
add_action( 'admin_head', 'options_general_add_js' );
wp-admin/options-reading.php 20
add_action( 'admin_head', 'options_reading_add_js' );
wp-includes/build/pages/font-library/page.php 128
remove_action( 'admin_head', 'wp_admin_bar_header' );
wp-includes/build/pages/options-connectors/page.php 128
remove_action( 'admin_head', 'wp_admin_bar_header' );
wp-includes/class-wp-admin-bar.php 55
add_action( 'admin_head', 'wp_admin_bar_header' );
wp-includes/default-filters.php 648
add_action( 'admin_head', 'wp_check_widget_editor_deps' );
wp-includes/general-template.php 5368
add_action( 'admin_head', '_thickbox_path_admin_subfolder' );
wp-includes/theme-previews.php 91
add_action( 'admin_head', 'wp_block_theme_activate_nonce' );