Question

add_dashboard_page( string $page_title,  string $menu_title,  string $capability,  string $menu_slug,  callable $function = '' )

在仪表盘的菜单下面添加一个子菜单。

---

description

这个函数需要一个功能，用于决定菜单中是否包含页面，连接到处理页面输出的函数必须检查用户是否具有所需的用户权限。

---

参数

$page_title

(string)
(Required)
当菜单被选中时将显示在页面标题标签中的文本。

$menu_title

(string)
(Required)
用于菜单的文本。

$capability

(string)
(Required)
拥有哪些权限的用户可以看到和使用这个菜单。

$menu_slug

(string)
(Required)
要引用此菜单的名称（应该是此菜单的唯一）。

$function

(callable)
(Optional)
要为该页输出内容的函数。Default value: ''

---

返回值

(false|string) 成功返回页面的 hook_suffix，错误返回 false ，一般是用户没有权限。

---

源代码

File: wp-admin/includes/plugin.php

function add_dashboard_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
	return add_submenu_page( 'index.php', $page_title, $menu_title, $capability, $menu_slug, $function );
}

---

相关函数

Uses

• wp-admin/includes/plugin.php:add_submenu_page()

---

用法举例

典型的使用，在 admin_menu 钩子上面注册一个函数。

/**
 * Add a page to the dashboard menu.
 */
function wpdocs_plugin_menu() {
	add_dashboard_page( __( 'WPDocs Plugin Dashboard', 'textdomain' ), __( 'WPDocs Plugin', 'textdomain' ), 'read', 'wpdocs-unique-identifier', 'wpdocs_plugin_function' );
}
add_action('admin_menu', 'wpdocs_plugin_menu');