将新部分添加到设置页面。
原型
add_settings_section( string $id, string $title, callable $callback, string $page )
描述
Settings API的一部分。使用此选项可为管理页面定义新设置部分。使用do_settings_sections()在管理页面回调函数中显示设置部分。使用add_settings_field()将设置字段添加到你的部分
参数
$id
(string)
(Required)
Slug-name来标识该部分。用于标记的“id”属性。
$title
(string)
(Required)
该部分的格式化标题。显示为该部分的标题。
$callback
(callable)
(Required)
回显该部分顶部(标题和字段之间)的任何内容的功能。
$page
(string)
(Required)
设置页面的slug-name,用于显示该部分。内置页面包括“常规”,“阅读”,“书写”,“讨论”,“媒体”等。使用add_options_page()创建自己的页面。
源文件
路径:wp-admin/includes/template.php
<?php
...
function add_settings_section($id, $title, $callback, $page) {
global $wp_settings_sections;
if ( 'misc' == $page ) {
_deprecated_argument( __FUNCTION__, '3.0.0',
/* translators: %s: misc */
sprintf( __( 'The "%s" options group has been removed. Use another settings group.' ),
'misc'
)
);
$page = 'general';
}
if ( 'privacy' == $page ) {
_deprecated_argument( __FUNCTION__, '3.5.0',
/* translators: %s: privacy */
sprintf( __( 'The "%s" options group has been removed. Use another settings group.' ),
'privacy'
)
);
$page = 'reading';
}
$wp_settings_sections[$page][$id] = array('id' => $id, 'title' => $title, 'callback' => $callback);
}
...
?>
其他
英文文档:https://developer.wordpress.org/reference/functions/add_settings_section/