add_posts_page()

最后更新于：2021-11-25 19:24:56

Add submenu page to the Posts main menu.

参数

$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: ”

$position

(int) (Optional) The position in the menu order this item should appear.

Default value: null

响应

(string|false) The resulting page’s hook_suffix, or false if the user does not have the capability required.

源文件

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

function add_posts_page( $page_title, $menu_title, $capability, $menu_slug, $function = '', $position = null ) {
	return add_submenu_page( 'edit.php', $page_title, $menu_title, $capability, $menu_slug, $function, $position );
}

/**
 * Adds a submenu item to the "Posts" menu in the admin.
 */
function gcdocs_my_plugin_menu() {
	add_posts_page(
		__( 'My Plugin Posts Page', 'textdomain' ),
		__( 'My Plugin', 'textdomain' ),
		'read',
		'my-unique-identifier',
		'gcdocs_my_plugin_function'
	);
}
add_action( 'admin_menu', 'gcdocs_my_plugin_menu');