wp_set_all_user_settings

The timeline below displays how wordpress function wp_set_all_user_settings has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 5.5

/**
 * Private. Sets all user interface settings.
 *
 * @since 2.8.0
 * @access private
 *
 * @global array $_updated_user_settings
 *
 * @param array $user_settings User settings.
 * @return bool|null True if set successfully, false if the current user could not be found.
 *                   Null if the current user is not a member of the site.
 */
function wp_set_all_user_settings($user_settings)
{
    global $_updated_user_settings;
    $user_id = get_current_user_id();
    if (!$user_id) {
        return false;
    }
    if (!is_user_member_of_blog()) {
        return;
    }
    $settings = '';
    foreach ($user_settings as $name => $value) {
        $_name = preg_replace('/[^A-Za-z0-9_-]+/', '', $name);
        $_value = preg_replace('/[^A-Za-z0-9_-]+/', '', $value);
        if (!empty($_name)) {
            $settings .= $_name . '=' . $_value . '&';
        }
    }
    $settings = rtrim($settings, '&');
    parse_str($settings, $_updated_user_settings);
    update_user_option($user_id, 'user-settings', $settings, false);
    update_user_option($user_id, 'user-settings-time', time(), false);
    return true;
}

WordPress Version: 5.4

/**
 * Private. Sets all user interface settings.
 *
 * @since 2.8.0
 * @access private
 *
 * @global array $_updated_user_settings
 *
 * @param array $user_settings User settings.
 * @return bool|null False if the current user can't be found, null if the current
 *                   user is not a super admin or a member of the site, otherwise true.
 */
function wp_set_all_user_settings($user_settings)
{
    global $_updated_user_settings;
    $user_id = get_current_user_id();
    if (!$user_id) {
        return false;
    }
    if (!is_user_member_of_blog()) {
        return;
    }
    $settings = '';
    foreach ($user_settings as $name => $value) {
        $_name = preg_replace('/[^A-Za-z0-9_-]+/', '', $name);
        $_value = preg_replace('/[^A-Za-z0-9_-]+/', '', $value);
        if (!empty($_name)) {
            $settings .= $_name . '=' . $_value . '&';
        }
    }
    $settings = rtrim($settings, '&');
    parse_str($settings, $_updated_user_settings);
    update_user_option($user_id, 'user-settings', $settings, false);
    update_user_option($user_id, 'user-settings-time', time(), false);
    return true;
}

WordPress Version: 5.3

/**
 * Private. Set all user interface settings.
 *
 * @since 2.8.0
 * @access private
 *
 * @global array $_updated_user_settings
 *
 * @param array $user_settings User settings.
 * @return bool|null False if the current user can't be found, null if the current
 *                   user is not a super admin or a member of the site, otherwise true.
 */
function wp_set_all_user_settings($user_settings)
{
    global $_updated_user_settings;
    $user_id = get_current_user_id();
    if (!$user_id) {
        return false;
    }
    if (!is_user_member_of_blog()) {
        return;
    }
    $settings = '';
    foreach ($user_settings as $name => $value) {
        $_name = preg_replace('/[^A-Za-z0-9_-]+/', '', $name);
        $_value = preg_replace('/[^A-Za-z0-9_-]+/', '', $value);
        if (!empty($_name)) {
            $settings .= $_name . '=' . $_value . '&';
        }
    }
    $settings = rtrim($settings, '&');
    parse_str($settings, $_updated_user_settings);
    update_user_option($user_id, 'user-settings', $settings, false);
    update_user_option($user_id, 'user-settings-time', time(), false);
    return true;
}

WordPress Version: 4.8

/**
 * Private. Set all user interface settings.
 *
 * @since 2.8.0
 * @access private
 *
 * @global array $_updated_user_settings
 *
 * @param array $user_settings User settings.
 * @return bool|null False if the current user can't be found, null if the current
 *                   user is not a super admin or a member of the site, otherwise true.
 */
function wp_set_all_user_settings($user_settings)
{
    global $_updated_user_settings;
    if (!$user_id = get_current_user_id()) {
        return false;
    }
    if (!is_user_member_of_blog()) {
        return;
    }
    $settings = '';
    foreach ($user_settings as $name => $value) {
        $_name = preg_replace('/[^A-Za-z0-9_-]+/', '', $name);
        $_value = preg_replace('/[^A-Za-z0-9_-]+/', '', $value);
        if (!empty($_name)) {
            $settings .= $_name . '=' . $_value . '&';
        }
    }
    $settings = rtrim($settings, '&');
    parse_str($settings, $_updated_user_settings);
    update_user_option($user_id, 'user-settings', $settings, false);
    update_user_option($user_id, 'user-settings-time', time(), false);
    return true;
}

WordPress Version: 4.6

/**
 * Private. Set all user interface settings.
 *
 * @since 2.8.0
 * @access private
 *
 * @global array $_updated_user_settings
 *
 * @param array $user_settings User settings.
 * @return bool|null False if the current user can't be found, null if the current
 *                   user is not a super admin or a member of the site, otherwise true.
 */
function wp_set_all_user_settings($user_settings)
{
    global $_updated_user_settings;
    if (!$user_id = get_current_user_id()) {
        return false;
    }
    if (is_super_admin() && !is_user_member_of_blog()) {
        return;
    }
    $settings = '';
    foreach ($user_settings as $name => $value) {
        $_name = preg_replace('/[^A-Za-z0-9_-]+/', '', $name);
        $_value = preg_replace('/[^A-Za-z0-9_-]+/', '', $value);
        if (!empty($_name)) {
            $settings .= $_name . '=' . $_value . '&';
        }
    }
    $settings = rtrim($settings, '&');
    parse_str($settings, $_updated_user_settings);
    update_user_option($user_id, 'user-settings', $settings, false);
    update_user_option($user_id, 'user-settings-time', time(), false);
    return true;
}

WordPress Version: 4.4

/**
 * Private. Set all user interface settings.
 *
 * @since 2.8.0
 *
 * @global array $_updated_user_settings
 *
 * @param array $user_settings
 * @return bool|void
 */
function wp_set_all_user_settings($user_settings)
{
    global $_updated_user_settings;
    if (!$user_id = get_current_user_id()) {
        return false;
    }
    if (is_super_admin() && !is_user_member_of_blog()) {
        return;
    }
    $settings = '';
    foreach ($user_settings as $name => $value) {
        $_name = preg_replace('/[^A-Za-z0-9_-]+/', '', $name);
        $_value = preg_replace('/[^A-Za-z0-9_-]+/', '', $value);
        if (!empty($_name)) {
            $settings .= $_name . '=' . $_value . '&';
        }
    }
    $settings = rtrim($settings, '&');
    parse_str($settings, $_updated_user_settings);
    update_user_option($user_id, 'user-settings', $settings, false);
    update_user_option($user_id, 'user-settings-time', time(), false);
    return true;
}

WordPress Version: 4.3

/**
 * Private. Set all user interface settings.
 *
 * @since 2.8.0
 *
 * @global array $_updated_user_settings
 *
 * @param array $user_settings
 * @return bool|void
 */
function wp_set_all_user_settings($user_settings)
{
    global $_updated_user_settings;
    if (!$user_id = get_current_user_id()) {
        return false;
    }
    if (is_super_admin() && !is_user_member_of_blog()) {
        return;
    }
    $settings = '';
    foreach ($user_settings as $name => $value) {
        $_name = preg_replace('/[^A-Za-z0-9_]+/', '', $name);
        $_value = preg_replace('/[^A-Za-z0-9_]+/', '', $value);
        if (!empty($_name)) {
            $settings .= $_name . '=' . $_value . '&';
        }
    }
    $settings = rtrim($settings, '&');
    parse_str($settings, $_updated_user_settings);
    update_user_option($user_id, 'user-settings', $settings, false);
    update_user_option($user_id, 'user-settings-time', time(), false);
    return true;
}

WordPress Version: 4.1

/**
 * Private. Set all user interface settings.
 *
 * @since 2.8.0
 *
 * @param array $user_settings
 * @return null|bool
 */
function wp_set_all_user_settings($user_settings)
{
    global $_updated_user_settings;
    if (!$user_id = get_current_user_id()) {
        return false;
    }
    if (is_super_admin() && !is_user_member_of_blog()) {
        return;
    }
    $settings = '';
    foreach ($user_settings as $name => $value) {
        $_name = preg_replace('/[^A-Za-z0-9_]+/', '', $name);
        $_value = preg_replace('/[^A-Za-z0-9_]+/', '', $value);
        if (!empty($_name)) {
            $settings .= $_name . '=' . $_value . '&';
        }
    }
    $settings = rtrim($settings, '&');
    parse_str($settings, $_updated_user_settings);
    update_user_option($user_id, 'user-settings', $settings, false);
    update_user_option($user_id, 'user-settings-time', time(), false);
    return true;
}

WordPress Version: 3.9

/**
 * Private. Set all user interface settings.
 *
 * @since 2.8.0
 *
 * @param array $user_settings
 * @return bool
 */
function wp_set_all_user_settings($user_settings)
{
    global $_updated_user_settings;
    if (!$user_id = get_current_user_id()) {
        return false;
    }
    if (is_super_admin() && !is_user_member_of_blog()) {
        return;
    }
    $settings = '';
    foreach ($user_settings as $name => $value) {
        $_name = preg_replace('/[^A-Za-z0-9_]+/', '', $name);
        $_value = preg_replace('/[^A-Za-z0-9_]+/', '', $value);
        if (!empty($_name)) {
            $settings .= $_name . '=' . $_value . '&';
        }
    }
    $settings = rtrim($settings, '&');
    parse_str($settings, $_updated_user_settings);
    update_user_option($user_id, 'user-settings', $settings, false);
    update_user_option($user_id, 'user-settings-time', time(), false);
    return true;
}

WordPress Version: 3.7

/**
 * Private. Set all user interface settings.
 *
 * @package WordPress
 * @subpackage Option
 * @since 2.8.0
 *
 * @param array $user_settings
 * @return bool
 */
function wp_set_all_user_settings($user_settings)
{
    global $_updated_user_settings;
    if (!$user_id = get_current_user_id()) {
        return false;
    }
    if (is_super_admin() && !is_user_member_of_blog()) {
        return;
    }
    $settings = '';
    foreach ($user_settings as $name => $value) {
        $_name = preg_replace('/[^A-Za-z0-9_]+/', '', $name);
        $_value = preg_replace('/[^A-Za-z0-9_]+/', '', $value);
        if (!empty($_name)) {
            $settings .= $_name . '=' . $_value . '&';
        }
    }
    $settings = rtrim($settings, '&');
    parse_str($settings, $_updated_user_settings);
    update_user_option($user_id, 'user-settings', $settings, false);
    update_user_option($user_id, 'user-settings-time', time(), false);
    return true;
}