add_dashboard_page( string $page_title, string $menu_title, string $capability, string $menu_slug, callable $callback = '', int $position = null ): string|false

将子菜单页面添加到仪表板主菜单。

描述

该函数具有用于确定页面是否包含在菜单中的功能。

用于处理页面输出的函数必须检查用户是否也具有所需的能力。

参数

$page_title string 必需
选择菜单时要在页面标题标签中显示的文本。

$menu_title string 必需
用于菜单的文本。

$capability string 必需
向用户显示此菜单所需的能力。

$menu_slug string 必需
引用此菜单的 slug 名称(对于此菜单应该是唯一的)。

$callback 可调用 可选
要调用以输出此页面的内容的函数。
默认: ”

$position int 可选
此项目应出现在菜单顺序中的位置。
默认值:null

返回

string|false 结果页面的 hook_suffix,如果用户没有所需的能力,则返回 false。

用户贡献的笔记

典型用法发生在使用“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');