WordPress功能函数add_pages_page()
wordpress功能函数add_pages_page(),在页面主菜单中添加子菜单页。
用法:
add_pages_page( string $page_title, string $menu_title, string $capability, string $menu_slug, callable $function = '', int $position = null )
描述
该函数具有一种功能,用于确定菜单中是否包含某个页面。
用于处理页面输出的函数也必须检查用户是否具备所需的功能。
参数:
$page_title
(string) (必需) 选中菜单时要在页面标题标签中显示的文本。
$menu_title
(string) (必需) 要用于菜单的文本。
$capability
(string) (必需) 向用户显示该菜单所需的功能。
$menu_slug
(string) (必需) 用来引用这个菜单的slug名称(对于这个菜单应该是唯一的)。
$function
(callable) (可选) 用于输出此页面内容的函数。
默认值: ''
$position
(int) (可选) 该项目应出现在菜单顺序中的位置。
默认值: null
返回
(string|false)结果页面的hook_suffix,如果用户不具备所需的能力则为false。
更多信息
如果你正在运行»你没有足够的权限访问这个页面。«wp_die()屏幕中的消息,那么您已经过早地钩住了。你应该使用的钩子是admin_menu。
这个函数是一个简单的包装器,用于调用add_submenu_page(),传递接收到的参数并指定' edit.php?post_type=page '作为$parent_slug参数。这意味着新页面将作为子菜单添加到“Pages”菜单中。
来源:
文件: wp-admin/includes/plugin.php
function add_pages_page( $page_title, $menu_title, $capability, $menu_slug, $function = '', $position = null ) {
return add_submenu_page( 'edit.php?post_type=page', $page_title, $menu_title, $capability, $menu_slug, $function, $position );
}
更新日志:
用户贡献的笔记:
(由Codex - 5年前贡献)
例子
典型用法出现在注册了' admin_menu '钩子的函数中(参见添加管理菜单):
function wpdocs_my_plugin_menu() {
add_pages_page( __( 'My Plugin Pages', 'textdomain' ), __( 'My Plugin','textdomain' ), 'read', 'my-unique-identifier', 'my_plugin_function');
}
add_action( 'admin_menu', 'wpdocs_my_plugin_menu' );