WordPress开发函数add_links_page()

WordPress开发函数add_links_page()

214
2021-03-22 16:09:13

WordPress开发函数add_links_page(),添加子菜单页到链接主菜单。

用法:

add_links_page( string $page_title, string $menu_title, string $capability, string $menu_slug, callable $function = '', int $position = null )

描述:

该函数具有一种功能,用于确定菜单中是否包含某个页面。

用于处理页面输出的函数也必须检查用户是否具备所需的功能。

参数:

$page_title

(string) (必需) 选中菜单时要在页面标题标签中显示的文本。

$menu_title

(string) (必需) 要用于菜单的文本。

$capability

(string) (必需) 向用户显示该菜单所需的功能。

$menu_slug

(string) (必需) 用来引用这个菜单的名称(对于这个菜单应该是唯一的)。

$function

(callable) (可选) 用于输出此页面内容的函数。

默认值: ''

$position

(int) (可选) 该项目应出现在菜单顺序中的位置。

默认值: null

返回:

(string|false) 结果页面的hook_suffix,如果用户不具备所需的能力,则为false。

更多信息

  • 如果你正在运行»你没有足够的权限访问这个页面。«wp_die()屏幕中的消息,那么您已经过早地钩住了。你应该使用的钩子是admin_menu。
  • 这个函数是一个对add_submenu_page()调用的简单包装器,它传递接收到的参数并指定' link-manager '。php '作为$parent_slug参数。这意味着新页面将作为一个子菜单添加到链接菜单中。
  • $capability参数用于根据当前用户的角色和功能确定该页面是否包含在菜单中。
  • 处理options页面输出的函数还应该验证用户的能力。

来源:

文件: wp-admin/includes/plugin.php

function add_links_page( $page_title, $menu_title, $capability, $menu_slug, $function = '', $position = null ) {

return add_submenu_page( 'link-manager.php', $page_title, $menu_title, $capability, $menu_slug, $function, $position );

}

更新日志:
WordPress开发函数add_links_page() (https://www.wpmee.com/) WordPress开发教程 第1张
用户贡献的笔记

(由Codex - 5年前贡献)

例子

典型用法出现在注册了' admin_menu '钩子的函数中(参见添加管理菜单):

function wpdocs_my_plugin_menu() {

add_links_page( __( 'My Plugin Links', 'textdomain' ), __( 'My Plugin', 'textdomain' ), 'read', 'my-unique-identifier', 'my_plugin_function' );

}

add_action( 'admin_menu', 'wpdocs_my_plugin_menu' );

喜欢这个文章就点个赞分享给好友吧~

END

发表评论

一次支付终身使用
免费版本更新
靠谱的技术支持
成为会员