Ticket #39050: 39050.diff

src/wp-admin/includes/plugin.php

@@ -1096 +1096 @@
         if ( null === $position ) {
                 $menu[] = $new_menu;
         } elseif ( isset( $menu[ "$position" ] ) ) {
-                $position = $position + substr( base_convert( md5( $menu_slug . $menu_title ), 16, 10 ) , -5 ) * 0.00001;
+                $position = $position + substr( base_convert( md5( $menu_slug . $menu_title ), 16, 10 ) , -5 ) * 0.00001;
                 $menu[ "$position" ] = $new_menu;
         } else {
                 $menu[ $position ] = $new_menu;
@@ -1184 +1184 @@
 }
 
 /**
+ * Add a top-level menu link.
+ *
+ * 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.
+ *
+ * @global array $menu
+ * @global array $admin_page_hooks
+ * @global array $_parent_pages
+ *
+ * @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   $url        The url that the menu item should go to.
+ * @param string   $icon_url   The URL to the icon to be used for this menu.
+ *                             * Pass a base64-encoded SVG using a data URI, which will be colored to match
+ *                               the color scheme. This should begin with 'data:image/svg+xml;base64,'.
+ *                             * Pass the name of a Dashicons helper class to use a font icon,
+ *                               e.g. 'dashicons-chart-pie'.
+ *                             * Pass 'none' to leave div.wp-menu-image empty so an icon can be added via CSS.
+ * @param int      $position   The position in the menu order this one should appear.
+ * @return string The resulting page's menu_slug.
+ */
+function add_menu_link( $menu_title, $capability, $url, $icon_url = '', $position = null ) {
+        global $menu, $admin_page_hooks, $_parent_pages;
+
+        $menu_slug = plugin_basename( $url );
+
+        $admin_page_hooks[ $menu_slug ] = sanitize_title( $menu_title );
+
+        if ( empty( $icon_url ) ) {
+                $icon_url = 'dashicons-admin-generic';
+                $icon_class = 'menu-icon-generic ';
+        } else {
+                $icon_url = set_url_scheme( $icon_url );
+                $icon_class = '';
+        }
+
+        $new_menu = array( $menu_title, $capability, $url, null, "menu-top {$icon_class}", null, $icon_url );
+
+        if ( null === $position ) {
+                $menu[] = $new_menu;
+        } elseif ( isset( $menu[ "$position" ] ) ) {
+                $position = $position + substr( base_convert( md5( $url . $menu_title ), 16, 10 ) , -5 ) * 0.00001;
+                $menu[ "$position" ] = $new_menu;
+        } else {
+                $menu[ $position ] = $new_menu;
+        }
+
+        // No parent as top level
+        $_parent_pages[ $menu_slug ] = false;
+
+        return $url;
+}
+
+/**
+ * Add a submenu link.
+ *
+ * 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.
+ *
+ * @global array $submenu
+ * @global array $menu
+ * @global array $_wp_real_parent_file
+ * @global bool  $_wp_submenu_nopriv
+ * @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   $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   $url         The url that the menu item should go to.
+ * @return false|string The resulting page's menu_slug, or false if the user does not have the capability required.
+ */
+function add_submenu_link( $parent_slug, $menu_title, $capability, $url ) {
+        global $submenu, $menu, $_wp_real_parent_file, $_wp_submenu_nopriv, $_parent_pages;
+
+        $menu_slug = plugin_basename( $url );
+        $parent_slug = plugin_basename( $parent_slug );
+
+        if ( isset( $_wp_real_parent_file[ $parent_slug ] ) ) {
+                $parent_slug = $_wp_real_parent_file[ $parent_slug ];
+        }
+
+        if ( ! current_user_can( $capability ) ) {
+                $_wp_submenu_nopriv[ $parent_slug ][ $menu_slug ] = true;
+                return false;
+        }
+
+        /*
+         * If the parent doesn't already have a submenu, add a link to the parent
+         * as the first item in the submenu. If the submenu file is the same as the
+         * parent file someone is trying to link back to the parent manually. In
+         * this case, don't automatically add a link back to avoid duplication.
+         */
+        if ( ! isset( $submenu[ $parent_slug ] ) && $menu_slug !== $parent_slug ) {
+                foreach ( (array) $menu as $parent_menu ) {
+                        if ( $parent_menu[2] == $parent_slug && current_user_can( $parent_menu[1] ) ) {
+                                $submenu[ $parent_slug ][] = array_slice( $parent_menu, 0, 4 );
+                        }
+                }
+        }
+
+        $submenu[ $parent_slug ][] = array ( $menu_title, $capability, $url, null );
+
+        // No parent as top level.
+        $_parent_pages[ $menu_slug ] = $parent_slug;
+
+        return $menu_slug;
+}
+
+/**
  * Add submenu page to the Tools main menu.
  *
  * This function takes a capability which will be used to determine whether