WordPress函数文档add_pages_page()
在后台管理界面的“页面”菜单下增加二级菜单 描述 Add sub menu page to the Pages…
在后台管理界面的“页面”菜单下增加二级菜单
描述
Add sub menu page to the Pages menu.
NOTE: If you’re running into the »You do not have sufficient permissions to access this page.« message in a wp_die()
screen, then you’ve hooked too early. The hook you should use is admin_menu
.
用法
<?php
add_pages_page( $page_title, $menu_title, $capability, $menu_slug, $function);
?>
参数
$page_title
(string) (必填) The text to be displayed in the title tags of the page when the menu is selected
默认值: None
$menu_title
(string) (必填) The text to be used for the menu
默认值: None
$capability
(string) (必填) The capability required for this menu to be displayed to the user.
默认值: None
$menu_slug
(string) (必填) The slug name to refer to this menu by (should be unique for this menu).
默认值: None
$function
(callback) (可选) The function to be called to output the content for this page.
默认值: ‘ ‘
返回值
string
The resulting page’s hook_suffix (What add_submenu_page() returns)
注意
- This function is a simple wrapper for a call to add_submenu_page(), passing the received arguments and specifying ‘edit.php?post_type=page’ as the $parent_slug argument. This means the new page will be added as a sub menu to the Pages menu.
- The $capability parameter is used to determine whether or not the page is included in the menu based on the Roles and Capabilities) of the current user.
- The function handling the output of the options page should also verify the user’s capabilities.
源文件
add_pages_page() 函数的代码位于 wp-admin/includes/plugin.php
.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
|
/* ———————————-
* wordpress函数 kim收集
* ———————————- */
/**
* Add sub menu page to the pages main menu.
*
* This function takes a capability which will be used to determine whether
* or not a page is included in the menu.
*
* The function which is hooked in to handle the output of the page must check
* that the user has the required capability as well.
*
* @param string $page_title The text to be displayed in the title tags of the page when the menu is selected
* @param string $menu_title The text to be used for the menu
* @param string $capability The capability required for this menu to be displayed to the user.
* @param string $menu_slug The slug name to refer to this menu by (should be unique for this menu)
* @param callback $function The function to be called to output the content for this page.
*
* @return false|string The resulting page’s hook_suffix, or false if the user does not have the capability required.
*/
function add_pages_page( $page_title, $menu_title, $capability, $menu_slug, $function = ” ) {
return add_submenu_page( ‘edit.php?post_type=page’, $page_title, $menu_title, $capability, $menu_slug, $function );
}
|
- 原文:http://codex.wordpress.org/Function_Reference/add_pages_page
本文收集自互联网,转载请注明来源。
如有侵权,请联系 wper_net@163.com 删除。
评论功能已经关闭!