首页 > 主题开发 > 开发入门 > wordpress二级页面菜单后台插入函数-add_submenu_page()
2019
06-27

wordpress二级页面菜单后台插入函数-add_submenu_page()

简介

使用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,新建的二级菜单,是属于哪个顶级菜单的。

  1. 在仪表盘添加子菜单: add_submenu_page( ‘index.php’, … );
  2. 在文章处添加子菜单: add_submenu_page( ‘edit.php’, … );
  3. 在媒体处添加子菜单: add_submenu_page( ‘upload.php’, … );
  4. 在链接处添加子菜单: add_submenu_page( ‘link-manager.php’, … );
  5. 在页面处添加子菜单: add_submenu_page( ‘edit.php?post_type=page’, … );
  6. 在评论处添加子菜单: add_submenu_page( ‘edit-comments.php’, … );
  7. 在你自定义文章类型处添加子菜单: add_submenu_page(‘edit.php?post_type=your_post_type’,…)
  8. 在外观处添加子菜单: add_submenu_page( ‘themes.php’, … );
  9. 在插件处添加子菜单: add_submenu_page( ‘plugins.php’, … );
  10. 在用户处添加子菜单: add_submenu_page( ‘users.php’, … );
  11. 在工具处添加子菜单: add_submenu_page( ‘tools.php’, … );
  12. 在设置处添加子菜单: 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');

 

最后编辑:
作者:MrBang
WordPress迷

留下一个回复