wordpress功能函數(shù)add_pages_page()，在頁(yè)面主菜單中添加子菜單頁(yè)。

用法：

add_pages_page( string $page_title, string $menu_title, string $capability, string $menu_slug, callable $function = '', int $position = null )

描述

該函數(shù)具有一種功能，用于確定菜單中是否包含某個(gè)頁(yè)面。

用于處理頁(yè)面輸出的函數(shù)也必須檢查用戶是否具備所需的功能。

參數(shù)：

$page_title

(string) (必需) 選中菜單時(shí)要在頁(yè)面標(biāo)題標(biāo)簽中顯示的文本。

$menu_title

(string) (必需) 要用于菜單的文本。

$capability

(string) (必需) 向用戶顯示該菜單所需的功能。

$menu_slug

(string) (必需) 用來(lái)引用這個(gè)菜單的slug名稱(對(duì)于這個(gè)菜單應(yīng)該是唯一的)。

$function

(callable) (可選) 用于輸出此頁(yè)面內(nèi)容的函數(shù)。

默認(rèn)值: ''

$position

(int) (可選) 該項(xiàng)目應(yīng)出現(xiàn)在菜單順序中的位置。

默認(rèn)值: null

返回

(string|false)結(jié)果頁(yè)面的hook_suffix，如果用戶不具備所需的能力則為false。

更多信息

如果你正在運(yùn)行?你沒(méi)有足夠的權(quán)限訪問(wèn)這個(gè)頁(yè)面。?wp_die()屏幕中的消息，那么您已經(jīng)過(guò)早地鉤住了。你應(yīng)該使用的鉤子是admin_menu。

這個(gè)函數(shù)是一個(gè)簡(jiǎn)單的包裝器，用于調(diào)用add_submenu_page()，傳遞接收到的參數(shù)并指定' edit.php?post_type=page '作為$parent_slug參數(shù)。這意味著新頁(yè)面將作為子菜單添加到“Pages”菜單中。

來(lái)源：

文件: 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 );

}

更新日志：

用戶貢獻(xiàn)的筆記：

（由Codex - 5年前貢獻(xiàn)）

例子

典型用法出現(xiàn)在注冊(cè)了' admin_menu '鉤子的函數(shù)中(參見(jiàn)添加管理菜單):

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' );