add_settings_section

February 11, 2011 by Thorsten 0 Comments

Definition:
function add_settings_section($id, $title, $callback, $page) {}

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()

Parameters

string $id: Slug-name to identify the section. Used in the ‘id’ attribute of tags.
string $title: Formatted title of the section. Shown as the heading for the section.
string $callback: Function that echos out any content at the top of the section (between heading and fields).
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();

Source code

function add_settings_section($id, $title, $callback, $page) {

	global $wp_settings_sections;



	if ( 'misc' == $page ) {

		_deprecated_argument( __FUNCTION__, '3.0', __( 'The miscellaneous options group has been removed. Use another settings group.' ) );

		$page = 'general';

	}



	if ( !isset($wp_settings_sections) )

		$wp_settings_sections = array();

	if ( !isset($wp_settings_sections[$page]) )

		$wp_settings_sections[$page] = array();

	if ( !isset($wp_settings_sections[$page][$id]) )

		$wp_settings_sections[$page][$id] = array();



	$wp_settings_sections[$page][$id] = array('id' => $id, 'title' => $title, 'callback' => $callback);

}

301

/wp-admin/includes/template.php, Documentation, Files, Functions, Functions by letter a

add_settings_section, id7dd17e1d85b63bb0efa19d5ca4a1c449

add_settings_field

activate_sitewide_plugin

No comments yet... Be the first to leave a reply!

Ouch, we don’t have this here!

It seems that we do not have anything about this topic here, but you might want to do one of the following. If you were searching for a php function head over to the php manual and use one of their entry points

If you were searching for a WordPress related topic and did not find it here try one of the following options.

Use the search form in the navigation bar above
Use the WordPress search

If nothing like this helps try using Google or an other search engine

Google
Bing

Golden Q&A rules

Search first

Be sure that you first search in Google, the WordPress forums, Codex or this site ( using the form in the menu ). Sharing your previous results helps narrowing down the problem if you also tell us what you found and why it didn’t serve your needs.

Be specific

Give as much details about your problem as possible. Make sure to include examples, links and context related to your problem.

Be WordPress related

This site focuses on WordPress and related topics. Please make sure that your question is related to WordPress code, functionality or other related topics.

Be nice

Please keep in mind that this is a voluntary service. Answers might not always be correct or what you expect. Please be nice and let us know if any inappropriate answers come to your attention.