子菜单

要向WordPress管理添加新的子菜单，请使用add_submenu_page()函数。

add_submenu_page(
	string $parent_slug,
	string $page_title,
	string $menu_title,
	string $capability,
	string $menu_slug,
	callable $function = ''
);

实例

假设我们想在“工具”顶级菜单中添加一个子菜单“WPOrg Options”。

第一步将创建一个输出HTML的函数。在这个函数中，我们将执行必要的安全检查，并呈现使用设置API注册的选项。

我们建议使用<div>和wrap类包装HTML。

function wporg_options_page_html() {
	// check user capabilities
	if ( ! current_user_can( 'manage_options' ) ) {
		return;
	}
	?>
	<div class="wrap">
		<h1><?php echo esc_html( get_admin_page_title() ); ?></h1>
		<form action="options.php" method="post">
			<?php
			// output security fields for the registered setting "wporg_options"
			settings_fields( 'wporg_options' );
			// output setting sections and their fields
			// (sections are registered for "wporg", each field is registered to a specific section)
			do_settings_sections( 'wporg' );
			// output save settings button
			submit_button( __( 'Save Settings', 'textdomain' ) );
			?>
		</form>
	</div>
	<?php
}

第二步将注册我们的WPOrg Options子菜单。注册需要在admin_menu操作挂钩期间进行。

function wporg_options_page()
{
	add_submenu_page(
		'tools.php',
		'WPOrg Options',
		'WPOrg Options',
		'manage_options',
		'wporg',
		'wporg_options_page_html'
	);
}
add_action('admin_menu', 'wporg_options_page');

有关参数列表以及每个参数的作用，请参阅参考资料中的add_submenu_page()。

预定义的子菜单

如果我们有辅助函数来定义WordPress内置顶级菜单的$parent_slug，并避免我们在源代码中手动搜索它，那不是很好吗？

下面是父级slug及其辅助函数的列表：

add_dashboard_page() – index.php
add_posts_page() – edit.php
add_media_page() – upload.php
add_pages_page() – edit.php?post_type=page
add_comments_page() – edit-comments.php
add_theme_page() – themes.php
add_plugins_page() – plugins.php
add_users_page() – users.php
add_management_page() – tools.php
add_options_page() – options-general.php
add_options_page() – settings.php
add_links_page() – link-manager.php – 自WP 3.5+需要一个插件
自定义文章类型 – edit.php?post_type=wporg_post_type
网络管理员 – settings.php

删除子菜单的过程与删除顶级菜单的过程完全相同。

提交表单

在子菜单中处理表单提交的过程与在顶级菜单中提交表单的过程完全相同。

add_submenu_page()以及预定义子菜单的所有函数（add_dashboard_page、add_posts_page等）将返回一个$hookname，您可以将其用作add_action的第一个参数，以便处理自定义页面中表单的提交：

function wporg_options_page() {
	$hookname = add_submenu_page(
		'tools.php',
		'WPOrg Options',
		'WPOrg Options',
		'manage_options',
		'wporg',
		'wporg_options_page_html'
	);

	add_action( 'load-' . $hookname, 'wporg_options_page_html_submit' );
}

add_action('admin_menu', 'wporg_options_page');

一如既往，不要忘记检查表单是否正在提交，进行CSRF验证、数据验证和清理。

添加子菜单

实例

预定义的子菜单

删除子菜单

提交表单