Docs: Improve documentation for admin menu functions:

* `get_admin_page_parent()`
* `get_admin_page_title()`
* `get_plugin_page_hook()`
* `get_plugin_page_hookname()`
* `user_can_access_admin_page()`

Add missing descriptions and `@since` tags.

Props subrataemfluence, kennithnichol, stevenlinx, SergeyBiryukov.
Fixes #44253, #49067.
Built from https://develop.svn.wordpress.org/trunk@47006


git-svn-id: http://core.svn.wordpress.org/trunk@46806 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Sergey Biryukov 2019-12-23 14:36:04 +00:00
parent f501814eac
commit 246a035d99
2 changed files with 30 additions and 12 deletions

View File

@ -1796,6 +1796,10 @@ function menu_page_url( $menu_slug, $echo = true ) {
// Pluggable Menu Support -- Private
//
/**
* Gets the parent file of the current admin page.
*
* @since 1.5.0
*
* @global string $parent_file
* @global array $menu
* @global array $submenu
@ -1806,7 +1810,7 @@ function menu_page_url( $menu_slug, $echo = true ) {
* @global array $_wp_menu_nopriv
* @global array $_wp_submenu_nopriv
*
* @return string
* @return string The parent file of the current admin page.
*/
function get_admin_page_parent( $parent = '' ) {
global $parent_file, $menu, $submenu, $pagenow, $typenow,
@ -1871,6 +1875,10 @@ function get_admin_page_parent( $parent = '' ) {
}
/**
* Gets the title of the current admin page.
*
* @since 1.5.0
*
* @global string $title
* @global array $menu
* @global array $submenu
@ -1878,7 +1886,7 @@ function get_admin_page_parent( $parent = '' ) {
* @global string $plugin_page
* @global string $typenow
*
* @return string
* @return string The title of the current admin page.
*/
function get_admin_page_title() {
global $title, $menu, $submenu, $pagenow, $plugin_page, $typenow;
@ -1954,7 +1962,9 @@ function get_admin_page_title() {
}
/**
* @since 2.3.0
* Gets the hook attached to the administrative page of a plugin.
*
* @since 1.5.0
*
* @param string $plugin_page The slug name of the plugin page.
* @param string $parent_page The slug name for the parent menu (or the file name of a standard
@ -1971,6 +1981,10 @@ function get_plugin_page_hook( $plugin_page, $parent_page ) {
}
/**
* Gets the hook name for the administrative page of a plugin.
*
* @since 1.5.0
*
* @global array $admin_page_hooks
*
* @param string $plugin_page The slug name of the plugin page.
@ -2000,15 +2014,19 @@ function get_plugin_page_hookname( $plugin_page, $parent_page ) {
}
/**
* @global string $pagenow
* @global array $menu
* @global array $submenu
* @global array $_wp_menu_nopriv
* @global array $_wp_submenu_nopriv
* @global string $plugin_page
* @global array $_registered_pages
* Determines whether the current user can access the current admin page.
*
* @return bool Whether the current user can access the current admin page.
* @since 1.5.0
*
* @global string $pagenow
* @global array $menu
* @global array $submenu
* @global array $_wp_menu_nopriv
* @global array $_wp_submenu_nopriv
* @global string $plugin_page
* @global array $_registered_pages
*
* @return bool True if the current user can access the admin page, false otherwise.
*/
function user_can_access_admin_page() {
global $pagenow, $menu, $submenu, $_wp_menu_nopriv, $_wp_submenu_nopriv,

View File

@ -13,7 +13,7 @@
*
* @global string $wp_version
*/
$wp_version = '5.4-alpha-47005';
$wp_version = '5.4-alpha-47006';
/**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.