On this page
WP_Customize_Manager::add_section( WP_Customize_Section|string $id, array $args = array() ): WP_Customize_Section
Adds a customize section.
Description
See also
Parameters
$idWP_Customize_Section|string Required-
Customize Section object, or ID.
$argsarray Optional-
Array of properties for the new Section object.
See WP_Customize_Section::__construct() for information on accepted arguments.More Arguments from WP_Customize_Section::__construct( ... $args )
Array of properties for the new Section object.
priorityintPriority of the section, defining the display order of panels and sections. Default 160.panelstringThe panel this section belongs to (if any).
capabilitystringCapability required for the section.
Default'edit_theme_options'theme_supportsstring|string[]Theme features required to support the section.titlestringTitle of the section to show in UI.descriptionstringDescription to show in the UI.typestringType of the section.active_callbackcallableActive callback.description_hiddenboolHide the description behind a help icon, instead of inline above the first control.
Default false.
Default:
array()
Return
WP_Customize_Section The instance of the section that was added.
Source
File: wp-includes/class-wp-customize-manager.php. View all references
public function add_section( $id, $args = array() ) {
if ( $id instanceof WP_Customize_Section ) {
$section = $id;
} else {
$section = new WP_Customize_Section( $this, $id, $args );
}
$this->sections[ $section->id ] = $section;
return $section;
}
Related
Uses
| Uses | Description |
|---|---|
| WP_Customize_Section::__construct() wp-includes/class-wp-customize-section.php | Constructor. |
Used By
| Used By | Description |
|---|---|
| WP_Customize_Manager::register_controls() wp-includes/class-wp-customize-manager.php | Registers some default controls. |
Changelog
| Version | Description |
|---|---|
| 4.5.0 | Return added WP_Customize_Section instance. |
| 3.4.0 | Introduced. |
© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_customize_manager/add_section