Class: I2CE User (Development)

For other versions, see Class: I2CE_User (versions) .

This article describes the class I2CE_User .

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

Variables

$role

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 40
• Type: public mixed $role

$username

the username

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 45
• Type: public string $username

$details

@var public string $role the role associated to the user . An array of user details

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 52
• Type: protected array $details

$logged_in

flags the user as logged in

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 57
• Type: protected boolean $logged_in

$locale

@var protected string $localeThe preferred locale for the user

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 172
• Type: protected $locale

$id

. False or int, the id for this user.

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 247
• Type: protected mixed $id

$ip_address

. The IP Address from which this user is accessing the system.

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 253
• Type: protected mixed $ip_address

Methods

__construct()

Create a new instance of a user. If the username isn't given then it will be determined from the session array.

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 316
• Signature: public function __construct($username,$populate,$checkSession,$log)
• Parameters:
  • integer $username
    The id of the user in the database. or '0' (the detauls) to get it from the session
    • 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 for user information Defaults to true
    • Default Value: true
  • boolean $log
    Defaults to true which means we log the activity
    • Default Value: true

__get()

Magic method to get user details

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 541
• Signature: public function __get($detail)
• Parameters:
  • string $detail
• Returns: mixed.
  false on failure

__set()

Magic method to set user details

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 517
• Signature: public function __set($detail,$value)
• Parameters:
  • string $detail
  • mixed $value

__unset()

Magic method to unset user details

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 532
• Signature: public function __unset($detail)
• Parameters:
  • string $detail

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.

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 99
• Signature: public function changePassword($old_password,$new_password)
• Parameters:
  • string $old_password
  • string $new_password
• Returns: boolean.
  true on success

displayName()

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 603
• Signature: public function displayName()
• Returns: string
  The display name of this user.

findUsersByInfo()

Gets the userss by the indicated details as well as the role. @oaram boolean $role Defaults to false

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 622
• Signature: static public function findUsersByInfo($role,$details,$include_internal)
• Parameters:
  • $role
    • Default Value: false
  • array $details
    of string. The details we wish on the user. Defaults to empty array
    • Default Value: array()
  • boolean $include_internal
    Defaults to true in which case we include the internal administator user if it matches the given details/role
    • Default Value: true
• Returns: mixed.
  I2CE_User on success, false on failure.

generatePassword()

Generate a password

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 80
• Signature: static public function generatePassword()
• Returns: string

getAutoLoginUser()

Gets the auto login user, if any

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 298
• Signature: static public function getAutoLoginUser()
• Returns: mixed.
  false on failure the username if a autologin user has been set

getDetailName()

Returns the display name of the given detail

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 142
• Signature: static public function getDetailName($detail)
• Parameters:
  • string $detail
• Returns: string

getId()

Gets the user id from the username

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 260
• Signature: public function getId()
• Returns: int
  or false on failure

getPreferredLocale()

Gets the prefered locales for the user

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 178
• Signature: public function getPreferredLocale()
• Returns: $string

getRole()

Get's the role associated with a user.

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 559
• Signature: public function getRole()
• Returns: string

hasDetail()

check if the specified detail can be set @params string $detail

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 64
• Signature: static public function hasDetail($detail)
• Parameters:
  • $detail
• Returns: boolean

hasPreferredLocale()

Checks if the prefered locale for the user has been saved

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 199
• Signature: public function hasPreferredLocale()
• Returns: boolean

isRequired()

Checks to see if the indicated detail is required $param string $detail returns boolean

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 156
• Signature: static public function isRequired($detail)
• Parameters:
  • $detail

logged_in()

Checks to see if this user has been logged in

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 397
• Signature: public function logged_in()

login()

Login the user and populate their details then an error message will be set on the template.

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 411
• Signature: public function login($username,$password)
• Parameters:
  • string $username
  • string $password
• Returns: boolean.
  True on success, error message of failure

logout()

Log the user out of the system. @global array

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 577
• Signature: public function logout()

passwordlessLogin()

Login the user and populate their details then an error message will be set on the template.

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 451
• Signature: public function passwordlessLogin($username)
• Parameters:
  • string $username
• Returns: boolean.
  True on success, error message of failure

populate()

Populate the member variables of this object. This will also update the user log to show the latest activity for this login.

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 480
• Signature: public function populate($details,$role,$id)
• Parameters:
  • mixed $details
    If null, we try to get the details and rolefrom the access mechanism if an array, it is the array of details with key the name of details. Defaults to null. @param mixed role. Default to null otherwise it should be a string, the role.
    • Default Value: null
  • $role
    • Default Value: null
  • mixed $id
    Defaults to false otherwise it should be an int the id.
    • Default Value: false
• Returns: true
  on success

save()

Saves the user to the database. This method saves all the user data and updates the access the user has for this system.

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 638
• Signature: public function save($password)
• Parameters:
  • mixed $password
    If it is a string, it is the password to set for the user. detaulst to false in which case we do not set the password
    • Default Value: false

setPassword()

Set the password for the user

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 117
• Signature: public function setPassword($password)
• Parameters:
  • string $password
• Returns: mixed.
  true on success. on failure it is false or a the message to display back to the user signifying why it failed.

setPreferredLocale()

Sets the prefered locales for the user

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 219
• Signature: public function setPreferredLocale($locale,$save)
• Parameters:
  • string $locale
  • boolean $save
    Defaults to true.
    • Default Value: true
• Returns: string
  $locales. false on failure string or array of strings, the locales on success

setRole()

Get's the role associated with a user. @param string $ole

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 568
• Signature: public function setRole($role)
• Parameters:
  • $role

userExists()

See if a user is in the system

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 128
• Signature: static public function userExists($username,$has_role)
• Parameters:
  • string $username
  • boolean $has_role
    If true we verify that they have a role set.
• Returns: boolean.

userHasDefaultPassword()

Checks to see if the specified user has a default password

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 270
• Signature: static public function userHasDefaultPassword($username)
• Parameters:
  • string $username
• Returns: boolean

userHasPassword()

Checks to see if the specified user has the given password

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 285
• Signature: static public function userHasPassword($username,$password)
• Parameters:
  • string $username
  • string $password
• Returns: boolean

username()

Get the username

• Defined in i2ce/modules/User/lib/I2CE_User.php on line 596
• Signature: public function username()

Inherited Methods

_hasMethod()

This public method is inherited from I2CE_Fuzzy->_hasMethod()

Inherited Fuzzy Methods

userMessage()

This method is inherited from I2CE_Fuzzy->userMessage()