Question

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

在链接主菜单的下面添加一个子页面。

---

description

这个函数需要一个功能，用于决定菜单中是否包含页面。连接到处理页面输出的函数必须检查用户是否具有所需的用户权限。

---

参数

$page_title

(string)
(Required)
当菜单被选中时将显示在页面标题标签中的文本。

$menu_title

(string)
(Required)
用于菜单的文本。

$capability

(string)
(Required)
将此菜单显示给用户所需的权限。

$menu_slug

(string)
(Required)
此菜单在浏览器地址中的唯一标识符，不能和现有的重复。

$function

(callable)
(Optional)
要为该页输出内容的函数。
Default value: ''

---

返回值

(false|string) 成功返回页面的 hook_suffix，回调函数将输出的内容，错误返回 false ，可能是用户没有权限访问。

---

源代码

File: wp-admin/includes/plugin.php

function add_links_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
	return add_submenu_page( 'link-manager.php', $page_title, $menu_title, $capability, $menu_slug, $function );
}

---

相关函数

Uses

• wp-admin/includes/plugin.php:add_submenu_page()

---

用法举例

典型的使用，挂着到 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' );