Adds a customize control.

• WP_Customize_Control::__construct()

$id WP_Customize_Control|string Required

Customize Control object, or ID.

$args array Optional

Array of properties for the new Control object.
See WP_Customize_Control::__construct() for information on accepted arguments.

More Arguments from WP_Customize_Control::__construct( ... $args )

Array of properties for the new Control object.

• instance_numberint
  Order in which this instance was created in relation to other instances.
• managerWP_Customize_Manager
  Customizer bootstrap instance.
• idstring
  Control ID.
• settingsarray
  All settings tied to the control. If undefined, $id will be used.
• settingstring
  The primary setting for the control (if there is one).
  Default 'default'.
• capabilitystring
  Capability required to use this control. Normally this is empty and the capability is derived from $settings.
• priorityint
  Order priority to load the control. Default 10.
• sectionstring
  Section the control belongs to.
• labelstring
  Label for the control.
• descriptionstring
  Description for the control.
• choicesarray
  List of choices for 'radio' or 'select' type controls, where values are the keys, and labels are the values.
  
• input_attrsarray
  List of custom input attributes for control output, where attribute names are the keys and values are the values. Not used for 'checkbox', 'radio', 'select', 'textarea', or 'dropdown-pages' control types.
• allow_additionbool
  Show UI for adding new content, currently only used for the dropdown-pages control. Default false.
• jsonarray
  Deprecated. Use WP_Customize_Control::json() instead.
• typestring
  Control type. Core controls include 'text', 'checkbox', 'textarea', 'radio', 'select', and 'dropdown-pages'. Additional input types such as 'email', 'url', 'number', 'hidden', and 'date' are supported implicitly. Default 'text'.
• active_callbackcallable
  Active callback.

Default: array()

WP_Customize_Control The instance of the control that was added.

File: wp-includes/class-wp-customize-manager.php. View all references

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