W3cubDocs

/WordPress

WP_Customize_Manager::add_control( WP_Customize_Control|string $id, array $args = array() ): WP_Customize_Control

Adds a customize control.

Description

See also

Parameters

$idWP_Customize_Control|stringrequired
Customize Control object, or ID.
$argsarrayoptional
Array of properties for the new Control object.
See WP_Customize_Control::__construct() for information on accepted arguments.

Default:array()

Return

WP_Customize_Control The instance of the control that was added.

Source

public function add_control( $id, $args = array() ) {
	if ( $id instanceof WP_Customize_Control ) {
		$control = $id;
	} else {
		$control = new WP_Customize_Control( $this, $id, $args );
	}

	$this->controls[ $control->id ] = $control;
	return $control;
}

Changelog

Version Description
4.5.0 Return added WP_Customize_Control instance.
3.4.0 Introduced.

© 2003–2024 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_customize_manager/add_control