get_user_id_from_string

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

WordPress Version: 6.2

/**
 * Get a numeric user ID from either an email address or a login.
 *
 * A numeric string is considered to be an existing user ID
 * and is simply returned as such.
 *
 * @since MU (3.0.0)
 * @deprecated 3.6.0 Use get_user_by()
 * @see get_user_by()
 *
 * @param string $email_or_login Either an email address or a login.
 * @return int
 */
function get_user_id_from_string($email_or_login)
{
    _deprecated_function(__FUNCTION__, '3.6.0', 'get_user_by()');
    if (is_email($email_or_login)) {
        $user = get_user_by('email', $email_or_login);
    } elseif (is_numeric($email_or_login)) {
        return $email_or_login;
    } else {
        $user = get_user_by('login', $email_or_login);
    }
    if ($user) {
        return $user->ID;
    }
    return 0;
}

WordPress Version: 4.9

/**
 * Get a numeric user ID from either an email address or a login.
 *
 * A numeric string is considered to be an existing user ID
 * and is simply returned as such.
 *
 * @since MU (3.0.0)
 * @deprecated 3.6.0 Use get_user_by()
 * @see get_user_by()
 *
 * @param string $string Either an email address or a login.
 * @return int
 */
function get_user_id_from_string($string)
{
    _deprecated_function(__FUNCTION__, '3.6.0', 'get_user_by()');
    if (is_email($string)) {
        $user = get_user_by('email', $string);
    } elseif (is_numeric($string)) {
        return $string;
    } else {
        $user = get_user_by('login', $string);
    }
    if ($user) {
        return $user->ID;
    }
    return 0;
}

WordPress Version: 4.6

/**
 * Get a numeric user ID from either an email address or a login.
 *
 * A numeric string is considered to be an existing user ID
 * and is simply returned as such.
 *
 * @since MU
 * @deprecated 3.6.0 Use get_user_by()
 * @see get_user_by()
 *
 * @param string $string Either an email address or a login.
 * @return int
 */
function get_user_id_from_string($string)
{
    _deprecated_function(__FUNCTION__, '3.6.0', 'get_user_by()');
    if (is_email($string)) {
        $user = get_user_by('email', $string);
    } elseif (is_numeric($string)) {
        return $string;
    } else {
        $user = get_user_by('login', $string);
    }
    if ($user) {
        return $user->ID;
    }
    return 0;
}

WordPress Version: 4.4

/**
 * Get a numeric user ID from either an email address or a login.
 *
 * A numeric string is considered to be an existing user ID
 * and is simply returned as such.
 *
 * @since MU
 * @deprecated 3.6.0 Use get_user_by()
 * @see get_user_by()
 *
 * @param string $string Either an email address or a login.
 * @return int
 */
function get_user_id_from_string($string)
{
    _deprecated_function(__FUNCTION__, '3.6', 'get_user_by()');
    if (is_email($string)) {
        $user = get_user_by('email', $string);
    } elseif (is_numeric($string)) {
        return $string;
    } else {
        $user = get_user_by('login', $string);
    }
    if ($user) {
        return $user->ID;
    }
    return 0;
}

WordPress Version: 4.1

/**
 * Get a numeric user ID from either an email address or a login.
 *
 * A numeric string is considered to be an existing user ID
 * and is simply returned as such.
 *
 * @since MU
 * @deprecated 3.6.0
 * @deprecated Use get_user_by()
 *
 * @param string $string Either an email address or a login.
 * @return int
 */
function get_user_id_from_string($string)
{
    _deprecated_function(__FUNCTION__, '3.6', 'get_user_by()');
    if (is_email($string)) {
        $user = get_user_by('email', $string);
    } elseif (is_numeric($string)) {
        return $string;
    } else {
        $user = get_user_by('login', $string);
    }
    if ($user) {
        return $user->ID;
    }
    return 0;
}

WordPress Version: 3.7

/**
 * Get a numeric user ID from either an email address or a login.
 *
 * A numeric string is considered to be an existing user ID
 * and is simply returned as such.
 *
 * @since MU
 * @deprecated 3.6.0
 * @deprecated Use get_user_by()
 * @uses get_user_by()
 *
 * @param string $string Either an email address or a login.
 * @return int
 */
function get_user_id_from_string($string)
{
    _deprecated_function(__FUNCTION__, '3.6', 'get_user_by()');
    if (is_email($string)) {
        $user = get_user_by('email', $string);
    } elseif (is_numeric($string)) {
        return $string;
    } else {
        $user = get_user_by('login', $string);
    }
    if ($user) {
        return $user->ID;
    }
    return 0;
}