Question

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

Add submenu page to the Posts main menu.

---

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: ''

---

返回值

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

---

源代码

File: wp-admin/includes/plugin.php

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

Collapse full 源代码 code View on Trac

---

相关函数

Uses

• wp-admin/includes/plugin.php: add_submenu_page()

---

User Contributed Notes

1. Skip to note content You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note Contributed by Codex

   Example

   Typical usage occurs in a function registered with the ‘admin_menu’ hook (see Adding Administration Menus):

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