将新部分添加到设置页面。

原型

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/