WP_Customize_Setting::post_value( mixed $default_value = null ): mixed

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_value mixed Optional: A default value which is used as a fallback.

Default: null

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

File: wp-includes/class-wp-customize-setting.php. View all references

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

Used By
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.