WP_Customize_Manager::add_control() – Method

Adds a customize control.

Description

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

View all references View on Trac View on GitHub

Uses	Description
WP_Customize_Control::__construct()`wp-includes/class-wp-customize-control.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_Control instance.
3.4.0	Introduced.

User Contributed Notes

Skip to note 2 content

Marcio Zebedeu 5 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: -1You must log in to vote on the helpfulness of this note
basic use
```
function register_customize_sections( $wp_customize ) {

    $wp_customize->add_section( 'example', array(

       'title'=> __( 'Add Your Name', 'TextDomain' ),
       'priority' => 201
    ) );

    $wp_customize->add_setting( 'setting' );
    $wp_customize->add_control( 'setting', array(
        'id'=> 'id',
        'label' => __( 'First Name:', 'TextDomain' ),
        'section' => 'example'
    ) );
}
```
- the order is important make sure to set
  
  $wp_customize->add_setting()
  
  before
  
  $wp_customize->add_control()
  
  Angga 5 years ago
- You must run this function in the customize_register action: function register_customize_sections( $wp_customize ) { $wp_customize->add_section( 'example', array( 'title'=> __( 'Add Your Name', 'TextDomain' ), 'priority' => 201 ) ); $wp_customize->add_setting( 'setting' ); $wp_customize->add_control( 'setting', array( 'id'=> 'id', 'label' => __( 'First Name:', 'TextDomain' ), 'section' => 'example' ) ); } add_action('customize_register', 'register_customize_sections');
  
  bsevcik 3 years ago
Log in to add feedback

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

In this article

Description

See also

Parameters

Return

Source

Changelog

User Contributed Notes