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() {
	/* Виводимо сторінку плагіна */
}