add_media_page是WordPress提供的一个函数,用于在后台管理界面的“媒体”菜单下添加一个子菜单页面。该函数的详细用法如下:

1. 函数原型:add_media_page( string $page_title, string $menu_title, string $capability, string $menu_slug, callable $function = '' )
- $page_title(必填):子菜单页面的标题。
- $menu_title(必填):在“媒体”菜单中显示的菜单标题。
- $capability(必填):访问该子菜单页面所需的用户权限。
- $menu_slug(必填):子菜单页面的URL。
- $function(可选):子菜单页面的回调函数,用于显示页面内容。

2. 示例代码:

function my_media_page() {
// 在子菜单页面中显示的内容
echo '

欢迎访问我的媒体页面

';
}

add_action( 'admin_menu', 'register_my_media_page' );

function register_my_media_page() {
// 在“媒体”菜单下添加子菜单页面
add_media_page( '我的媒体页面', '我的媒体', 'manage_options', 'my-media-page', 'my_media_page' );
}

在上述示例中,我们首先定义了一个回调函数my_media_page(),用于在子菜单页面中显示内容。然后使用add_action()函数将函数register_my_media_page()与动作admin_menu关联起来,当后台管理界面加载时,会调用该函数。register_my_media_page()函数中,我们使用add_media_page()函数在“媒体”菜单下添加了一个子菜单页面,指定了页面的标题、菜单标题、用户权限和URL,同时指定回调函数为my_media_page(),用于显示页面内容。

注意事项:
- 在调用add_media_page()函数之前,必须在后台管理界面加载时调用add_action()函数,将函数register_my_media_page()与admin_menu动作关联起来,以确保子菜单页面能够正确添加到“媒体”菜单下。
- 用户权限参数($capability)决定了哪些用户具有访问和操作该子菜单页面的权限。通常使用经过预定义的角色名称,如'manage_options'(拥有管理员权限的用户)。
- 通过回调函数参数($function)可以自定义子菜单页面的内容和功能。你可以在回调函数中使用HTML、CSS、JavaScript等来自定义页面的显示和操作。