WordPress開發(fā)函數(shù) add_options_page()
WordPress開發(fā)函數(shù) add_options_page()，添加子菜單頁面到設(shè)置主菜單。
用法：
add_options_page( string $page_title, string $menu_title, string $capability, string $menu_slug, callable $function = '', int $position = null )
描述：
該函數(shù)具有一種功能，用于確定菜單中是否包含某個(gè)頁面。
用于處理頁面輸出的函數(shù)也必須檢查用戶是否具備所需的功能。
參數(shù)
$page_title
(string) (必需) 選中菜單時(shí)要在頁面標(biāo)題標(biāo)簽中顯示的文本。
$menu_title
(string) (必需) 要用于菜單的文本。
$capability
(string) (必需) 向用戶顯示該菜單所需的功能。
$menu_slug
(string) (必需) 用來引用這個(gè)菜單的slug名稱(對于這個(gè)菜單應(yīng)該是唯一的)。
$function
(callable) (可選) 用于輸出此頁面內(nèi)容的函數(shù)。
默認(rèn)值: ''
$position
(int) (可選) 該項(xiàng)目應(yīng)出現(xiàn)在菜單順序中的位置。
默認(rèn)值: null
返回
(string|false)結(jié)果頁面的hook_suffix，如果用戶不具備所需的能力則為false。
更多信息
- 這個(gè)函數(shù)是對add_submenu_page()調(diào)用的簡單包裝器，它傳遞接收到的參數(shù)并指定' options-general '。php '作為$parent_slug參數(shù)。這意味著新的選項(xiàng)頁面將作為一個(gè)子菜單添加到設(shè)置菜單。
- $capability參數(shù)用于根據(jù)當(dāng)前用戶的角色和功能確定該頁面是否包含在菜單中。
- 處理options頁面輸出的函數(shù)還應(yīng)該驗(yàn)證用戶的能力。
- 如果在插入中有空格，那么在生成URL時(shí)這些空格將被刪除。這將導(dǎo)致一條錯誤消息，告訴您沒有足夠的權(quán)限來查看頁面。
來源：
文件: wp-admin/includes/plugin.php
function add_options_page( $page_title, $menu_title, $capability, $menu_slug, $function = '', $position = null ) {
return add_submenu_page( 'options-general.php', $page_title, $menu_title, $capability, $menu_slug, $function, $position );
}
更新日志：
用戶貢獻(xiàn)的筆記
（由Codex - 5年前貢獻(xiàn)）
面向?qū)ο蟮倪x項(xiàng)頁面助手/視圖
/**
* Class for registering a new settings page under Settings.
*/
class WPDocs_Options_Page {
/**
* Constructor.
*/
function __construct() {
add_action( 'admin_menu', array( $this, 'admin_menu' ) );
}
/**
* Registers a new settings page under Settings.
*/
function admin_menu() {
add_options_page(
__( 'Page Title', 'textdomain' ),
__( 'Circle Tree Login', 'textdomain' ),
'manage_options',
'options_page_slug',
array(
$this,
'settings_page'
)
);
}
/**
* Settings page display callback.
*/
function settings_page() {
echo __( 'This is the page content', 'textdomain' );
}
}
new WPDocs_Options_Page;
（由Codex - 5年前貢獻(xiàn)）
基本的例子
典型用法出現(xiàn)在注冊了' admin_menu '鉤子的函數(shù)中(參見添加管理菜單):
/**
* Registers a new options page under Settings.
*/
function wpdocs_my_plugin_menu() {
add_options_page(
__( 'My Options', 'textdomain' ),
__( 'My Plugin', 'textdomain' ),
'manage_options',
'my-plugin.php',
'my_plugin_page'
);
}
