add_utility_page函数是WordPress中的一个函数,用于添加工具页面到WordPress的后台管理界面。该函数的用法如下:

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

参数解析:
- $page_title (string):页面的标题,将显示在页面的顶部。
- $menu_title (string):在WordPress的侧边栏菜单中显示的标题。
- $capability (string):指定用户需要具有的权限才能访问此页面。常用的权限包括'administrator'(管理员)、'editor'(编辑者)、'author'(作者)等。
- $menu_slug (string):菜单项的唯一标识符,用于在URL中识别和访问页面。
- $function (callable):可选参数,用于在页面上显示内容的回调函数。如果没有提供该参数,则页面将为空白。
- $position (int):可选参数,指定菜单项在侧边栏中的位置。默认值为null,表示将菜单项添加到最后。

使用示例:

function my_custom_page_content() {
echo '

';
echo '

My Custom Utility Page

';
echo '

This is a custom utility page added to the WordPress admin area.

';
echo '

';
}

function add_custom_utility_page() {
add_utility_page( 'Custom Utility Page', 'Custom Page', 'manage_options', 'custom-utility-page', 'my_custom_page_content');
}

add_action( 'admin_menu', 'add_custom_utility_page' );

在上面的示例中,首先定义了一个回调函数`my_custom_page_content`,用于在页面上显示内容。然后定义了另一个函数`add_custom_utility_page`,该函数使用`add_utility_page`函数添加了一个名为"Custom Page"的工具页面到WordPress后台管理界面的侧边栏菜单中。这个页面的标题为"Custom Utility Page",用户需要具有"manage_options"权限才能访问该页面。在这个例子中,我们将`my_custom_page_content`作为回调函数传递给`add_utility_page`函数,以便在页面上显示内容。

最后,通过使用`add_action`函数将`add_custom_utility_page`函数添加到`admin_menu` hook中,使得在WordPress后台管理界面加载时添加这个工具页面。

当用户访问该工具页面时,将显示一个标题为"My Custom Utility Page"的页面,并在页面上显示一段文本"This is a custom utility page added to the WordPress admin area."。