add_dashboard_page函数用于向WordPress后台的管理面板中添加自定义菜单项。

函数的语法为:

add_dashboard_page( $page_title, $menu_title, $capability, $menu_slug, $function );

参数说明如下:

- $page_title :(string) 自定义页面的标题。
- $menu_title :(string) 菜单项的显示名称。
- $capability :(string) 用户权限要求。只有具有该权限的用户才能看到该菜单项。
- $menu_slug :(string) 菜单项的唯一标识符,用于区分不同的菜单项。
- $function :(callable) 菜单项被点击时调用的函数。

使用示例:

add_action( 'admin_menu', 'add_custom_dashboard_page' );

function add_custom_dashboard_page() {
add_dashboard_page(
'Custom Dashboard Page', // 页面标题
'Custom Dashboard', // 菜单项显示名称
'manage_options', // 用户权限要求
'custom-dashboard', // 菜单项唯一标识符
'custom_dashboard_content' // 菜单项被点击时调用的函数
);
}

function custom_dashboard_content() {
echo '

Welcome to Custom Dashboard Page

';
}

在上面的示例中,我们使用add_action函数将add_custom_dashboard_page函数添加到admin_menu动作钩子上。当后台管理面板加载时,该函数将被调用。

add_custom_dashboard_page函数中使用add_dashboard_page函数向管理面板中添加一个自定义菜单项。我们指定了菜单项的页面标题、菜单项显示名称、用户权限要求、菜单项唯一标识符和菜单项被点击时调用的函数。

最后,custom_dashboard_content函数中定义了菜单项被点击时要显示的内容。在本例中,我们简单地输出了一个标题"Welcome to Custom Dashboard Page"。