WP_Customize_Manager::add_section( WP_Customize_Section|string $id, array $args = array() )
Add a customize section.
Description Description
Parameters Parameters
- $id
-
(WP_Customize_Section|string) (Required) Customize Section object, or Section ID.
- $args
-
(array) (Optional) Array of properties for the new Section object.
- 'priority'
(int) Priority of the section, defining the display order of panels and sections. Default 160. - 'panel'
(string) The panel this section belongs to (if any). - 'capability'
(string) Capability required for the section. Default 'edit_theme_options' - 'theme_supports'
(string|array) Theme features required to support the section. - 'title'
(string) Title of the section to show in UI. - 'description'
(string) Description to show in the UI. - 'type'
(string) Type of the section. - 'active_callback'
(callable) Active callback. - 'description_hidden'
(bool) Hide the description behind a help icon, instead of inline above the first control. Default false.
Default value: array()
- 'priority'
Return Return
(WP_Customize_Section) The instance of the section that was added.
Source Source
File: wp-includes/class-wp-customize-manager.php
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;
}
Expand full source code Collapse full source code View on Trac
Changelog Changelog
| Version | Description |
|---|---|
| 4.5.0 | Return added WP_Customize_Section instance. |
| 3.4.0 | Introduced. |