media_add.php,wordpress函数add_media_page()用法示例

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

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

描述

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

参数

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