Question

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

在多媒体菜单下面添加一个子页面。

---

description

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

---

参数

$page_title

(string)
(Required)
The text to be displayed in the title tags of the page when the menu is selected.

$menu_title

(string)
(Required)
The text to be used for the menu.

$capability

(string)
(Required)
The capability required for this menu to be displayed to the user.

$menu_slug

(string)
(Required)
The slug name to refer to this menu by (should be unique for this menu).

$function

(callable)
(Optional)
The function to be called to output the content for this page.Default value: ''

---

返回值

(false|string) The resulting page's hook_suffix, or false if the user does not have the capability required.

---

源代码

File: wp-admin/includes/plugin.php

function add_media_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
	return add_submenu_page( 'upload.php', $page_title, $menu_title, $capability, $menu_slug, $function );
}

---

相关函数

Uses

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

---

使用举例

Typical usage occurs in a function registered with the ‘admin_menu’ hook (see Adding Administration Menus):

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