Ticket #15067: 15067.2.diff

wp-admin/includes/plugin.php

@@ -853 +853 @@
  * The function which is hooked in to handle the output of the page must check
  * that the user has the required capability as well.
  *
- * @param string $page_title The text to be displayed in the title tags of the page when the menu is selected
+ * @param mixed $page_title_or_params The text to be displayed in the title tags of the page when the menu is selected
+ *                                    OR, an array of this and all subsequent parameters.
  * @param string $menu_title The text to be used for the menu
  * @param string $capability The capability required for this menu to be displayed to the user.
  * @param string $menu_slug The slug name to refer to this menu by (should be unique for this menu)
@@ -863 +864 @@
  *
  * @return string The resulting page's hook_suffix
  */
-function add_menu_page( $page_title, $menu_title, $capability, $menu_slug, $function = '', $icon_url = '', $position = NULL ) {
+function add_menu_page( $page_title_or_params, $menu_title = NULL, $capability = NULL, $menu_slug = NULL, $function = '', $icon_url = '', $position = NULL ) {
         global $menu, $admin_page_hooks, $_registered_pages, $_parent_pages;
 
+        if ( is_array( $page_title_or_params ) )
+                extract( shortcode_atts( array( 'page_title' => NULL, 'menu_title' => NULL, 'capability' => NULL, 'menu_slug' => NULL, 'function' => '', 'icon_url' => '', 'position' => NULL ), $page_title_or_params ) );
+        else
+                $page_title = $page_title_or_params;
+
         $menu_slug = plugin_basename( $menu_slug );
 
         $admin_page_hooks[$menu_slug] = sanitize_title( $menu_title );
@@ -913 +919 @@
  *
  * @return string The resulting page's hook_suffix
  */
-function add_object_page( $page_title, $menu_title, $capability, $menu_slug, $function = '', $icon_url = '') {
+function add_object_page( $page_title, $menu_title = NULL, $capability = NULL, $menu_slug = NULL, $function = '', $icon_url = '') {
         global $_wp_last_object_menu;
 
         $_wp_last_object_menu++;
@@ -939 +945 @@
  *
  * @return string The resulting page's hook_suffix
  */
-function add_utility_page( $page_title, $menu_title, $capability, $menu_slug, $function = '', $icon_url = '') {
+function add_utility_page( $page_title, $menu_title = NULL, $capability = NULL, $menu_slug = NULL, $function = '', $icon_url = '') {
         global $_wp_last_utility_menu;
 
         $_wp_last_utility_menu++;
@@ -956 +962 @@
  * The function which is hooked in to handle the output of the page must check
  * that the user has the required capability as well.
  *
- * @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
+ * @param string $parent_slug The slug name for the parent menu (or the file name of a standard WordPress admin page),
+ * @param mixed $page_title_or_params The text to be displayed in the title tags of the page when the menu is selected
+ *                                    OR, an array of this and all subsequent parameters.
  * @param string $menu_title The text to be used for the menu
  * @param string $capability The capability required for this menu to be displayed to the user.
  * @param string $menu_slug The slug name to refer to this menu by (should be unique for this menu)
@@ -965 +972 @@
  *
  * @return string The resulting page's hook_suffix
  */
-function add_submenu_page( $parent_slug, $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
+function add_submenu_page( $parent_slug, $page_title_or_params, $menu_title = NULL, $capability = NULL, $menu_slug = NULL, $function = '' ) {
         global $submenu;
         global $menu;
         global $_wp_real_parent_file;
@@ -973 +980 @@
         global $_registered_pages;
         global $_parent_pages;
 
+        if ( is_array( $page_title_or_params ) )
+                extract( shortcode_atts( array( 'page_title' => NULL, 'menu_title' => NULL, 'capability' => NULL, 'menu_slug' => NULL, 'function' => '' ), $page_title_or_params ) );
+        else
+                $page_title = $page_title_or_params;
+
         $menu_slug = plugin_basename( $menu_slug );
         $parent_slug = plugin_basename( $parent_slug);
 
@@ -1029 +1041 @@
  *
  * @return string The resulting page's hook_suffix
  */
-function add_management_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
+function add_management_page( $page_title, $menu_title = NULL, $capability = NULL, $menu_slug = NULL, $function = '' ) {
         return add_submenu_page( 'tools.php', $page_title, $menu_title, $capability, $menu_slug, $function );
 }
 
@@ -1050 +1062 @@
  *
  * @return string The resulting page's hook_suffix
  */
-function add_options_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
+function add_options_page( $page_title, $menu_title = NULL, $capability = NULL, $menu_slug = NULL, $function = '' ) {
         return add_submenu_page( 'options-general.php', $page_title, $menu_title, $capability, $menu_slug, $function );
 }
 
@@ -1071 +1083 @@
  *
  * @return string The resulting page's hook_suffix
  */
-function add_theme_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
+function add_theme_page( $page_title, $menu_title = NULL, $capability = NULL, $menu_slug = NULL, $function = '' ) {
         return add_submenu_page( 'themes.php', $page_title, $menu_title, $capability, $menu_slug, $function );
 }
 
@@ -1092 +1104 @@
  *
  * @return string The resulting page's hook_suffix
  */
-function add_plugins_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
+function add_plugins_page( $page_title, $menu_title = NULL, $capability = NULL, $menu_slug = NULL, $function = '' ) {
         return add_submenu_page( 'plugins.php', $page_title, $menu_title, $capability, $menu_slug, $function );
 }
 
@@ -1113 +1125 @@
  *
  * @return string The resulting page's hook_suffix
  */
-function add_users_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
+function add_users_page( $page_title, $menu_title = NULL, $capability = NULL, $menu_slug = NULL, $function = '' ) {
         if ( current_user_can('edit_users') )
                 $parent = 'users.php';
         else
@@ -1137 +1149 @@
  *
  * @return string The resulting page's hook_suffix
  */
-function add_dashboard_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
+function add_dashboard_page( $page_title, $menu_title = NULL, $capability = NULL, $menu_slug = NULL, $function = '' ) {
         return add_submenu_page( 'index.php', $page_title, $menu_title, $capability, $menu_slug, $function );
 }
 
@@ -1158 +1170 @@
  *
  * @return string The resulting page's hook_suffix
  */
-function add_posts_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
+function add_posts_page( $page_title, $menu_title = NULL, $capability = NULL, $menu_slug = NULL, $function = '' ) {
         return add_submenu_page( 'edit.php', $page_title, $menu_title, $capability, $menu_slug, $function );
 }
 
@@ -1179 +1191 @@
  *
  * @return string The resulting page's hook_suffix
  */
-function add_media_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
+function add_media_page( $page_title, $menu_title = NULL, $capability = NULL, $menu_slug = NULL, $function = '' ) {
         return add_submenu_page( 'upload.php', $page_title, $menu_title, $capability, $menu_slug, $function );
 }
 
@@ -1200 +1212 @@
  *
  * @return string The resulting page's hook_suffix
  */
-function add_links_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
+function add_links_page( $page_title, $menu_title = NULL, $capability = NULL, $menu_slug = NULL, $function = '' ) {
         return add_submenu_page( 'link-manager.php', $page_title, $menu_title, $capability, $menu_slug, $function );
 }
 
@@ -1221 +1233 @@
  *
  * @return string The resulting page's hook_suffix
 */
-function add_pages_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
+function add_pages_page( $page_title, $menu_title = NULL, $capability = NULL, $menu_slug = NULL, $function = '' ) {
         return add_submenu_page( 'edit.php?post_type=page', $page_title, $menu_title, $capability, $menu_slug, $function );
 }
 
@@ -1242 +1254 @@
  *
  * @return string The resulting page's hook_suffix
 */
-function add_comments_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
+function add_comments_page( $page_title, $menu_title = NULL, $capability = NULL, $menu_slug = NULL, $function = '' ) {
         return add_submenu_page( 'edit-comments.php', $page_title, $menu_title, $capability, $menu_slug, $function );
 }