WordPress開發(fā)函數(shù)add_media_page()，在媒體主菜單中添加子菜單頁面。

用法：

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

描述：

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

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

參數(shù)：

$page_title

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

$menu_title

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

$capability

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

$menu_slug

(string) (必需) 用來引用這個菜單的蛞蝓名稱(對于這個菜單應(yīng)該是唯一的)。

$function

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

默認值: ''

$position

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

默認值: null

返回

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

更多信息：

用法:

add_media_page($page_title， $menu_title， $capability， $menu_slug， $function);

注:

• 如果你正在運行?你沒有足夠的權(quán)限訪問這個頁面。?wp_die()屏幕中的消息，那么您已經(jīng)過早地鉤住了。你應(yīng)該使用的鉤子是admin_menu。
• 這個函數(shù)是一個簡單的包裝器，用于調(diào)用add_submenu_page()，傳遞接收到的參數(shù)并指定' upload '。php '作為$parent_slug參數(shù)。這意味著新頁面將被添加為媒體菜單的子菜單。
• $capability參數(shù)用于根據(jù)當(dāng)前用戶的角色和功能確定該頁面是否包含在菜單中。
• 處理options頁面輸出的函數(shù)還應(yīng)該驗證用戶的能力。

來源:

文件: wp-admin/includes/plugin.php

function add_media_page( $page_title, $menu_title, $capability, $menu_slug, $function = '', $position = null ) {

return add_submenu_page( 'upload.php', $page_title, $menu_title, $capability, $menu_slug, $function, $position );

}

更新日志：

用戶貢獻的筆記

（由Codex - 5年前貢獻）

例子

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

function wpdocs_my_plugin_menu() {

add_media_page(

__( 'My Plugin Media', 'textdomain' ),

__( 'My Plugin', 'textdomain' ),

'read',

'my-unique-identifier',

'wpdocs_my_plugin_function'

);

}

add_action('admin_menu', 'wpdocs_my_plugin_menu');