wordpress函数add_management_page()用法示例

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

在工具菜单下面添加一个子页面。

描述

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

参数

$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_management_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
	return add_submenu_page( 'tools.php', $page_title, $menu_title, $capability, $menu_slug, $function );
}

相关函数

Uses

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

使用举例

在工具菜单下面添加一个子页面

class MyWPTool {
	function __construct() {
		   add_action( 'admin_menu', array( $this, 'admin_menu' ) );
	}

	function admin_menu() {
		   $hook = add_management_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() {
		// ...
	}
}