current_screen │ хук-подія │ WP 3.0.0

Хук-подія адмін-панелі, яка відбувається, коли встановлені необхідні елементи для ідентифікації поточного екрану. Як параметр передає об’єкт WP_Screen.

Цей хук може знадобитися щоразу коли потрібно зробити, якусь дію тільки для конкретної сторінки адмінки. Наприклад, потрібно підключити свій скрипт і зробити це потрібно тільки на сторінці редагування посту або на сторінці плагіна, що створюється.

Використання

add_action( 'current_screen', 'action_function_name_9874');
function action_function_name_9874( $current_screen ) {
	// Дія...
}

$current_screen
(об’єкт)

Об’єкт – екземпляр класу WP_Screen, який містить масив даних про поточний екран.

Параметр $current_screen

У подію у параметрі $current_screen передається екземпляр класу WP_Screen. Цей приклад показує, які дані передаються в $current_screen на сторінці редагування запису (post.php):

WP_Screen Object
(
	[action] =>
	[base] => post
	[columns:WP_Screen:private] => 0
	[id] => post
	[in_admin:protected] => site
	[is_network] =>
	[is_user] =>
	[parent_base] =>
	[parent_file] =>
	[post_type] => post
	[taxonomy] =>
	[_help_tabs:WP_Screen:private] => Array
		(
		)

	[_help_sidebar:WP_Screen:private] =>
	[_options:WP_Screen:private] => Array
		(
		)

	[_show_screen_options:WP_Screen:private] =>
	[_screen_settings:WP_Screen:private] =>
)

Тепер, для порівняння, подивимося, які дані передаються на сторінці списку рубрик:

WP_Screen Object
(
	[action] =>
	[base] => edit-tags
	[columns:WP_Screen:private] => 0
	[id] => edit-category
	[in_admin:protected] => site
	[is_network] =>
	[is_user] =>
	[parent_base] =>
	[parent_file] =>
	[post_type] => post
	[taxonomy] => category
	[_help_tabs:WP_Screen:private] => Array
		(
		)

	[_help_sidebar:WP_Screen:private] =>
	[_options:WP_Screen:private] => Array
		(
		)

	[_show_screen_options:WP_Screen:private] =>
	[_screen_settings:WP_Screen:private] =>
)

Приклади

add_action( 'current_screen', 'current_screen_hook');
function current_screen_hook( $current_screen ){
	if ( 'book' == $current_screen->post_type && 'post' == $current_screen->base ) {
		// Робимо щось на сторінці редагування запису типу book
	}
}

add_action( 'current_screen', 'kkk_my_func');
function kkk_my_func( $current_screen ){
	if( 'edit-tags' != $current_screen->base )
		return;

	add_action('admin_footer_text', 'my_admin_footer_function_name');
}

function my_admin_foofter_function_name(){
	echo "Це сторінка списку таксономій.";
}

Додати свій приклад