WordPress函数：add_submenu_page 在后台菜单增加子菜单

在WordPress后台侧边栏增加子菜单，需要用到 add_submenu_page 函数。

函数原型：

add_submenu_page( string $parent_slug, string $page_title, string $menu_title, string $capability, string $menu_slug, callable $callback = '', int|float $position = null )

参数简介：

$parent_slug (string) (必须的) 父菜单项标志.

$page_title (string) (必须的) 页面标题.

$menu_title (string) (必须的) 菜单项名称.

$capability (string) (必须的) 规定查看此菜单项，需要的用户权限.

$menu_slug (string) (必须的) 菜单唯一标志，会在链接中显示。可以使用小写字母、数字、破折号和下划线。

$callback (callable) (可选的) 菜单项对应的渲染内容. 默认: ''

$position (int|float) (可选的) 在父菜单的位置. 默认: null

特别说明一下参数 $parent_slug，可以是WordPress系统本身的菜单项，也可以是用户自定义的菜单项。

WordPress本身的菜单项包括：

仪表盘: ‘index.php’

文章: ‘edit.php’

媒体: ‘upload.php’

页面: ‘edit.php?post_type=page’

评论: ‘edit-comments.php’

外观: ‘themes.php’

插件: ‘plugins.php’

用户: ‘users.php’

工具: ‘tools.php’

设置: ‘options-general.php’

网络设置: ‘settings.php’

使用举例：

add_action('admin_menu', 'zhuige_register_my_custom_submenu_page');
 
function zhuige_register_my_custom_submenu_page() {
    add_submenu_page(
        'tools.php',
        'My Custom Submenu Page',
        'My Custom Submenu Page',
        'manage_options',
        'my-custom-submenu-page',
        'zhuige_my_custom_submenu_page_callback' );
}
 
function zhuige_my_custom_submenu_page_callback() {
    echo '<div class="wrap"><div id="icon-tools" class="icon32"></div>';
        echo '<h2>My Custom Submenu Page</h2>';
    echo '</div>';
}

WordPress 还提供了一些语法糖函数，例如：

仪表盘下添加子菜单：add_dashboard_page

文章下添加子菜单：add_posts_page

媒体下添加子菜单：add_media_page

页面下添加子菜单：add_pages_page

评论下添加子菜单：add_comments_page

外观下添加子菜单：add_theme_page

插件下添加子菜单：add_plugins_page

用户下添加子菜单：add_users_page

设置下添加子菜单：add_options_page