Question

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

Add submenu page to the Plugins 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_plugins_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
	return add_submenu_page( 'plugins.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

   Basic Plugin Page Example
   Typical usage occurs in a function registered with the admin_menu hook (see Adding Administration Menus):

   
   /**
    * Add a plugin page.
    */
   function wpdocs_plugin_menu() {
   	add_plugins_page(
   		__( 'WPDocs Plugin Page', 'textdomain' ),
   		__( 'WPDocs Plugin, 'textdomain' ),
   		'read',
   		'wpdocs-unique-identifier',
   		'wpdocs_plugin_function'
   	);
   }
   add_action( 'admin_menu', 'wpdocs_plugin_menu' );