Changeset 15203

Timestamp:

06/10/2010 09:38:41 PM (13 years ago)

Author:

westi

Message:

Introduce menu_page_url() for plugins to use to get the url for the pages they have added. Fixes #13829 props o'malley for all the cuteness.

File:

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

trunk/wp-admin/includes/plugin.php

@@ -818 +818 @@
  */
 function add_menu_page( $page_title, $menu_title, $capability, $menu_slug, $function = '', $icon_url = '', $position = NULL ) {
-    global $menu, $admin_page_hooks, $_registered_pages;
+    global $menu, $admin_page_hooks, $_registered_pages, $_parent_pages;
 
     $menu_slug = plugin_basename( $menu_slug );
@@ -843 +843 @@
     $_registered_pages[$hookname] = true;
 
+    // No parent as top level
+    $_parent_pages[$menu_slug] = false;
+    
     return $hookname;
 }
@@ -916 +919 @@
     global $_wp_submenu_nopriv;
     global $_registered_pages;
+    global $_parent_pages;
 
     $menu_slug = plugin_basename( $menu_slug );
@@ -950 +954 @@
         $_registered_pages[get_plugin_page_hookname( $menu_slug, 'edit.php')] = true;
 
+    // No parent as top level
+    $_parent_pages[$menu_slug] = $parent_slug;
+        
     return $hookname;
 }
@@ -1163 +1170 @@
 function add_comments_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
     return add_submenu_page( 'edit-comments.php', $page_title, $menu_title, $capability, $menu_slug, $function );
+}
+
+/**
+ * Get the url to access a particular menu page based on the slug it was registered with.
+ * 
+ * If the slug hasn't been registered properly no url will be returned
+ * 
+ * @since 3.0
+ * 
+ * @param string $menu_slug The slug name to refer to this menu by (should be unique for this menu)
+ * @param bool $echo Whether or not to echo the url - default is true
+ * @return string the url
+ */
+function menu_page_url($menu_slug, $echo = true) {
+    global $_parent_pages;
+        
+    if ( isset( $_parent_pages[$menu_slug] ) ) {
+        if ( $_parent_pages[$menu_slug] ) {
+            $url = admin_url($_parent_pages[$menu_slug] . '?page=' . $menu_slug);
+        } else {
+            $url = admin_url('admin.php?page=' . $menu_slug);
+        }
+    } else {
+        $url = '';
+    }
+    
+    $url = esc_url($url);
+    
+    if ( $echo )
+        echo $url;
+    
+    return $url;
 }