user_pass_ok

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

WordPress Version: 4.6

/**
 * Check that the user login name and password is correct.
 *
 * @since 0.71
 * @deprecated 3.5.0 Use wp_authenticate()
 * @see wp_authenticate()
 *
 * @param string $user_login User name.
 * @param string $user_pass User password.
 * @return bool False if does not authenticate, true if username and password authenticates.
 */
function user_pass_ok($user_login, $user_pass)
{
    _deprecated_function(__FUNCTION__, '3.5.0', 'wp_authenticate()');
    $user = wp_authenticate($user_login, $user_pass);
    if (is_wp_error($user)) {
        return false;
    }
    return true;
}

WordPress Version: 4.4

/**
 * Check that the user login name and password is correct.
 *
 * @since 0.71
 * @deprecated 3.5.0 Use wp_authenticate()
 * @see wp_authenticate()
 *
 * @param string $user_login User name.
 * @param string $user_pass User password.
 * @return bool False if does not authenticate, true if username and password authenticates.
 */
function user_pass_ok($user_login, $user_pass)
{
    _deprecated_function(__FUNCTION__, '3.5', 'wp_authenticate()');
    $user = wp_authenticate($user_login, $user_pass);
    if (is_wp_error($user)) {
        return false;
    }
    return true;
}

WordPress Version: 3.7

/**
 * Check that the user login name and password is correct.
 *
 * @since 0.71
 * @deprecated 3.5.0
 * @deprecated Use wp_authenticate()
 * @see wp_authenticate()
 *
 * @param string $user_login User name.
 * @param string $user_pass User password.
 * @return bool False if does not authenticate, true if username and password authenticates.
 */
function user_pass_ok($user_login, $user_pass)
{
    _deprecated_function(__FUNCTION__, '3.5', 'wp_authenticate()');
    $user = wp_authenticate($user_login, $user_pass);
    if (is_wp_error($user)) {
        return false;
    }
    return true;
}