Question

Warning: This function has been deprecated. Use add_menu_page() instead.

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

Add a top-level menu page in the ‘utility’ section.

---

description

This function takes a capability which will be used to determine whether or not a page is included in the menu.

The function which is hooked in to handle the output of the page must check that the user has the required capability as well.

---

参数

$page_title

(string) (Required) The text to be displayed in the title tags of the page when the menu is selected.

$menu_title

(string) (Required) The text to be used for the menu.

$capability

(string) (Required) The capability required for this menu to be displayed to the user.

$menu_slug

(string) (Required) The slug name to refer to this menu by (should be unique for this menu).

$function

(callable) (Optional) The function to be called to output the content for this page.

Default value: ''

$icon_url

(string) (Optional) The url to the icon to be used for this menu.

Default value: ''

---

返回值

(string) The resulting page's hook_suffix.

---

源代码

File: wp-admin/includes/deprecated.php

function add_utility_page( $page_title, $menu_title, $capability, $menu_slug, $function = '', $icon_url = '') {
	_deprecated_function( __FUNCTION__, '4.5.0', 'add_menu_page()' );

	global $_wp_last_utility_menu;

	$_wp_last_utility_menu++;

	return add_menu_page($page_title, $menu_title, $capability, $menu_slug, $function, $icon_url, $_wp_last_utility_menu);
}

---

更新日志

Version	description
4.5.0	Use add_menu_page()
2.7.0	Introduced.

---

相关函数

Uses

• wp-admin/includes/plugin.php: add_menu_page()
• wp-includes/functions.php: _deprecated_function()

---

User Contributed Notes