<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="content-type" content="text/html; charset=utf-8" /><style type="text/css"><!--
#msg dl { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; }
#msg dt { float: left; width: 6em; font-weight: bold; }
#msg dt:after { content:':';}
#msg dl, #msg dt, #msg ul, #msg li, #header, #footer { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt;  }
#msg dl a { font-weight: bold}
#msg dl a:link    { color:#fc3; }
#msg dl a:active  { color:#ff0; }
#msg dl a:visited { color:#cc6; }
h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; font-weight: bold; }
#msg pre { overflow: auto; background: #ffc; border: 1px #fc0 solid; padding: 6px; }
#msg ul, pre { overflow: auto; }
#header, #footer { color: #fff; background: #636; border: 1px #300 solid; padding: 6px; }
#patch { width: 100%; }
#patch h4 {font-family: verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;}
#patch .propset h4, #patch .binary h4 {margin:0;}
#patch pre {padding:0;line-height:1.2em;margin:0;}
#patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;}
#patch .propset .diff, #patch .binary .diff  {padding:10px 0;}
#patch span {display:block;padding:0 10px;}
#patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch .binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;}
#patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;}
#patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;}
#patch .lines, .info {color:#888;background:#fff;}
--></style>
<title>[12914] trunk/wp-admin/includes/plugin.php:
  Add phpdoc to all the add_*_page functions.</title>
</head>
<body>

<div id="msg">
<dl>
<dt>Revision</dt> <dd><a href="http://trac.wordpress.org/changeset/12914">12914</a></dd>
<dt>Author</dt> <dd>westi</dd>
<dt>Date</dt> <dd>2010-01-31 17:36:00 +0000 (Sun, 31 Jan 2010)</dd>
</dl>

<h3>Log Message</h3>
<pre>Add phpdoc to all the add_*_page functions.
Rename arguments to empasise that people should be using Capabilities not User Levels and named hooks not __FILE__.
See <a href="http://trac.wordpress.org/ticket/12101">#12101</a>.</pre>

<h3>Modified Paths</h3>
<ul>
<li><a href="#trunkwpadminincludespluginphp">trunk/wp-admin/includes/plugin.php</a></li>
</ul>

</div>
<div id="patch">
<h3>Diff</h3>
<a id="trunkwpadminincludespluginphp"></a>
<div class="modfile"><h4>Modified: trunk/wp-admin/includes/plugin.php (12913 => 12914)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/wp-admin/includes/plugin.php        2010-01-31 17:16:00 UTC (rev 12913)
+++ trunk/wp-admin/includes/plugin.php        2010-01-31 17:36:00 UTC (rev 12914)
</span><span class="lines">@@ -657,15 +657,32 @@
</span><span class="cx"> // Menu
</span><span class="cx"> //
</span><span class="cx"> 
</span><del>-function add_menu_page( $page_title, $menu_title, $access_level, $file, $function = '', $icon_url = '', $position = NULL ) {
</del><ins>+/**
+ * Add a top level menu page
+ * 
+ * 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.
+ * 
+ * @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
+ * @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)
+ * @param callback $function The function to be called to output the content for this page.
+ * @param string $icon_url The url to the icon to be used for this menu
+ * @param int $position The position in the menu order this one should appear
+ */
+function add_menu_page( $page_title, $menu_title, $capability, $menu_slug, $function = '', $icon_url = '', $position = NULL ) {
</ins><span class="cx">         global $menu, $admin_page_hooks, $_registered_pages;
</span><span class="cx"> 
</span><del>-        $file = plugin_basename( $file );
</del><ins>+        $menu_slug = plugin_basename( $menu_slug );
</ins><span class="cx"> 
</span><del>-        $admin_page_hooks[$file] = sanitize_title( $menu_title );
</del><ins>+        $admin_page_hooks[$menu_slug] = sanitize_title( $menu_title );
</ins><span class="cx"> 
</span><del>-        $hookname = get_plugin_page_hookname( $file, '' );
-        if (!empty ( $function ) &amp;&amp; !empty ( $hookname ) &amp;&amp; current_user_can( $access_level ) )
</del><ins>+        $hookname = get_plugin_page_hookname( $menu_slug, '' );
+        if (!empty ( $function ) &amp;&amp; !empty ( $hookname ) &amp;&amp; current_user_can( $capability ) )
</ins><span class="cx">                 add_action( $hookname, $function );
</span><span class="cx"> 
</span><span class="cx">         if ( empty($icon_url) ) {
</span><span class="lines">@@ -674,7 +691,7 @@
</span><span class="cx">                 $icon_url = 'https://' . substr($icon_url, 7);
</span><span class="cx">         }
</span><span class="cx"> 
</span><del>-        $new_menu = array ( $menu_title, $access_level, $file, $page_title, 'menu-top ' . $hookname, $hookname, $icon_url );
</del><ins>+        $new_menu = array ( $menu_title, $capability, $menu_slug, $page_title, 'menu-top ' . $hookname, $hookname, $icon_url );
</ins><span class="cx"> 
</span><span class="cx">         if ( NULL === $position  ) {
</span><span class="cx">                 $menu[] = $new_menu;
</span><span class="lines">@@ -687,37 +704,85 @@
</span><span class="cx">         return $hookname;
</span><span class="cx"> }
</span><span class="cx"> 
</span><del>-function add_object_page( $page_title, $menu_title, $access_level, $file, $function = '', $icon_url = '') {
</del><ins>+/**
+ * Add a top level menu page in the 'objects' section
+ * 
+ * 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.
+ * 
+ * @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
+ * @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)
+ * @param callback $function The function to be called to output the content for this page.
+ * @param string $icon_url The url to the icon to be used for this menu
+ */
+function add_object_page( $page_title, $menu_title, $capability, $menu_slug, $function = '', $icon_url = '') {
</ins><span class="cx">         global $_wp_last_object_menu;
</span><span class="cx"> 
</span><span class="cx">         $_wp_last_object_menu++;
</span><span class="cx"> 
</span><del>-        return add_menu_page($page_title, $menu_title, $access_level, $file, $function, $icon_url, $_wp_last_object_menu);
</del><ins>+        return add_menu_page($page_title, $menu_title, $capability, $menu_slug, $function, $icon_url, $_wp_last_object_menu);
</ins><span class="cx"> }
</span><span class="cx"> 
</span><del>-function add_utility_page( $page_title, $menu_title, $access_level, $file, $function = '', $icon_url = '') {
</del><ins>+/**
+ * Add a top level menu page in the 'utility' section
+ * 
+ * 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.
+ * 
+ * @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
+ * @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)
+ * @param callback $function The function to be called to output the content for this page.
+ * @param string $icon_url The url to the icon to be used for this menu
+ */
+function add_utility_page( $page_title, $menu_title, $capability, $menu_slug, $function = '', $icon_url = '') {
</ins><span class="cx">         global $_wp_last_utility_menu;
</span><span class="cx"> 
</span><span class="cx">         $_wp_last_utility_menu++;
</span><span class="cx"> 
</span><del>-        return add_menu_page($page_title, $menu_title, $access_level, $file, $function, $icon_url, $_wp_last_utility_menu);
</del><ins>+        return add_menu_page($page_title, $menu_title, $capability, $menu_slug, $function, $icon_url, $_wp_last_utility_menu);
</ins><span class="cx"> }
</span><span class="cx"> 
</span><del>-function add_submenu_page( $parent, $page_title, $menu_title, $access_level, $file, $function = '' ) {
</del><ins>+/**
+ * Add a sub menu page
+ * 
+ * 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.
+ * 
+ * @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 $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)
+ * @param callback $function The function to be called to output the content for this page.
+ */
+function add_submenu_page( $parent_slug, $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
</ins><span class="cx">         global $submenu;
</span><span class="cx">         global $menu;
</span><span class="cx">         global $_wp_real_parent_file;
</span><span class="cx">         global $_wp_submenu_nopriv;
</span><span class="cx">         global $_registered_pages;
</span><span class="cx"> 
</span><del>-        $file = plugin_basename( $file );
</del><ins>+        $menu_slug = plugin_basename( $menu_slug );
+        $parent_slug = plugin_basename( $parent_slug);
</ins><span class="cx"> 
</span><del>-        $parent = plugin_basename( $parent);
-        if ( isset( $_wp_real_parent_file[$parent] ) )
-                $parent = $_wp_real_parent_file[$parent];
</del><ins>+        if ( isset( $_wp_real_parent_file[$parent_slug] ) )
+                $parent_slug = $_wp_real_parent_file[$parent_slug];
</ins><span class="cx"> 
</span><del>-        if ( !current_user_can( $access_level ) ) {
-                $_wp_submenu_nopriv[$parent][$file] = true;
</del><ins>+        if ( !current_user_can( $capability ) ) {
+                $_wp_submenu_nopriv[$parent_slug][$menu_slug] = true;
</ins><span class="cx">                 return false;
</span><span class="cx">         }
</span><span class="cx"> 
</span><span class="lines">@@ -725,79 +790,218 @@
</span><span class="cx">         // as the first item in the submenu.  If the submenu file is the same as the
</span><span class="cx">         // parent file someone is trying to link back to the parent manually.  In
</span><span class="cx">         // this case, don't automatically add a link back to avoid duplication.
</span><del>-        if (!isset( $submenu[$parent] ) &amp;&amp; $file != $parent  ) {
</del><ins>+        if (!isset( $submenu[$parent_slug] ) &amp;&amp; $menu_slug != $parent_slug  ) {
</ins><span class="cx">                 foreach ( (array)$menu as $parent_menu ) {
</span><del>-                        if ( $parent_menu[2] == $parent &amp;&amp; current_user_can( $parent_menu[1] ) )
-                                $submenu[$parent][] = $parent_menu;
</del><ins>+                        if ( $parent_menu[2] == $parent_slug &amp;&amp; current_user_can( $parent_menu[1] ) )
+                                $submenu[$parent_slug][] = $parent_menu;
</ins><span class="cx">                 }
</span><span class="cx">         }
</span><span class="cx"> 
</span><del>-        $submenu[$parent][] = array ( $menu_title, $access_level, $file, $page_title );
</del><ins>+        $submenu[$parent_slug][] = array ( $menu_title, $capability, $menu_slug, $page_title );
</ins><span class="cx"> 
</span><del>-        $hookname = get_plugin_page_hookname( $file, $parent);
</del><ins>+        $hookname = get_plugin_page_hookname( $menu_slug, $parent_slug);
</ins><span class="cx">         if (!empty ( $function ) &amp;&amp; !empty ( $hookname ))
</span><span class="cx">                 add_action( $hookname, $function );
</span><span class="cx"> 
</span><span class="cx">         $_registered_pages[$hookname] = true;
</span><span class="cx">         // backwards-compatibility for plugins using add_management page.  See wp-admin/admin.php for redirect from edit.php to tools.php
</span><del>-        if ( 'tools.php' == $parent )
-                $_registered_pages[get_plugin_page_hookname( $file, 'edit.php')] = true;
</del><ins>+        if ( 'tools.php' == $parent_slug )
+                $_registered_pages[get_plugin_page_hookname( $menu_slug, 'edit.php')] = true;
</ins><span class="cx"> 
</span><span class="cx">         return $hookname;
</span><span class="cx"> }
</span><span class="cx"> 
</span><span class="cx"> /**
</span><span class="cx">  * Add sub menu page to the tools main menu.
</span><del>- *
- * @param string $page_title
- * @param unknown_type $menu_title
- * @param unknown_type $access_level
- * @param unknown_type $file
- * @param unknown_type $function
- * @return unknown
</del><ins>+* 
+ * 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.
+ * 
+ * @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
+ * @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)
+ * @param callback $function The function to be called to output the content for this page.
</ins><span class="cx">  */
</span><del>-function add_management_page( $page_title, $menu_title, $access_level, $file, $function = '' ) {
-        return add_submenu_page( 'tools.php', $page_title, $menu_title, $access_level, $file, $function );
</del><ins>+function add_management_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
+        return add_submenu_page( 'tools.php', $page_title, $menu_title, $capability, $menu_slug, $function );
</ins><span class="cx"> }
</span><span class="cx"> 
</span><del>-function add_options_page( $page_title, $menu_title, $access_level, $file, $function = '' ) {
-        return add_submenu_page( 'options-general.php', $page_title, $menu_title, $access_level, $file, $function );
</del><ins>+/**
+ * Add sub menu page to the options main menu.
+* 
+ * 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.
+ * 
+ * @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
+ * @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)
+ * @param callback $function The function to be called to output the content for this page.
+ */
+function add_options_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
+        return add_submenu_page( 'options-general.php', $page_title, $menu_title, $capability, $menu_slug, $function );
</ins><span class="cx"> }
</span><span class="cx"> 
</span><del>-function add_theme_page( $page_title, $menu_title, $access_level, $file, $function = '' ) {
-        return add_submenu_page( 'themes.php', $page_title, $menu_title, $access_level, $file, $function );
</del><ins>+/**
+ * Add sub menu page to the themes main menu.
+* 
+ * 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.
+ * 
+ * @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
+ * @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)
+ * @param callback $function The function to be called to output the content for this page.
+ */
+function add_theme_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
+        return add_submenu_page( 'themes.php', $page_title, $menu_title, $capability, $menu_slug, $function );
</ins><span class="cx"> }
</span><span class="cx"> 
</span><del>-function add_users_page( $page_title, $menu_title, $access_level, $file, $function = '' ) {
</del><ins>+/**
+ * Add sub menu page to the Users/Profile main menu.
+* 
+ * 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.
+ * 
+ * @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
+ * @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)
+ * @param callback $function The function to be called to output the content for this page.
+ */
+function add_users_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
</ins><span class="cx">         if ( current_user_can('edit_users') )
</span><span class="cx">                 $parent = 'users.php';
</span><span class="cx">         else
</span><span class="cx">                 $parent = 'profile.php';
</span><del>-        return add_submenu_page( $parent, $page_title, $menu_title, $access_level, $file, $function );
</del><ins>+        return add_submenu_page( $parent, $page_title, $menu_title, $capability, $menu_slug, $function );
</ins><span class="cx"> }
</span><del>-
-function add_dashboard_page( $page_title, $menu_title, $access_level, $file, $function = '' ) {
-        return add_submenu_page( 'index.php', $page_title, $menu_title, $access_level, $file, $function );
</del><ins>+/**
+ * Add sub menu page to the Dashboard main menu.
+* 
+ * 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.
+ * 
+ * @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
+ * @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)
+ * @param callback $function The function to be called to output the content for this page.
+ */
+function add_dashboard_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
+        return add_submenu_page( 'index.php', $page_title, $menu_title, $capability, $menu_slug, $function );
</ins><span class="cx"> }
</span><span class="cx"> 
</span><del>-function add_posts_page( $page_title, $menu_title, $access_level, $file, $function = '' ) {
-        return add_submenu_page( 'edit.php', $page_title, $menu_title, $access_level, $file, $function );
</del><ins>+/**
+ * Add sub menu page to the posts main menu.
+* 
+ * 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.
+ * 
+ * @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
+ * @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)
+ * @param callback $function The function to be called to output the content for this page.
+ */
+function add_posts_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
+        return add_submenu_page( 'edit.php', $page_title, $menu_title, $capability, $menu_slug, $function );
</ins><span class="cx"> }
</span><span class="cx"> 
</span><del>-function add_media_page( $page_title, $menu_title, $access_level, $file, $function = '' ) {
-        return add_submenu_page( 'upload.php', $page_title, $menu_title, $access_level, $file, $function );
</del><ins>+/**
+ * Add sub menu page to the media main menu.
+* 
+ * 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.
+ * 
+ * @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
+ * @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)
+ * @param callback $function The function to be called to output the content for this page.
+ */
+function add_media_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
+        return add_submenu_page( 'upload.php', $page_title, $menu_title, $capability, $menu_slug, $function );
</ins><span class="cx"> }
</span><span class="cx"> 
</span><del>-function add_links_page( $page_title, $menu_title, $access_level, $file, $function = '' ) {
-        return add_submenu_page( 'link-manager.php', $page_title, $menu_title, $access_level, $file, $function );
</del><ins>+/**
+ * Add sub menu page to the links main menu.
+* 
+ * 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.
+ * 
+ * @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
+ * @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)
+ * @param callback $function The function to be called to output the content for this page.
+ */
+function add_links_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
+        return add_submenu_page( 'link-manager.php', $page_title, $menu_title, $capability, $menu_slug, $function );
</ins><span class="cx"> }
</span><span class="cx"> 
</span><del>-function add_pages_page( $page_title, $menu_title, $access_level, $file, $function = '' ) {
-        return add_submenu_page( 'edit.php?post_type=page', $page_title, $menu_title, $access_level, $file, $function );
</del><ins>+/**
+ * Add sub menu page to the pages main menu.
+* 
+ * 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.
+ * 
+ * @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
+ * @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)
+ * @param callback $function The function to be called to output the content for this page.
+ */
+function add_pages_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
+        return add_submenu_page( 'edit.php?post_type=page', $page_title, $menu_title, $capability, $menu_slug, $function );
</ins><span class="cx"> }
</span><span class="cx"> 
</span><del>-function add_comments_page( $page_title, $menu_title, $access_level, $file, $function = '' ) {
-        return add_submenu_page( 'edit-comments.php', $page_title, $menu_title, $access_level, $file, $function );
</del><ins>+/**
+ * Add sub menu page to the comments main menu.
+* 
+ * 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.
+ * 
+ * @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
+ * @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)
+ * @param callback $function The function to be called to output the content for this page.
+ */
+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 );
</ins><span class="cx"> }
</span><span class="cx"> 
</span><span class="cx"> //
</span></span></pre>
</div>
</div>

</body>
</html>