WordPress功能函数add_**nagement_page(),在工具主菜单中添加子菜单页。
用法:
add_**nagement_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) (必需) 用来引用这个菜单的名称(对于这个菜单应该是唯一的)。
$function
(callable) (可选) 用于输出此页面内容的函数。
默认值: ”
$position
(int) (可选) The position in the menu order this item should appear.
默认值: null
返回
(string|false) 结果页面的hook_suffix,如果用户不具备所需的能力,则为false。
更多信息:
例子:
add_**nagement_page(‘Cus*** per**linkks ‘, ‘Cus*** per**linkks ‘, ‘**nage_options’, ‘my-unique-identifier’, ‘cus***_per**links_options_page’);
注:
如果你正在运行»你没有足够的权限访问这个页面。“wp_***()”屏幕中的消息,那么你太早上钩了。你应该使用的钩子是’ admin_menu ‘。
来源:
文件: wp-admin/includes/plugin.php
function add_**nagement_page( $page_title, $menu_title, $capability, $menu_slug, $function = ”, $position = null ) {
return add_submenu_page( ‘tools.php’, $page_title, $menu_title, $capability, $menu_slug, $function, $position );
}
更新日志:
用户贡献的笔记
(由David Brumbaugh贡献- 5年前)
使用实例添加工具页面。
class MyWPTool {
function __construct() {
add_action( ‘admin_menu’, array( $this, ‘admin_menu’ ) );
}
function admin_menu() {
$hook = add_**nagement_page( ‘My WP Tool Page’, ‘My WP Tool’, ‘install_plugins’, ‘mywptool’, array( $this, ‘admin_page’ ), ” );
add_action( “load-$hook”, array( $this, ‘admin_page_load’ ) );
}
function admin_page_load() {
// …
}
function admin_page() {
// …
}
}
(由jakubd贡献- 2年前)
// Ex**ple
add_action (‘admin_menu’, function () {
add_**nagement_page(‘Some page title’, ‘Title in the menu’, ‘install_plugins’, ‘some_unique_string’, ‘my_cus***_page_render_function’, ”);
});
function my_cus***_page_render_function()
{
echo ‘This is content of the page’;
}
暂无评论内容