1. 首页
  2. WordPress 函数手册

add_settings_section()

add_settings_section( string $id, string $title, callable $callback, string $page )

将新分区添加到设置页。
Add a new section to a settings page.

目录锚点:#说明#参数#返回#源码#笔记


说明(Description)

设置API的一部分。使用此选项可为管理页定义新的设置节。使用do_settings_sections()在管理页回调函数中显示设置节。使用Add_settings_field()将设置字段添加到分区中。

$callback参数应该是一个函数的名称,该函数在实际字段之前回显要显示在设置部分顶部的任何内容。如果你想的话,它什么也不能输出。


参数(Parameters)

参数 类型 必填 说明
$id (string) 必需 用于标识节的段塞名称。用于标记的“id”属性中。
$title (string) 必需 节的格式化标题。显示为该节的标题。
$callback (callable) 必需 在节的顶部(在标题和字段之间)回显任何内容的函数。
$page (string) 必需 显示节的设置页的slug名称。内置页面包括“常规”、“阅读”、“写作”、“讨论”、“媒体”等。使用add_options_page()创建自己的页面;

返回(Return)

无返回值


源码(Source)

/**
 * Add a new section to a settings page.
 *
 * Part of the Settings API. Use this to define new settings sections for an admin page.
 * Show settings sections in your admin page callback function with do_settings_sections().
 * Add settings fields to your section with add_settings_field()
 *
 * The $callback argument should be the name of a function that echoes out any
 * content you want to show at the top of the settings section before the actual
 * fields. It can output nothing if you want.
 *
 * @since 2.7.0
 *
 * @global $wp_settings_sections Storage array of all settings sections added to admin pages
 *
 * @param string $id       Slug-name to identify the section. Used in the 'id' attribute of tags.
 * @param string $title    Formatted title of the section. Shown as the heading for the section.
 * @param string $callback Function that echos out any content at the top of the section (between heading and fields).
 * @param string $page     The slug-name of the settings page on which to show the section. Built-in pages include 'general', 'reading', 'writing', 'discussion', 'media', etc. Create your own using add_options_page();
 */
function add_settings_section($id, $title, $callback, $page) {
	global $wp_settings_sections;

	if ( 'misc' == $page ) {
		_deprecated_argument( __FUNCTION__, '3.0', sprintf( __( 'The "%s" options group has been removed. Use another settings group.' ), 'misc' ) );
		$page = 'general';
	}

	if ( 'privacy' == $page ) {
		_deprecated_argument( __FUNCTION__, '3.5', 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);
}
更新版本 源码位置 使用 被使用
2.7.0 wp-admin/includes/template.php:1509 0 2

笔记(Notes)

示例用法
php类的add_settings_部分示例

add_settings_section() 为WP2原创文章,链接:https://www.wp2.cn/functions/add_settings_section/

发表评论

您的电子邮箱地址不会被公开。