add_settings_section()
add_settings_section( string $id, string $title, callab…
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_部分示例
类别:WordPress 函数手册、
本文收集自互联网,转载请注明来源。
如有侵权,请联系 wper_net@163.com 删除。
还没有任何评论,赶紧来占个楼吧!