WP_Customize_Manager::set_post_value()
Overrides a setting's value in the current customized state.
The name "post_value" is a carry-over from when the customized state was exclusively sourced from $_POST['customized'].
Method of the class: WP_Customize_Manager{}
Hooks from the method
Return
null
. Nothing (null).
Usage
$WP_Customize_Manager = new WP_Customize_Manager(); $WP_Customize_Manager->set_post_value( $setting_id, $value );
- $setting_id(string) (required)
- ID for the WP_Customize_Setting instance.
- $value(mixed) (required)
- Post value.
Changelog
Since 4.2.0 | Introduced. |
WP_Customize_Manager::set_post_value() WP Customize Manager::set post value code WP 6.5.2
public function set_post_value( $setting_id, $value ) { $this->unsanitized_post_values(); // Populate _post_values from $_POST['customized']. $this->_post_values[ $setting_id ] = $value; /** * Announces when a specific setting's unsanitized post value has been set. * * Fires when the WP_Customize_Manager::set_post_value() method is called. * * The dynamic portion of the hook name, `$setting_id`, refers to the setting ID. * * @since 4.4.0 * * @param mixed $value Unsanitized setting post value. * @param WP_Customize_Manager $manager WP_Customize_Manager instance. */ do_action( "customize_post_value_set_{$setting_id}", $value, $this ); /** * Announces when any setting's unsanitized post value has been set. * * Fires when the WP_Customize_Manager::set_post_value() method is called. * * This is useful for `WP_Customize_Setting` instances to watch * in order to update a cached previewed value. * * @since 4.4.0 * * @param string $setting_id Setting ID. * @param mixed $value Unsanitized setting post value. * @param WP_Customize_Manager $manager WP_Customize_Manager instance. */ do_action( 'customize_post_value_set', $setting_id, $value, $this ); }