On this page
WP_Customize_Manager::add_panel( WP_Customize_Panel|string $id, array $args = array() ): WP_Customize_Panel
Adds a customize panel.
Description
See also
Parameters
$idWP_Customize_Panel|string Required-
Customize Panel object, or ID.
$argsarray Optional-
Array of properties for the new Panel object.
See WP_Customize_Panel::__construct() for information on accepted arguments.More Arguments from WP_Customize_Panel::__construct( ... $args )
Array of properties for the new Panel object.
priorityintPriority of the panel, defining the display order of panels and sections. Default 160.capabilitystringCapability required for the panel.
Defaultedit_theme_options.theme_supportsmixed[]Theme features required to support the panel.titlestringTitle of the panel to show in UI.descriptionstringDescription to show in the UI.typestringType of the panel.active_callbackcallableActive callback.
Default:
array()
Return
WP_Customize_Panel The instance of the panel that was added.
Source
File: wp-includes/class-wp-customize-manager.php. View all references
public function add_panel( $id, $args = array() ) {
if ( $id instanceof WP_Customize_Panel ) {
$panel = $id;
} else {
$panel = new WP_Customize_Panel( $this, $id, $args );
}
$this->panels[ $panel->id ] = $panel;
return $panel;
}
Related
Uses
| Uses | Description |
|---|---|
| WP_Customize_Panel::__construct() wp-includes/class-wp-customize-panel.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_Panel instance. |
| 4.0.0 | Introduced. |
© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_customize_manager/add_panel