wpseek.com
A WordPress-centric search engine for devs and theme authors



get_user_by › WordPress Function

Since2.8.0
Deprecatedn/a
› get_user_by ( $field, $value )
Parameters: (2)
  • (string) $field The field to retrieve the user with. id | ID | slug | email | login.
    Required: Yes
  • (int|string) $value A value for $field. A user ID, slug, email address, or login name.
    Required: Yes
Returns:
  • (WP_User|false) WP_User object on success, false on failure.
Defined at:
Codex:
Change Log:
  • 4.4.0
  • 5.8.0

Retrieve user info by a given field



Related Functions: get_term_by, get_users, get_user_by_email, get_user_meta, get_users_of_blog

Source 

function get_user_by( $field, $value ) {
		global $current_user;

		$userdata = WP_User::get_data_by( $field, $value );

		if ( ! $userdata ) {
			return false;
		}

		if ( $current_user instanceof WP_User && $current_user->ID === (int) $userdata->ID ) {
			return $current_user;
		}

		$user = new WP_User;
		$user->init( $userdata );

		return $user;
	}
endif;

if ( ! function_exists( 'cache_users' ) ) :
	/**
	 * Retrieve info for user lists to prevent multiple queries by get_userdata()
	 *
	 * @since 3.0.0
	 *
	 * @global wpdb $wpdb WordPress database abstraction object.
	 *
	 * @param array $user_ids User ID numbers list
	 */