WP_Customize_Setting::post_value() – Method

Fetch and sanitize the $_POST value for the setting.

Description

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

$default_valuemixedoptional: A default value which is used as a fallback.
Default:null

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

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

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

Version	Description
3.4.0	Introduced.