Changeset 32643 for trunk/src/wp-admin/includes/plugin.php

Timestamp:

05/29/2015 02:05:26 AM (9 years ago)

Author:

wonderboymusic

Message:

Add @global annotations to (the rest of the?) wp-admin/* files.

Does not include list table file changes.

See #32444.

File:

• trunk/src/wp-admin/includes/plugin.php (modified) (17 diffs)

trunk/src/wp-admin/includes/plugin.php

@@ -1005 +1005 @@
  * that the user has the required capability as well.
  *
+ * @global array $menu
+ * @global array $admin_page_hooks
+ * @global array $_registered_pages
+ * @global array $_parent_pages
+ *
  * @param string $page_title The text to be displayed in the title tags of the page when the menu is selected
  * @param string $menu_title The text to be used for the menu
@@ -1063 +1068 @@
  * that the user has the required capability as well.
  *
+ * @global int $_wp_last_object_menu
+ *
  * @param string $page_title The text to be displayed in the title tags of the page when the menu is selected
  * @param string $menu_title The text to be used for the menu
@@ -1089 +1096 @@
  * that the user has the required capability as well.
  *
+ * @global int $_wp_last_utility_menu
+ *
  * @param string $page_title The text to be displayed in the title tags of the page when the menu is selected
  * @param string $menu_title The text to be used for the menu
@@ -1115 +1124 @@
  * that the user has the required capability as well.
  *
+ * @global array $submenu
+ * @global array $menu
+ * @global type $_wp_real_parent_file
+ * @global bool $_wp_submenu_nopriv
+ * @global array $_registered_pages
+ * @global array $_parent_pages
+ *
  * @param string $parent_slug The slug name for the parent menu (or the file name of a standard WordPress admin page)
  * @param string $page_title The text to be displayed in the title tags of the page when the menu is selected
@@ -1125 +1141 @@
  */
 function add_submenu_page( $parent_slug, $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
-    global $submenu;
-    global $menu;
-    global $_wp_real_parent_file;
-    global $_wp_submenu_nopriv;
-    global $_registered_pages;
-    global $_parent_pages;
+    global $submenu, $menu, $_wp_real_parent_file, $_wp_submenu_nopriv,
+        $_registered_pages, $_parent_pages;
 
     $menu_slug = plugin_basename( $menu_slug );
@@ -1416 +1428 @@
  * @since 3.1.0
  *
+ * @global array $menu
+ *
  * @param string $menu_slug The slug of the menu
  * @return array|bool The removed menu on success, False if not found
@@ -1437 +1451 @@
  * @since 3.1.0
  *
+ * @global array $submenu
+ *
  * @param string $menu_slug The slug for the parent menu
  * @param string $submenu_slug The slug of the submenu
@@ -1463 +1479 @@
  *
  * @since 3.0.0
+ *
+ * @global array $_parent_pages
  *
  * @param string $menu_slug The slug name to refer to this menu by (should be unique for this menu)
@@ -1493 +1511 @@
 // Pluggable Menu Support -- Private
 //
-
+/**
+ *
+ * @global string $parent_file
+ * @global array $menu
+ * @global array $submenu
+ * @global string $pagenow
+ * @global string $typenow
+ * @global string $plugin_page
+ * @global string $_wp_real_parent_file
+ * @global array $_wp_menu_nopriv
+ * @global array $_wp_submenu_nopriv
+ */
 function get_admin_page_parent( $parent = '' ) {
-    global $parent_file;
-    global $menu;
-    global $submenu;
-    global $pagenow;
-    global $typenow;
-    global $plugin_page;
-    global $_wp_real_parent_file;
-    global $_wp_menu_nopriv;
-    global $_wp_submenu_nopriv;
+    global $parent_file, $menu, $submenu, $pagenow, $typenow,
+        $plugin_page, $_wp_real_parent_file, $_wp_menu_nopriv, $_wp_submenu_nopriv;
 
     if ( !empty ( $parent ) && 'admin.php' != $parent ) {
@@ -1557 +1579 @@
 }
 
+/**
+ *
+ * @global string $title
+ * @global array $menu
+ * @global array $submenu
+ * @global string $pagenow
+ * @global string $plugin_page
+ * @global string $typenow
+ */
 function get_admin_page_title() {
-    global $title;
-    global $menu;
-    global $submenu;
-    global $pagenow;
-    global $plugin_page;
-    global $typenow;
+    global $title, $menu, $submenu, $pagenow, $plugin_page, $typenow;
 
     if ( ! empty ( $title ) )
@@ -1641 +1667 @@
 }
 
+/**
+ *
+ * @global array $admin_page_hooks
+ * @param string $plugin_page
+ * @param string $parent_page
+ */
 function get_plugin_page_hookname( $plugin_page, $parent_page ) {
     global $admin_page_hooks;
@@ -1662 +1694 @@
 }
 
+/**
+ *
+ * @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
+ */
 function user_can_access_admin_page() {
-    global $pagenow;
-    global $menu;
-    global $submenu;
-    global $_wp_menu_nopriv;
-    global $_wp_submenu_nopriv;
-    global $plugin_page;
-    global $_registered_pages;
+    global $pagenow, $menu, $submenu, $_wp_menu_nopriv, $_wp_submenu_nopriv,
+        $plugin_page, $_registered_pages;
 
     $parent = get_admin_page_parent();
@@ -1742 +1779 @@
  * @since 2.7.0
  *
+ * @global array $new_whitelist_options
+ *
  * @param string $option_group A settings group name. Should correspond to a whitelisted option key name.
  *  Default whitelisted option key names include "general," "discussion," and "reading," among others.
@@ -1769 +1808 @@
  *
  * @since 2.7.0
+ *
+ * @global array $new_whitelist_options
  *
  * @param string   $option_group
@@ -1799 +1840 @@
  * @since 2.7.0
  *
+ * @global array $new_whitelist_options
+ *
  * @param array $options
  * @return array
@@ -1816 +1859 @@
  *
  * @since 2.7.0
+ *
+ * @global array $whitelist_options
  *
  * @param array        $new_options
@@ -1848 +1893 @@
  * @since 2.7.0
  *
+ * @global array $whitelist_options
+ *
  * @param array        $del_options
  * @param string|array $options