Functions
	get_user ($guid)
	Get a user object from a GUID. More...

	get_user_by_username ($username)
	Get user by username. More...

	get_user_by_email ($email)
	Get an array of users from an email address. More...

	elgg_request_new_password (\ElggUser $user)
	Generate and send a password request email to a given user's registered email address. More...

	elgg_save_new_password (\ElggUser $user, string $conf_code, string $password=null)
	Validate and change password for a user. More...

	elgg_generate_password ()
	Generate a random 12 character clear text password. More...

	elgg_register_user (array $params=[])
	Registers a user. More...

	elgg_validate_registration_data ($username, $password, $name, $email, $allow_multiple_emails=false)
	Assert that given registration details are valid and can be used to register the user. More...

	elgg_generate_invite_code (string $username)
	Generates a unique invite code for a user. More...

	elgg_validate_invite_code ($username, $code)
	Validate a user's invite code. More...

	elgg_get_registration_url (array $parameters=[], $fragment= '')
	Returns site's registration URL Triggers a 'registration_url', 'site' plugin hook that can be used by plugins to alter the default registration URL and append query elements, such as an invitation code and inviting user's guid. More...

	elgg_get_login_url (array $query=[], $fragment= '')
	Returns site's login URL Triggers a 'login_url', 'site' plugin hook that can be used by plugins to alter the default login URL. More...

	elgg_get_user_by_persistent_token (string $token)
	Get a user based on a persistent login token. More...

Function Documentation

elgg_generate_invite_code ( string $username )

Generates a unique invite code for a user.

Parameters

string $username The username of the user sending the invitation

Returns: string Invite code

See also: elgg_validate_invite_code()

Since: 4.3

Definition at line 141 of file users.php.

elgg_generate_password ( )

Generate a random 12 character clear text password.

Returns: string

Since: 4.3

Definition at line 91 of file users.php.

elgg_get_login_url	(	array	$query = `[]`,
			$fragment = `''`
	)

Returns site's login URL Triggers a 'login_url', 'site' plugin hook that can be used by plugins to alter the default login URL.

Parameters

array	$query	An array of query elements
string	$fragment	Fragment identifier (e.g. login-dropdown-box)

Returns: string

Definition at line 185 of file users.php.

elgg_get_registration_url	(	array	$parameters = `[]`,
			$fragment = `''`
	)

Returns site's registration URL Triggers a 'registration_url', 'site' plugin hook that can be used by plugins to alter the default registration URL and append query elements, such as an invitation code and inviting user's guid.

Parameters

array	$parameters	An array of query elements
string	$fragment	Fragment identifier

Returns: string

Definition at line 170 of file users.php.

elgg_get_user_by_persistent_token ( string $token )

Get a user based on a persistent login token.

Please note the token should be the raw token, not hashed in any way.

Parameters

string $token the persistent token

Returns: |null

Since: 4.1

Definition at line 201 of file users.php.

elgg_register_user ( array $params = [] )

Registers a user.

Parameters

array $params Array of options with keys: (string) username => The username of the new user (string) password => The password (string) name => The user's display name (string) email => The user's email address (string) subtype => (optional) Subtype of the user entity (string) language => (optional) user language (defaults to current language) (bool) allow_multiple_emails => (optional) Allow the same email address to be registered multiple times (default false) (bool) validated => (optional) Is the user validated (default true)

Returns

Exceptions

RegistrationException

Definition at line 111 of file users.php.

elgg_request_new_password ( \ElggUser $user )

Generate and send a password request email to a given user's registered email address.

Parameters

\ElggUser $user the user to notify

Returns: void

Since: 4.3

Definition at line 65 of file users.php.

elgg_save_new_password	(	\ElggUser	$user,
		string	$conf_code,
		string	$password = `null`
	)

Validate and change password for a user.

Parameters

\ElggUser	$user	The user
string	$conf_code	Confirmation code as sent in the request email.
string	$password	Optional new password, if not randomly generated.

Returns: bool

Since: 4.3

Definition at line 80 of file users.php.

elgg_validate_invite_code	(	$username,
		$code
	)

Validate a user's invite code.

Parameters

string	$username	The username
string	$code	The invite code

Returns: bool

See also: elgg_generate_invite_code()

Since: 1.10

Definition at line 155 of file users.php.

elgg_validate_registration_data	(	$username,
		$password,
		$name,
		$email,
		$allow_multiple_emails = `false`
	)

Assert that given registration details are valid and can be used to register the user.

Parameters

string	$username	The username of the new user
string \| array	$password	The password Can be an array [$password, $confirm_password]
string	$name	The user's display name
string	$email	The user's email address
bool	$allow_multiple_emails	Allow the same email address to be registered multiple times?

Returns

Definition at line 128 of file users.php.

get_user ( $guid )

Get a user object from a GUID.

This function returns an from a given GUID.

Parameters

int $guid The GUID

Returns: |false

Definition at line 20 of file users.php.

get_user_by_email ( $email )

Get an array of users from an email address.

Parameters

string $email Email address.

Returns: array

Definition at line 52 of file users.php.

get_user_by_username ( $username )

Get user by username.

Parameters

string $username The user's username

Returns: |false Depending on success

Definition at line 41 of file users.php.

Functions

Function Documentation