user_pass_ok() │ WP 0.71

Deprecated since 3.5.0. It is no longer supported and may be removed in future releases. Use wp_authenticate() instead.

Checks whether a user's login and password are valid.

Uses: wp_authenticate()

No Hooks.

Returns

bool. true or false

Usage

<?php user_pass_ok( $user_login, $user_pass ) ?>

$user_login(string) (required): User login.
$user_pass(string) (required): User password.

Examples

#1 Checking whether a user exists in the database:

if( user_pass_ok( 'leonid', 'leonid_pass' ) )
	echo "Authentication passed!";
else
	echo "Authentication failed.";

Notes

See: wp_authenticate()

Changelog

Since 0.71	Introduced.
Deprecated since 3.5.0	Use wp_authenticate()

`user_pass_ok() user pass ok` code ^{WP 7.1.3}

wp-includes/deprecated.php

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;
}