add_submenu_page() │ WP 1.5.0

add_submenu_page( $parent_slug, $page_title, $menu_title, $capability, $menu_slug, $function, $position );

add_menu_page( 'Основное доп. меню', 'Мое основное меню', 'manage_options', 'my-top-level-slug' );

add_submenu_page( 'my-top-level-slug', 'Основное доп. меню', 'Мое основное меню', 'manage_options', 'my-top-level-slug');

add_submenu_page( 'my-top-level-slug', 'Мое подменю', 'Страница настроек моего подменю', 'manage_options', 'my-secondary-slug', 'page_callback_function');

// Добавим подменю в меню админ-панели "Инструменты" (tools):
add_action('admin_menu', 'register_my_custom_submenu_page');

function register_my_custom_submenu_page() {
	add_submenu_page(
		'tools.php',
		'Дополнительная страница инструментов',
		'Название инструмента',
		'manage_options',
		'my-custom-submenu-page',
		'my_custom_submenu_page_callback'
	);
}

// контент страницы
function my_custom_submenu_page_callback() {
	?>
	<div class="wrap">
		<h2><?= get_admin_page_title() ?></h2>
	</div>
	<?php
}

// Прячем страницу из меню, но она все равно будет рабочей
add_action( 'admin_menu', 'register_my_custom_submenu_page' );

function register_my_custom_submenu_page() {
	add_submenu_page(
		'options.php',
		'Произвольная страница подменю',
		'Произвольная страница подменю',
		'manage_options',
		'my-custom-submenu-page',
		'my_custom_submenu_page_callback'
	);
}

add_action( 'admin_menu', 'add_options_page' );

function add_options_page(){

	add_submenu_page( 
		'options-general.php', 
		'Заголовок страницы', 
		'Название пункта меню', 
		'manage_options', 
		basename( dirname(__FILE__) ) . '/options.php' 
	);
}

$hookname = add_submenu_page( 
	'options-general.php', 
	$page_title, 
	$menu_title, 
	$capability, 
	$menu_slug, 
	$callback, 
	$position 
);

add_action( "load-{$hookname}", 'my_admin_load' );

function my_admin_load(){
	// do staff
}

Заметки

• Global. Массив. $submenu
• Global. Массив. $menu
• Global. Массив. $_wp_real_parent_file
• Global. true|false. $_wp_submenu_nopriv
• Global. Массив. $_registered_pages
• Global. Массив. $_parent_pages

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

Код add_submenu_page() add submenu page ^{WP 6.5.2}

function add_submenu_page( $parent_slug, $page_title, $menu_title, $capability, $menu_slug, $callback = '', $position = null ) {
	global $submenu, $menu, $_wp_real_parent_file, $_wp_submenu_nopriv,
		$_registered_pages, $_parent_pages;

	$menu_slug   = plugin_basename( $menu_slug );
	$parent_slug = plugin_basename( $parent_slug );

	if ( isset( $_wp_real_parent_file[ $parent_slug ] ) ) {
		$parent_slug = $_wp_real_parent_file[ $parent_slug ];
	}

	if ( ! current_user_can( $capability ) ) {
		$_wp_submenu_nopriv[ $parent_slug ][ $menu_slug ] = true;
		return false;
	}

	/*
	 * If the parent doesn't already have a submenu, add a link to the parent
	 * as the first item in the submenu. If the submenu file is the same as the
	 * parent file someone is trying to link back to the parent manually. In
	 * this case, don't automatically add a link back to avoid duplication.
	 */
	if ( ! isset( $submenu[ $parent_slug ] ) && $menu_slug !== $parent_slug ) {
		foreach ( (array) $menu as $parent_menu ) {
			if ( $parent_menu[2] === $parent_slug && current_user_can( $parent_menu[1] ) ) {
				$submenu[ $parent_slug ][] = array_slice( $parent_menu, 0, 4 );
			}
		}
	}

	$new_sub_menu = array( $menu_title, $capability, $menu_slug, $page_title );

	if ( null !== $position && ! is_numeric( $position ) ) {
		_doing_it_wrong(
			__FUNCTION__,
			sprintf(
				/* translators: %s: add_submenu_page() */
				__( 'The seventh parameter passed to %s should be numeric representing menu position.' ),
				'<code>add_submenu_page()</code>'
			),
			'5.3.0'
		);
		$position = null;
	}

	if (
		null === $position ||
		( ! isset( $submenu[ $parent_slug ] ) || $position >= count( $submenu[ $parent_slug ] ) )
	) {
		$submenu[ $parent_slug ][] = $new_sub_menu;
	} else {
		// Test for a negative position.
		$position = max( $position, 0 );
		if ( 0 === $position ) {
			// For negative or `0` positions, prepend the submenu.
			array_unshift( $submenu[ $parent_slug ], $new_sub_menu );
		} else {
			$position = absint( $position );
			// Grab all of the items before the insertion point.
			$before_items = array_slice( $submenu[ $parent_slug ], 0, $position, true );
			// Grab all of the items after the insertion point.
			$after_items = array_slice( $submenu[ $parent_slug ], $position, null, true );
			// Add the new item.
			$before_items[] = $new_sub_menu;
			// Merge the items.
			$submenu[ $parent_slug ] = array_merge( $before_items, $after_items );
		}
	}

	// Sort the parent array.
	ksort( $submenu[ $parent_slug ] );

	$hookname = get_plugin_page_hookname( $menu_slug, $parent_slug );
	if ( ! empty( $callback ) && ! empty( $hookname ) ) {
		add_action( $hookname, $callback );
	}

	$_registered_pages[ $hookname ] = true;

	/*
	 * Backward-compatibility for plugins using add_management_page().
	 * See wp-admin/admin.php for redirect from edit.php to tools.php.
	 */
	if ( 'tools.php' === $parent_slug ) {
		$_registered_pages[ get_plugin_page_hookname( $menu_slug, 'edit.php' ) ] = true;
	}

	// No parent as top level.
	$_parent_pages[ $menu_slug ] = $parent_slug;

	return $hookname;
}

Cвязанные функции

Меню администрирования (admin menu)

Админ-панель