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');
评论已关闭