WP_Customize_Setting::post_value() WordPress Method
The WP_Customize_Setting::post_value() method is used to retrieve the value of a setting from the current POST request. This is useful for previewing changes to a setting before they are saved.
WP_Customize_Setting::post_value( mixed $default_value = null ) #
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.
Parameters
- $default_value
(mixed)(Optional)A default value which is used as a fallback.
Default value: null
Return
(mixed) The default value on failure, otherwise the sanitized and validated value.
Source
File: wp-includes/class-wp-customize-setting.php
final public function post_value( $default_value = null ) {
return $this->manager->post_value( $this, $default_value );
}
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| 3.4.0 | Introduced. |