WP_Customize_Manager::add_panel() – Method

Adds a customize panel.

Description

Parameters

$idWP_Customize_Panel|stringrequired: Customize Panel object, or ID.
$argsarrayoptional: Array of properties for the new Panel object.
See WP_Customize_Panel::__construct() for information on accepted arguments.
Default:array()

Return

WP_Customize_Panel The instance of the panel that was added.

Source

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;
}

View all references View on Trac View on GitHub

Uses	Description
WP_Customize_Panel::__construct()`wp-includes/class-wp-customize-panel.php`	Constructor.

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.

User Contributed Notes

Skip to note 3 content

NateWr 9 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Example usage:
```
$wp_customize->add_panel( 'panel_id', array(
    'priority'       => 10,
    'capability'     => 'edit_theme_options',
    'theme_supports' => '',
    'title'          => '',
    'description'    => '',
) );
```
Log in to add feedback
Skip to note 4 content

Ben 4 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
If you are wondering why your panel is visible but disappears after the customizer is fully loaded, it is probably because you added the ‘customizer_register’ action only when is_admin() is true.

Do this instead:
```
if ( is_admin() || is_customize_preview() ) {
    add_action( 'customize_register', 'wpdocs_your_customize_register' );
}
```
Now your panel will not be hidden when the customizer is fully loaded.
Log in to add feedback

WP_Customize_Manager::add_panel( WP_Customize_Panel|string $id, array $args = array() ): WP_Customize_Panel

In this article

Description

See also

Parameters

Return

Source

Changelog

User Contributed Notes