add_options_page() │ WP 1.5.0

Adds a child page (submenu) to the admin panel menu "Settings".

Notes

1. This function is a wrapper for the function add_submenu_page(). The first parameter $parent_slug is specified as 'options-general.php', and all other parameters are simply passed as is.

2. In the function that outputs the page content, user access (capability) should be checked separately.

No Hooks.

Returns

String|false. hook_suffix of the inserted page (menu item), what the function add_submenu_page() returns.

Usage

add_options_page( $page_title, $menu_title, $capability, $menu_slug, $function );

$page_title(string) (required)

Text that will be used in the title tag on the settings page.

Then, when generating the admin page, this value can be retrieved using the function get_admin_page_title().

$menu_title(string) (required)

Text that will be used as the name for the menu item.

$capability(string) (required)

The name of the access right for the user to see this menu item. See the capabilities table here. This parameter also controls access to the page of this menu item.

$menu_slug(string) (required)

Menu identifier. You need to enter a unique string.

Do not use the magic constant __FILE__ and spaces. Spaces will be trimmed when forming the URL!

You can also specify the path from the plugin folder to the file that will be responsible for the plugin settings page, e.g. my-plugin/options.php. In this case, the next parameter $function is not required.

$function(string)

The name of the function that is responsible for the code of the page of this menu item.
Default: ''

Examples

class Option_Page {

	function __construct() {
		add_action( 'admin_menu', array( $this, 'admin_menu' ) );
	}

	function admin_menu () {
		add_options_page( 'Page Title', 'Circle Tree Login', 'manage_options', 'options_page_slug', [ $this, 'settings_page' ] );
	}

	function  settings_page () {
		?>
		<p>This is the content of the settings page</p>
		<?php
	}
}

new Option_Page();

add_action( 'admin_menu', 'my_plugin_menu' );

function my_plugin_menu() {
	add_options_page( 'My Options', 'My Plugin', 'manage_options', 'my-plugin', 'my_plugin_page' );
}

function my_plugin_page(){
	echo "Output for the plugin settings page";
}

Add Your Own Example