load-(page_hook) │ хук-событие │ WP 2.1.0

В этом примере мы регистрируем страницу настроек и разделяем действия: HTML код страницы обрабатываем отдельно, а прочие действия вешаем на другую функцию. Сделать это удобно с помощью хука load-(page_hook).

Предположим, что наш плагин обязательно нужно настроить. И мы вешаем сообщение в админке, на все страницы, если плагин еще не настроен (через хук admin_notices). Но такое сообщение не должно показываться на странице настроек самого плагина:

<?php
add_action('admin_menu', 'my_plugin_menu');

// Здесь мы может проверить все ли опции плагина сконфигурированы. 
// Например, можем проверить существуют ли опции плагина. Если нет, 
// то добавим хук, который их установит
// Сейчас хук всегда активен!
add_action( 'admin_notices', 'my_plugin_admin_notices' );

function my_plugin_menu() {
	// Регистрируем страницу настроек плагина и получаем её суффикс
	$hook_suffix = add_options_page('My Plugin Options', 'My Plugin', 'manage_options', 'my-unique-identifier', 'my_plugin_options');

	// Используем полученный суффикс, чтобы выполнить действия только для нашей страницы
	add_action( 'load-' . $hook_suffix , 'my_load_function' );
}

function my_load_function() {
	// Тут все будет работать только для нашей страницы настроек плагина. Поэтому тут не показываем сообщение (удаляем вышедобавленный хук
	remove_action( 'admin_notices', 'my_plugin_admin_notices' );
}

function my_plugin_admin_notices() {
	echo "<div id='notice' class='updated fade'><p>Вы не настроили плагин. Сделайте же это!</p></div>\n";
}
// страница настроек плагина
function my_plugin_options() {
	if( ! current_user_can('manage_options') )  {
		wp_die( __('You do not have sufficient permissions to access this page.') );
	}
	echo '<div class="wrap">';
	echo '<p>Здесь HTML код настроек.</p>';
	echo '</div>';
}
?>

add_action( 'admin_init', 'my_plugin_admin_init' );
add_action( 'admin_menu', 'my_plugin_admin_menu' );

function my_plugin_admin_init() {
	/* Регистрируем наш скрипт. */
	wp_register_script( 'my-plugin-script', plugins_url('/script.js', __FILE__) );
}

function my_plugin_admin_menu() {
	/* Регистрируем страницу нашего плагина */
	$page = add_submenu_page( 
		'edit.php', // Родительская страница меню
		__( 'Мой плагин', 'myPlugin' ), // Название пункта меню
		__( 'Мой плагин', 'myPlugin' ), // Заголовок страницы
		'manage_options', // Возможность, определяющая уровень доступа к пункту
		'my_plugin-options', // Ярлык (часть адреса) страницы плагина
		'my_plugin_manage_menu' // Функция, которая выводит страницу
	);

	/* Используем зарегистрированную страницу для загрузки скрипта */
	add_action( "admin_print_scripts-{$page}", 'my_plugin_admin_scripts' );
}

function my_plugin_admin_scripts() {
	/*
	 * Эта функция будет вызвана только на странице плагина, подключаем наш скрипт
	 */
	wp_enqueue_script( 'my-plugin-script' );
}

function my_plugin_manage_menu() {
	/* Выводим страницу плагина */
}