WordPress开发函数add_plugins_page()

WordPress开发函数add_plugins_page()

173
2021-03-24 13:49:33

WordPress开发函数add_plugins_page(),在插件主菜单中添加子菜单页。

用法:

add_plugins_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) (必需) 用来引用这个菜单的slug名称(对于这个菜单应该是唯一的)。

$function

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

默认值: ''

$position

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

默认值: null

返回

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

更多信息

这个函数是一个简单的包装器,用于调用add_submenu_page(),传递接收到的参数并指定'plugins '。php'作为$parent_slug参数。这意味着新页面将被添加为插件菜单的子菜单。

来源:

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

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

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

}

更新日志:
WordPress开发函数add_plugins_page() (https://www.wpmee.com/) WordPress开发教程 第1张
增加了$position参数。

(由Codex - 6年前贡献)

基本插件页面示例

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

/**

* Add a plugin page.

*/

function wpdocs_plugin_menu() {

add_plugins_page(

__( 'WPDocs Plugin Page', 'textdomain' ),

__( 'WPDocs Plugin', 'textdomain' ),

'read',

'wpdocs-unique-identifier',

'wpdocs_plugin_function'

);

}

add_action( 'admin_menu', 'wpdocs_plugin_menu' );

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

END

发表评论

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