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

Add a customize control.


Description Description

See also See also


Top ↑

Parameters Parameters

$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.

Default value: array()


Top ↑

Return Return

(WP_Customize_Control) The instance of the control that was added.


Top ↑

Source Source

File: wp-includes/class-wp-customize-manager.php

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


Top ↑

Changelog Changelog

Changelog
Version Description
4.5.0 Return added WP_Customize_Control instance.
3.4.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    Contributed by Marcio Zebedeu

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

You must log in before being able to contribute a note or feedback.