Adds a customize setting.

Description

See also

• WP_Customize_Setting::__construct()

Parameters

$idWP_Customize_Setting|stringrequired

Customize Setting object, or ID.

$argsarrayoptional

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

Default:array()

Return

Source

public function add_setting( $id, $args = array() ) {
	if ( $id instanceof WP_Customize_Setting ) {
		$setting = $id;
	} else {
		$class = 'WP_Customize_Setting';

		/** This filter is documented in wp-includes/class-wp-customize-manager.php */
		$args = apply_filters( 'customize_dynamic_setting_args', $args, $id );

		/** This filter is documented in wp-includes/class-wp-customize-manager.php */
		$class = apply_filters( 'customize_dynamic_setting_class', $class, $id, $args );

		$setting = new $class( $this, $id, $args );
	}

	$this->settings[ $setting->id ] = $setting;
	return $setting;
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘customize_dynamic_setting_args’, false|array $setting_args, string $setting_id )

Filters a dynamic setting’s constructor args.

apply_filters( ‘customize_dynamic_setting_class’, string $setting_class, string $setting_id, array $setting_args )

Allow non-statically created settings to be constructed with custom WP_Customize_Setting subclass.

Changelog