Elgg\Database\UsersTable Class Reference

Public Member Functions
	__construct ()
	Constructor. More...
	getRow ($guid)
	Return the user specific details of a user by a row. More...
	disableEntities ($owner_guid)
	Disables all of a user's entities. More...
	ban ($user_guid, $reason="")
	Ban a user. More...
	unban ($user_guid)
	Unban a user. More...
	makeAdmin ($user_guid)
	Makes user $guid an admin. More...
	removeAdmin ($user_guid)
	Removes user $guid's admin flag. More...
	getByUsername ($username)
	Get user by username. More...
	getByEmail ($email)
	Get an array of users from an email address. More...
	findActive ($options=array(), $limit=10, $offset=0, $count=false)
	Return users (or the number of them) who have been active within a recent period. More...
	register ($username, $password, $name, $email, $allow_multiple_emails=false)
	Registers a user, returning false if the username already exists. More...
	generateInviteCode ($username)
	Generates a unique invite code for a user. More...
	validateInviteCode ($username, $code)
	Validate a user's invite code. More...
	setValidationStatus ($user_guid, $status, $method= '')
	Set the validation status for a user. More...
	getValidationStatus ($user_guid)
	Gets the validation status of a user. More...
	setLastAction ($user_guid)
	Sets the last action time of the given user to right now. More...
	setLastLogin ($user_guid)
	Sets the last logon time of the given user to right now. More...

Detailed Description

Definition at line 21 of file UsersTable.php.

Constructor & Destructor Documentation

Elgg\Database\UsersTable::__construct

(

)

Constructor.

Definition at line 32 of file UsersTable.php.

Member Function Documentation

Elgg\Database\UsersTable::ban	(		$user_guid,
			$reason = ""
	)

Ban a user.

Parameters

int	$user_guid	The user guid
string	$reason	A reason

Returns

bool

Definition at line 86 of file UsersTable.php.

Elgg\Database\UsersTable::disableEntities

(

$owner_guid

)

Disables all of a user's entities.

Parameters

int

$owner_guid

The owner GUID

Returns

bool Depending on success

Definition at line 59 of file UsersTable.php.

Elgg\Database\UsersTable::findActive	(		$options = array(),
			$limit = 10,
			$offset = 0,
			$count = false
	)

Return users (or the number of them) who have been active within a recent period.

Parameters

array

$options

Array of options with keys:

seconds (int) => Length of period (default 600 = 10min) limit (int) => Limit (default 10) offset (int) => Offset (default 0) count (bool) => Return a count instead of users? (default false)

Formerly this was the seconds parameter.

Parameters

int	$limit	Limit (deprecated usage, use $options)
int	$offset	Offset (deprecated usage, use $options)
bool	$count	Count (deprecated usage, use $options)

Returns

[]|int

Definition at line 309 of file UsersTable.php.

Elgg\Database\UsersTable::generateInviteCode

(

$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

validateInviteCode

Definition at line 447 of file UsersTable.php.

Elgg\Database\UsersTable::getByEmail

(

$email

)

Get an array of users from an email address.

Parameters

string

$email

Email address.

Returns

array

Definition at line 277 of file UsersTable.php.

Elgg\Database\UsersTable::getByUsername

(

$username

)

Get user by username.

Parameters

string

$username

The user's username

Returns

|false Depending on success

Definition at line 239 of file UsersTable.php.

Elgg\Database\UsersTable::getRow

(

$guid

)

Return the user specific details of a user by a row.

Parameters

int

$guid

The guid

Returns

mixed private

Definition at line 45 of file UsersTable.php.

Elgg\Database\UsersTable::getValidationStatus

(

$user_guid

)

Gets the validation status of a user.

Parameters

int

$user_guid

The user's GUID

Returns

bool|null Null means status was not set for this user.

Definition at line 496 of file UsersTable.php.

Elgg\Database\UsersTable::makeAdmin

(

$user_guid

)

Makes user $guid an admin.

Parameters

int

$user_guid

User guid

Returns

bool

Definition at line 167 of file UsersTable.php.

Elgg\Database\UsersTable::register	(		$username,
			$password,
			$name,
			$email,
			$allow_multiple_emails = false
	)

Registers a user, returning false if the username already exists.

Parameters

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
bool	$allow_multiple_emails	Allow the same email address to be registered multiple times?

Returns

int|false The new user's GUID; false on failure

Exceptions

Definition at line 378 of file UsersTable.php.

Elgg\Database\UsersTable::removeAdmin

(

$user_guid

)

Removes user $guid's admin flag.

Parameters

int

$user_guid

User GUID

Returns

bool

Definition at line 203 of file UsersTable.php.

Elgg\Database\UsersTable::setLastAction

(

$user_guid

)

Sets the last action time of the given user to right now.

Parameters

int

$user_guid

The user GUID

Returns

void

Definition at line 519 of file UsersTable.php.

Elgg\Database\UsersTable::setLastLogin

(

$user_guid

)

Sets the last logon time of the given user to right now.

Parameters

int

$user_guid

The user GUID

Returns

void

Definition at line 538 of file UsersTable.php.

Elgg\Database\UsersTable::setValidationStatus	(		$user_guid,
			$status,
			$method = ''
	)

Set the validation status for a user.

Parameters

int	$user_guid	The user's GUID
bool	$status	Validated (true) or unvalidated (false)
string	$method	Optional method to say how a user was validated

Returns

bool

Definition at line 480 of file UsersTable.php.

Elgg\Database\UsersTable::unban

(

$user_guid

)

Unban a user.

Parameters

int

$user_guid

Unban a user.

Returns

bool

Definition at line 128 of file UsersTable.php.

Elgg\Database\UsersTable::validateInviteCode	(		$username,
			$code
	)

Validate a user's invite code.

Parameters

string	$username	The username
string	$code	The invite code

Returns

bool

See also

generateInviteCode

Definition at line 461 of file UsersTable.php.

---

The documentation for this class was generated from the following file:

• engine/classes/Elgg/Database/UsersTable.php