add_plugins_page函数是WordPress的一个核心函数,用于在后台管理界面中添加一个“插件”菜单页面。该函数的用法如下:

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

参数说明:
- $page_title:(必需)插件页面的标题。
- $menu_title:(必需)在左侧菜单中显示的菜单标题。
- $capability:(必需)用户需要具备的权限才能查看该页面。可以使用WordPress的内置权限级别,如‘manage_options’。
- $menu_slug:(必需)菜单页面的唯一标识符。该标识符用于在代码中引用该页面。
- $function:(可选)在菜单页面上显示的内容的回调函数。如果不提供此参数,则只会在菜单页面上显示标题。

使用示例:

function my_plugin_menu_page(){
// 在菜单页面上显示的内容
echo "

Welcome to my plugin

";
}

function my_plugin_menu(){
// 添加一个插件菜单页面
add_plugins_page('My Plugin', 'My Plugin', 'manage_options', 'my-plugin', 'my_plugin_menu_page');
}

// 在admin_menu钩子上调用my_plugin_menu函数
add_action('admin_menu', 'my_plugin_menu');

在上面的示例中,首先定义了一个名为`my_plugin_menu_page`的函数,用于在插件菜单页面上显示内容(这里只是一个简单的标题)。然后定义了一个名为`my_plugin_menu`的函数,用于添加插件菜单页面。在`add_plugins_page`函数中,指定了页面的标题为“My Plugin”,菜单标题为“My Plugin”,需要具备`manage_options`权限才能查看该页面,并且使用`my-plugin`作为菜单页面的唯一标识符。最后,使用`add_action`函数将`my_plugin_menu`函数挂载到`admin_menu`钩子上,以实现添加插件菜单页面的功能。

注意事项:
- `add_plugins_page`函数应该在`admin_menu`钩子执行之后调用。一般来说,可以在主题的`functions.php`文件中调用该函数。
- 菜单页面的内容可以是任意的HTML、PHP或其他代码,用于展示插件的功能和设置选项。
- 可以使用`remove_plugins_page`函数来移除已添加的插件菜单页面。