A WordPress-centric search engine for devs and theme authors



update_user_status ›

Since3.0.0
Deprecated5.3.0
update_user_status ( $id, $pref, $value, $deprecated = null )
Parameters: (4)
  • (int) $id The user ID.
    Required: Yes
  • (string) $pref The column in the wp_users table to update the user's status in (presumably user_status, spam, or deleted).
    Required: Yes
  • (int) $value The new status for the user.
    Required: Yes
  • (null) $deprecated Deprecated as of 3.0.2 and should not be used.
    Required: No
    Default: null
See:
Returns:
  • (int) The initially passed $value.
Defined at:
Codex:

Update the status of a user in the database.

Previously used in core to mark a user as spam or "ham" (not spam) in Multisite.



Source

function update_user_status( $id, $pref, $value, $deprecated = null ) {
	global $wpdb;

	_deprecated_function( __FUNCTION__, '5.3.0', 'wp_update_user()' );

	if ( null !== $deprecated ) {
		_deprecated_argument( __FUNCTION__, '3.0.2' );
	}

	$wpdb->update( $wpdb->users, array( sanitize_key( $pref ) => $value ), array( 'ID' => $id ) );

	$user = new WP_User( $id );
	clean_user_cache( $user );

	if ( $pref == 'spam' ) {
		if ( $value == 1 ) {
			/** This filter is documented in wp-includes/user.php */
			do_action( 'make_spam_user', $id );
		} else {
			/** This filter is documented in wp-includes/user.php */
			do_action( 'make_ham_user', $id );
		}
	}

	return $value;
}