add_menu_page() │ WP 1.5.0

Цей приклад показує, як додати сторінку налаштувань теми в головне меню адмін-панелі WordPress.

<?php
add_action('admin_menu', function(){
	add_menu_page( 'Додаткові налаштування сайту', 'Пульт', 'manage_options', 'site-options', 'add_my_setting', '', 4);
} );

// функція відповідає за виведення сторінки налаштувань
// докладніше дивіться API Налаштувань: http://wp-kama.ru/id_3773/api-optsiy-nastroek.html
function add_my_setting(){
	?>
	<div class="wrap">
		<h2><?php echo get_admin_page_title() ?></h2>

		<?php
		// settings_errors() не спрацьовує автоматично на сторінках відмінних від опцій
		if( get_current_screen()->parent_base !== 'options-general' )
			settings_errors('назва_опції');
		?>

		<form action="options.php" method="POST">
			<?php
				settings_fields("opt_group"); // приховані захисні поля
				do_settings_sections("opt_page"); // секції з налаштуваннями (опціями).
				submit_button();
			?>
		</form>
	</div>
	<?php

}

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

Варіант 1 (тільки для плагінів):

add_action( 'admin_menu', 'register_my_custom_menu_page');
function register_my_custom_menu_page(){
	add_menu_page( 'custom menu title', 'custom menu', 'manage_options', 'myplugin/myplugin-admin.php', '', plugins_url( 'myplugin/images/icon.png' ), 6 );
}

У цьому випадку код сторінки повинен бути розташований у файлі wp-content/plugins/myplugin/myplugin-admin.php:

<?php
	echo "Код сторінки";
?>

Варіант 2:

add_action( 'admin_menu', 'register_my_custom_menu_page');
function register_my_custom_menu_page(){
	add_menu_page(
		'custom menu title', 'custom menu', 'manage_options', 'custompage', 'my_custom_menu_page', plugins_url( 'myplugin/images/icon.png' ), 6
	);
}

function my_custom_menu_page(){
	echo "Код сторінки";
}

Припустимо, що перед додаванням пункту меню потрібно переконатися, що цей пункт ще не доданий з іншого місця. Для того, щоб таку перевірку зробити дуже швидкою, можна використовувати глобальну змінну $admin_page_hooks

global $admin_page_hooks;

if( isset($admin_page_hooks['ідентифікатор_пункту_меню']) ){
	add_submenu_page(...);
}
else {
	add_menu_page( ..., ..., ..., 'ідентифікатор_пункту_меню');
	add_submenu_page(...);
}

Ця функція перевіряє наявність пункту меню або підменю за вказаним ідентифікатором цього пункту.

/**
 * Знаходить вказаний елемент меню або підменю адмінки.
 *
 * Потрібно використовувати після події admin_menu.
 *
 * Приклад використання: if( is_admin_menu_item_exists('options-general.php') ){ }
 *
 * @param string $handle Ідентифікатор пункту меню. Вказується в 4 параметрі add_menu_page() або add_submenu_page()
 * @param boolean [$sub = false] Вказано ID меню або підменю?
 * @return boolean Є пункт меню чи ні
 */
function is_admin_menu_item_exists( $handle, $sub = false ){
	if( !is_admin() || (defined('DOING_AJAX') && DOING_AJAX) )
		return false;

	Global $menu, $submenu;

	$check_menu = $sub? $ submenu : $ menu;

	if( empty($check_menu) )
		return false;

	foreach( $check_menu as $k => $item ){
		if( $sub ){
			foreach( $item as $sm ){
			  if( $handle == $sm[2] )
				return true;
			}
		}
		elseif( $handle == $item[2] )
			return true;
	}

	return false;
}

Допустимо, нам потрібно додати в меню довільне посилання /wp-admin/post.php?post=270&action=edit:

add_action( 'admin_menu', 'change_menu');
function change_menu() {
	$post_id = 393;
	$url_edit = get_edit_post_link( $post_id );

	if ( $url_edit ) {
		add_menu_page( '', 'Моя стаття', 'edit_posts', $url_edit, '', '', 5 );
	}
}