W3cubDocs

WP_Customize_Setting::post_value( mixed $default = null )

Fetch and sanitize the $_POST value for the setting.

During a save request prior to save, post_value() provides the new value while value() does not.

$default

(mixed) (Optional) A default value which is used as a fallback.

Default value: null

(mixed) The default value on failure, otherwise the sanitized and validated value.

final public function post_value( $default = null ) {
		return $this->manager->post_value( $this, $default );
	}

Used By	Description
wp-includes/class-wp-customize-setting.php: WP_Customize_Setting::value()	Fetch the value of the setting.
wp-includes/class-wp-customize-setting.php: WP_Customize_Setting::preview()	Add filters to supply the setting’s value when accessed.
wp-includes/class-wp-customize-setting.php: WP_Customize_Setting::_preview_filter()	Callback function to filter non-multidimensional theme mods and options.
wp-includes/class-wp-customize-setting.php: WP_Customize_Setting::save()	Checks user capabilities and theme supports, and then saves the value of the setting.

Version	Description
3.4.0	Introduced.