set_user_setting( string $name, string $value )
Adds or updates user interface setting.
Description
Both $name and $value can contain only ASCII letters, numbers, hyphens, and underscores.
This function has to be used before any output has started as it calls setcookie().
Parameters
- $name
-
(string) (Required) The name of the setting.
- $value
-
(string) (Required) The value for the setting.
Return
(bool|null) True if set successfully, false otherwise. Null if the current user is not a member of the site.
Source
File: wp-includes/option.php
function set_user_setting( $name, $value ) { if ( headers_sent() ) { return false; } $all_user_settings = get_all_user_settings(); $all_user_settings[ $name ] = $value; return wp_set_all_user_settings( $all_user_settings ); }
Changelog
Version | Description |
---|---|
2.8.0 | Introduced. |
© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/set_user_setting