WordPress.org

Codex

Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Function Reference/add comments page

Description

Add sub menu page to the Comments menu.

NOTE: If you're running into the »You do not have sufficient permissions to access this page.« message in a wp_die() screen, then you've hooked too early. The hook, you should use is admin_menu.

Usage

 <?php
add_comments_page
$page_title$menu_title$capability$menu_slug$function);
?> 

Parameters

$page_title
(string) (required) The text to be displayed in the title tags of the page when the menu is selected
Default: None
$menu_title
(string) (required) The text to be used for the menu
Default: None
$capability
(string) (required) The capability required for this menu to be displayed to the user.
Default: None
$menu_slug
(string) (required) The slug name to refer to this menu by (should be unique for this menu).
Default: None
$function
(callback) (optional) The function to be called to output the content for this page.
Default: ' '

Return Values

string 
The resulting page's hook_suffix (What add_submenu_page() returns)

Notes

  • This function is a simple wrapper for a call to add_submenu_page(), passing the received arguments and specifying 'edit-comments.php' as the $parent_slug argument. This means the new page will be added as a sub menu to the Comments menu.
  • The $capability parameter is used to determine whether or not the page is included in the menu based on the Roles and Capabilities) of the current user.
  • The function handling the output of the options page should also verify the user's capabilities.

Example

Typical usage occurs in a function registered with the 'admin_menu' hook (see Adding Administration Menus):

add_action('admin_menu', 'my_plugin_menu');

function my_plugin_menu() {
	add_comments_page('My Plugin Comments', 'My Plugin', 'read', 'my-unique-identifier', 'my_plugin_function');
}

Source File

add_comments_page() is located in wp-admin/includes/plugin.php.

Related

Administration Menus: add_menu_page(), remove_menu_page(), add_submenu_page(), remove_submenu_page(), add_dashboard_page(), add_posts_page(), add_media_page(), add_links_page(), add_pages_page(), add_comments_page(), add_theme_page(), add_plugins_page(), add_users_page(), add_management_page(), add_options_page()

See also index of Function Reference and index of Template Tags.