get_user_by

Definition:
function get_user_by( $field, $value ) {}

Retrieve user info by a given field

Parameters

  • string $field: The field to retrieve the user with. id | slug | email | login
  • int|string $value: A value for $field. A user ID, slug, email address, or login name.

Return values

returns:on failure, WP_User object on success

Source code

function get_user_by( $field, $value ) {

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



	if ( !$userdata )

		return false;



	$user = new WP_User;

	$user->init( $userdata );



	return $user;

}

1889

get_users_of_blog

Definition:
function get_users_of_blog( $id = '' ) {}

Get users for the blog.
For setups that use the multi-blog feature. Can be used outside of the multi-blog feature.

Parameters

  • int $id: Blog ID.

Return values

returns:List of users that are part of that Blog ID

Source code

function get_users_of_blog( $id = '' ) {

	global $wpdb, $blog_id;

	if ( empty($id) )

		$id = (int) $blog_id;

	$blog_prefix = $wpdb->get_blog_prefix($id);

	$users = $wpdb->get_results( "SELECT user_id, user_id AS ID, user_login, display_name, user_email, meta_value FROM $wpdb->users, $wpdb->usermeta WHERE {$wpdb->users}.ID = {$wpdb->usermeta}.user_id AND meta_key = '{$blog_prefix}capabilities' ORDER BY {$wpdb->usermeta}.user_id" );

1887

get_users_drafts

Definition:
function get_users_drafts( $user_id ) {}

Retrieve the user’s drafts.

Parameters

  • int $user_id: User ID.

Defined filters

  • get_users_drafts
    apply_filters('get_users_drafts', $query)

Source code

function get_users_drafts( $user_id ) {

	global $wpdb;

	$query = $wpdb->prepare("SELECT ID, post_title FROM $wpdb->posts WHERE post_type = 'post' AND post_status = 'draft' AND post_author = %d ORDER BY post_modified DESC", $user_id);

	$query = apply_filters('get_users_drafts', $query);

	return $wpdb->get_results( $query );

}

1885

get_usernumposts

Definition:
function get_usernumposts( $userid ) {}

Number of posts user has written.

Parameters

  • $userid

Source code

function get_usernumposts( $userid ) {

	_deprecated_function( __FUNCTION__, '3.0', 'count_user_posts()' );

	return count_user_posts( $userid );

}

1883

get_usermeta

Definition:
function get_usermeta( $user_id, $meta_key = '' ) {}

Retrieve user metadata.
If $user_id is not a number, then the function will fail over with a ‘false’ boolean return value. Other returned values depend on whether there is only one item to be returned, which be that single item type. If there is more than one metadata value, then it will be list of metadata values.

Parameters

  • int $user_id: User ID
  • string $meta_key: Optional. Metadata key.

Source code

function get_usermeta( $user_id, $meta_key = '' ) {

	_deprecated_function( __FUNCTION__, '3.0', 'get_user_meta()' );

	global $wpdb;

	$user_id = (int) $user_id;



	if ( !$user_id )

		return false;



	if ( !empty($meta_key) ) {

		$meta_key = preg_replace('|[^a-z0-9_]|i', '', $meta_key);

		$user = wp_cache_get($user_id, 'users');

		// Check the cached user object

		if ( false !== $user && isset($user->$meta_key) )

			$metas = array($user->$meta_key);

		else

			$metas = $wpdb->get_col( $wpdb->prepare("SELECT meta_value FROM $wpdb->usermeta WHERE user_id = %d AND meta_key = %s", $user_id, $meta_key) );

	} else {

		$metas = $wpdb->get_col( $wpdb->prepare("SELECT meta_value FROM $wpdb->usermeta WHERE user_id = %d", $user_id) );

	}



	if ( empty($metas) ) {

		if ( empty($meta_key) )

			return array();

		else

			return '';

	}



	$metas = array_map('maybe_unserialize', $metas);



	if ( count($metas) == 1 )

		return $metas[0];

	else

		return $metas;

}

1881