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() {
	// контент сторінки
	echo '<div class="wrap">';
		echo '<h2>'. get_admin_page_title() .'</h2>';
	echo '</div>';

}

// Ховаємо сторінку з меню, але вона все одно буде робочою
add_action('admin_menu', 'register_my_custom_submenu_page');
function register_my_custom_submenu_page(){
	add_submenu_page(
		null, //or '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'
	);
}

нотатки

• 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.0.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;
	}

	/*
	 * Якщо 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 деякий is trying до link back to the parent manually. In
	 * Це означає, що не автоматично придбає 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 ] ) ) ||
	) {
		$submenu[ $parent_slug ][] = $new_sub_menu;
	} else {
		// Test for a negative position.
		$ position = max ($ position, 0);
		if ( 0 === $position ) {
			// Для negative or `0` positions, prepend the submenu.
			array_unshift( $submenu [ $parent_slug ], $ new_sub_menu );
		} else {
			// 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;
}

Зв’язані функції

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