Class: I2CE User

This article desrcibes the class I2CE_User.

• Extends the class: I2CE_Fuzzy.
• Location: Part of the module user in the package I2CE
• Source: Defined in the file modules/User/lib/I2CE_User.php

Variables

$userDB

The user database -- may be empty to use the database that is currently being used set base on the value of I2CE::getConfig()->database->user

• Type: protected ng $userDB

$id

• Type: public $id

$username

• Type: public $username

$password

• Type: public $password

$firstname

• Type: public $firstname

$lastname

• Type: public $lastname

$email

• Type: public $email

$role

• Type: public $role

$creator

• Type: public $creator

$md5password

• Type: public $md5password

Methods

__construct()

Create a new instance of a user.

If the id isn't given then it will be determined from the session array.

• Signature: public function __construct($id,$populate,$checkSession,$log)

Parameters:

• integer $id
  The id of the user in the database.
  • Default Value: '0'
• boolean $populate
  A flag to determine if the user should be automatically populated at creation. Defaults to true
  • Default Value: true
• boolean $checkSession
  A flag to determine if we should check the $_SESSION['userid'] for a user id. Defaults to true
  • Default Value: true
• boolean $log
  Defaults to true which means we dot record this in the login table
  • Default Value: true

addUserLog()

Add a new record to the user log for this user showing they have logged in. @global array

• Signature: private function addUserLog()

changePassword()

Change the password for this user.

This will update a user's record to change the password in the database. It checks to make sure the new password matches the confirmation.

• Signature: public function changePassword($old_password,$new_password)
• Returns: array keys are 'sucess' and 'message' the message to display back to the user signifying success or failure.

@global array Parameters:

• string $old_password
• string $new_password

displayName()

• Signature: public function displayName()
• Returns: string The first initial and last name of this user.

findUser()

• Signature: static public function findUser($field,$value,$log)

Parameters:

• $field
• $value
• boolean $log
  Defaults to false whch means we do not record this in the login table
  • Default Value: false

getId()

Get the ID of the user

• Signature: public function getId()
• Returns: integer

getPreferredLocale()

Gets the prefered locales for the user

• Signature: public function getPreferredLocale()
• Returns: $string

getRole()

Get's the role associated with a user.

• Signature: public function getRole()
• Returns: string

getUserDB()

Returns the database where the user table can be found. This will add the trailing period if it isn't already there.

• Signature: static public function getUserDB()
• Returns: string

logged_in()

Checks to see if the user is logged in.

• Signature: public function logged_in()
• Returns: boolean

login()

Login the user.

Check the login and password of the user and log them in. If the password is incorrect then an error message will be set on the {@link I2CE_Template template}. @global array

• Signature: public function login($username,$password,$template)

Parameters:

• string $username
• string $password
• I2CE_Template $template

logout()

Log the user out of the system. @global array

• Signature: public function logout()

mailPassword()

• Signature: protected function mailPassword()

populate()

Populate the member variables of this object.

This will also update the user log to show the latest activity for this login. @global array

• Signature: public function populate($update_log)

Parameters:

• boolean $update_log
  • Default Value: true

save()

Saves the user to the database.

This method saves all the user data and updates the access the user has for this system. @global array

• Signature: public function save($transact)

Parameters:

• boolean $transact
  Defaults to true meaning to wrap the save in a transaction.
  • Default Value: true

setCreator()

Set the creator id of this user.

• Signature: public function setCreator($creator)

Parameters:

• integer $creator

setId()

Sets the id of the user if not known at creation.

• Signature: public function setId($id)

Parameters:

• integer $id

setPassword()

• Signature: public function setPassword($password,$do_email)

Parameters:

• $password
• $do_email
  • Default Value: true

setPreferredLocale()

Sets the prefered locales for the user

• Signature: public function setPreferredLocale($locale)
• Returns: string $locales. false on failure string or array of strings, the locales on success

Parameters:

• string $locale

username()

Get the username

• Signature: public function username()

Inherited Fuzzy Methods

userMessage()

This method is inherited from I2CE_Fuzzy->userMessage()