简介
使用add_submenu_page()函数可以让我们在开发WordPress主题或者插件的时候更具方便的在后插入二级菜单，比如在后台设置菜单下面插入一个二级菜单某某某设置。
用法
- add_submenu_page(
- string $parent_slug,
- string $page_title,
- string $menu_title,
- string $capability,
- string $menu_slug,
- callable $function = ''
- )
参数
- $parent_slug
【必填】
该参数处，填写的是二级菜单所属的顶级菜单的别名，用于告诉wordpress，新建的二级菜单，是属于哪个顶级菜单的。
- 在仪表盘添加子菜单: add_submenu_page( 'index.php', … );
- 在文章处添加子菜单: add_submenu_page( 'edit.php', … );
- 在媒体处添加子菜单: add_submenu_page( 'upload.php', … );
- 在链接处添加子菜单: add_submenu_page( 'link-manager.php', … );
- 在页面处添加子菜单: add_submenu_page( 'edit.php?post_type=page', … );
- 在评论处添加子菜单: add_submenu_page( 'edit-comments.php', … );
- 在你自定义文章类型处添加子菜单: add_submenu_page('edit.php?post_type=your_post_type',…)
- 在外观处添加子菜单: add_submenu_page( 'themes.php', … );
- 在插件处添加子菜单: add_submenu_page( 'plugins.php', … );
- 在用户处添加子菜单: add_submenu_page( 'users.php', … );
- 在工具处添加子菜单: add_submenu_page( 'tools.php', … );
- 在设置处添加子菜单: add_submenu_page( 'options-general.php', … );
- $page_title
【必填】
该参数的作用是，设置新建的菜单页面的标题。
- $menu_title
【必填】
限制用户必须具备什么样的权限，才会在后台显示出新创建的菜单。
- $menu_slug
【必填】
该参数，设置的是新建的二级菜单的名称（或标题）
- $capability
【必填】
该参数的作用是，告诉wordpress，用户必须具备什么权限，才在后台的菜单列表中显示新建的菜单。
- $menu_slug
【必填】
menu_slug是菜单别名的意思，通过此参数，可以给创建的菜单起一个独一无二的名称，用于区分不同的菜单页面。
- $function
【可选】
该参数的作用是，告诉wordpress，当用户点击新建的二级菜单，用户看到的内容是哪个函数的输出结果。
实例
- function my_add_submenu() {
- add_submenu_page( 'tools.php', 'my_backup', '备份', 'manage_options', 'backup-page', 'my_magic_function');
- }
- // 用于显示菜单的内容，填写菜单页面的HTML代码即可
- function my_magic_function() {
- echo ' 这里填菜单页面的HTML代码 ';
- // echo '
- // <div class="wrap">
- // <h2>备份</h2>
- // <p>这里可以备份你的博客数据库。</a></p>
- // </div>
- // ';
- }
- // 通过add_action来自动调用my_add_submenu函数
- add_action('admin_menu', 'my_add_submenu');
