Class: I2CE UserAccess (Development): Difference between revisions
(Created page with '{{otherversions|Class: I2CE_UserAccess}} This article describes the class ''I2CE_UserAccess'' . *Extends the class: [[Class: I2CE_UserAccess_Mechanism (Development) | I2CE_UserAc…') |
No edit summary |
||
Line 2: | Line 2: | ||
This article describes the class ''I2CE_UserAccess'' . | This article describes the class ''I2CE_UserAccess'' . | ||
*Extends the class: [[Class: I2CE_UserAccess_Mechanism (Development) | I2CE_UserAccess_Mechanism]]. | *Extends the class: [[Class: I2CE_UserAccess_Mechanism (Development) | I2CE_UserAccess_Mechanism]]. | ||
*Location: Part of the module [[I2CE Module List (Development)#UserAccess|UserAccess]] in the package [https://launchpad.net/i2ce I2CE] 4. | *Location: Part of the module [[I2CE Module List (Development)#UserAccess|UserAccess]] in the package [https://launchpad.net/i2ce I2CE] 4.1-dev | ||
*Source: Defined in the file [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4. | *Source: Defined in the file [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L34 modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 34 | ||
*Author: Carl Leitner <litlfred@ibiblio.org> | *Author: Carl Leitner <litlfred@ibiblio.org> | ||
*Since: v4.0.3 | *Since: v4.0.3 | ||
Line 10: | Line 10: | ||
===$detailTable=== | ===$detailTable=== | ||
@var protected string $userTable the user detail table. | @var protected string $userTable the user detail table. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4. | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L147 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 147 | ||
*Type: protected $detailTable | *Type: protected $detailTable | ||
===$accessTable=== | ===$accessTable=== | ||
the user access table. | the user access table. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4. | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L152 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 152 | ||
*Type: protected [http://www.php.net/manual/en/language.types.string.php string ] $accessTable | *Type: protected [http://www.php.net/manual/en/language.types.string.php string ] $accessTable | ||
===$logTable=== | ===$logTable=== | ||
the user acitivity log table. | the user acitivity log table. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4. | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L159 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 159 | ||
*Type: protected [http://www.php.net/manual/en/language.types.string.php string ] $logTable | *Type: protected [http://www.php.net/manual/en/language.types.string.php string ] $logTable | ||
Line 26: | Line 26: | ||
===__construct()=== | ===__construct()=== | ||
Create a new instance of a default I2CE table user access mechanism | Create a new instance of a default I2CE table user access mechanism | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4. | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L136 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 136 | ||
*Signature: public function __construct() | *Signature: public function __construct() | ||
===_changePassword()=== | ===_changePassword()=== | ||
Change the password for this user. Worker method 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. | Change the password for this user. Worker method 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 [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4. | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L423 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 423 | ||
*Signature: public function _changePassword($username,$old_password,$new_password) | *Signature: public function _changePassword($username,$old_password,$new_password) | ||
*Parameters: | *Parameters: | ||
Line 39: | Line 39: | ||
===_createUser()=== | ===_createUser()=== | ||
Create user worker method | Create user worker method | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4. | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L614 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 614 | ||
*Signature: public function _createUser($username,$password,$role,$details) | *Signature: public function _createUser($username,$password,$role,$details) | ||
*Parameters: | *Parameters: | ||
Line 51: | Line 51: | ||
===_getUserId()=== | ===_getUserId()=== | ||
Gets the user id from the user name | Gets the user id from the user name | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4. | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L352 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 352 | ||
*Signature: public function _getUserId($username) | *Signature: public function _getUserId($username) | ||
*Parameters: | *Parameters: | ||
** [http://www.php.net/manual/en/language.types.string.php string ] $username | ** [http://www.php.net/manual/en/language.types.string.php string ] $username | ||
*Returns: [http://www.php.net/manual/en/language.types.integer.php int ]<br/>or false on failure | *Returns: [http://www.php.net/manual/en/language.types.integer.php int ]<br/>or false on failure | ||
===_getUserIds()=== | |||
Gets the user id | |||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L371 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 371 | |||
*Signature: public function _getUserIds() | |||
*Returns: [http://www.php.net/manual/en/language.types.array.php array ]<br/>of ids | |||
===_getUserInfo()=== | ===_getUserInfo()=== | ||
Gets the indicated user details as well the role | Gets the indicated user details as well the role | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4. | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L225 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 225 | ||
*Signature: public function _getUserInfo($username,$getRole,$details) | *Signature: public function _getUserInfo($username,$getRole,$details) | ||
*Parameters: | *Parameters: | ||
Line 69: | Line 74: | ||
===_getUserNameFromId()=== | ===_getUserNameFromId()=== | ||
Gets the user id from the username | Gets the user id from the username | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4. | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L396 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 396 | ||
*Signature: public function _getUserNameFromId($userid) | *Signature: public function _getUserNameFromId($userid) | ||
*Parameters: | *Parameters: | ||
Line 76: | Line 81: | ||
===_getUsersByInfo()=== | ===_getUsersByInfo()=== | ||
Gets the userss by the indicated details as well as the role. worker method @oaram boolean $role Defaults to false | Gets the userss by the indicated details as well as the role. worker method @oaram boolean $role Defaults to false | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4. | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L266 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 266 | ||
*Signature: public function _getUsersByInfo($role,$details) | *Signature: public function _getUsersByInfo($role,$details) | ||
*Parameters: | *Parameters: | ||
Line 86: | Line 91: | ||
===_setUserInfo()=== | ===_setUserInfo()=== | ||
Gets the role assigned to a user | Gets the role assigned to a user | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4. | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L174 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 174 | ||
*Signature: public function _setUserInfo($username,$setRole,$details) | *Signature: public function _setUserInfo($username,$setRole,$details) | ||
*Parameters: | *Parameters: | ||
Line 97: | Line 102: | ||
===_userExists()=== | ===_userExists()=== | ||
See if a user is in the system | See if a user is in the system | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4. | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L327 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 327 | ||
*Signature: public function _userExists($username,$has_role) | *Signature: public function _userExists($username,$has_role) | ||
*Parameters: | *Parameters: | ||
Line 103: | Line 108: | ||
** [http://www.php.net/manual/en/language.types.boolean.php boolean ] $has_role <br/>If true we verify that they have a role set. | ** [http://www.php.net/manual/en/language.types.boolean.php boolean ] $has_role <br/>If true we verify that they have a role set. | ||
*Returns: boolean. | *Returns: boolean. | ||
===_userHasDefaultPassword()=== | |||
checks to see if the user has a default password (one set by administrator) @param string $password | |||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L484 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 484 | |||
*Signature: public function _userHasDefaultPassword($username) | |||
*Parameters: | |||
** [http://www.php.net/manual/en/language.types.string.php string ] $username | |||
*Returns: [http://www.php.net/manual/en/language.types.boolean.php boolean ] | |||
===_userHasPassword()=== | ===_userHasPassword()=== | ||
verifies that the specified user has the specified password | verifies that the specified user has the specified password | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4. | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L455 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 455 | ||
*Signature: public function _userHasPassword($username,$password) | *Signature: public function _userHasPassword($username,$password) | ||
*Parameters: | *Parameters: | ||
Line 113: | Line 125: | ||
===canChangePassword()=== | ===canChangePassword()=== | ||
Whether or not this acccess mechansim can change a user's password | Whether or not this acccess mechansim can change a user's password | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4. | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L315 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 315 | ||
*Signature: public function canChangePassword() | *Signature: public function canChangePassword() | ||
*Returns: [http://www.php.net/manual/en/language.types.boolean.php boolean ] | *Returns: [http://www.php.net/manual/en/language.types.boolean.php boolean ] | ||
===canCreateNewUser()=== | ===canCreateNewUser()=== | ||
Whether or not this acccess mechansim can create ne users | Whether or not this acccess mechansim can create ne users | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4. | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L50 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 50 | ||
*Signature: public function canCreateNewUser() | *Signature: public function canCreateNewUser() | ||
*Returns: [http://www.php.net/manual/en/language.types.boolean.php boolean ] | *Returns: [http://www.php.net/manual/en/language.types.boolean.php boolean ] | ||
===canEditUserDetails()=== | ===canEditUserDetails()=== | ||
Whether or not this acccess mechansim can create edit details of existing users | Whether or not this acccess mechansim can create edit details of existing users | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4. | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L58 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 58 | ||
*Signature: public function canEditUserDetails() | *Signature: public function canEditUserDetails() | ||
*Returns: [http://www.php.net/manual/en/language.types.boolean.php boolean ] | *Returns: [http://www.php.net/manual/en/language.types.boolean.php boolean ] | ||
===displayName()=== | ===displayName()=== | ||
Gets the display name for the user | Gets the display name for the user | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4. | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L631 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 631 | ||
*Signature: public function displayName($username,$user) | *Signature: public function displayName($username,$user) | ||
*Parameters: | *Parameters: | ||
Line 136: | Line 148: | ||
===encryptPassword()=== | ===encryptPassword()=== | ||
Encrypts the password @param string $passwd | Encrypts the password @param string $passwd | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4. | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L42 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 42 | ||
*Signature: protected function encryptPassword($password) | *Signature: protected function encryptPassword($password) | ||
*Parameters: | *Parameters: | ||
Line 143: | Line 155: | ||
===ensureDefaultOptions()=== | ===ensureDefaultOptions()=== | ||
ensrure default options are set | ensrure default options are set | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4. | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L129 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 129 | ||
*Signature: public function ensureDefaultOptions($options) | *Signature: public function ensureDefaultOptions($options) | ||
*Parameters: | *Parameters: | ||
Line 150: | Line 162: | ||
===getAllowedDetails()=== | ===getAllowedDetails()=== | ||
Gets an array of the allowed details | Gets an array of the allowed details | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4. | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L68 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 68 | ||
*Signature: public function getAllowedDetails() | *Signature: public function getAllowedDetails() | ||
*Returns: [http://www.php.net/manual/en/language.types.array.php array ] | *Returns: [http://www.php.net/manual/en/language.types.array.php array ] | ||
===getDetailColumnTypes()=== | ===getDetailColumnTypes()=== | ||
An array of the details and their associated mdb2 types | An array of the details and their associated mdb2 types | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4. | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L92 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 92 | ||
*Signature: protected function getDetailColumnTypes() | *Signature: protected function getDetailColumnTypes() | ||
===getDetailColumns()=== | ===getDetailColumns()=== | ||
An array of the details and their associated columns | An array of the details and their associated columns | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4. | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L78 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 78 | ||
*Signature: protected function getDetailColumns() | *Signature: protected function getDetailColumns() | ||
===getDetailName()=== | ===getDetailName()=== | ||
Returns the display name of the given detail | Returns the display name of the given detail | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4. | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L108 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 108 | ||
*Signature: public function getDetailName($detail) | *Signature: public function getDetailName($detail) | ||
*Parameters: | *Parameters: | ||
** [http://www.php.net/manual/en/language.types.string.php string ] $detail | ** [http://www.php.net/manual/en/language.types.string.php string ] $detail | ||
*Returns: [http://www.php.net/manual/en/language.types.string.php string ] | *Returns: [http://www.php.net/manual/en/language.types.string.php string ] | ||
===hasBeenLoggedOut()=== | |||
Check to see if this user has been logged out by other means. | |||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L574 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 574 | |||
*Signature: public function hasBeenLoggedOut($username) | |||
*Parameters: | |||
** [http://www.php.net/manual/en/language.types.string.php string ] $username | |||
*Returns: [http://www.php.net/manual/en/language.types.boolean.php boolean ] | |||
===isLoggingFromAnotherIP()=== | |||
Check if the user is logged in from a given IP address | |||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L554 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 554 | |||
*Signature: public function isLoggingFromAnotherIP($username,$ip_address) | |||
*Parameters: | |||
** [http://www.php.net/manual/en/language.types.string.php string ] $username | |||
** [http://www.php.net/manual/en/language.types.string.php string ] $ip_address <br/>defaults to 127.0.0.1 | |||
*Returns: boolean.<br/>true when a user is attempting multiple logins | |||
===isRequired()=== | ===isRequired()=== | ||
Checks to see if the indicated detail is required $param string $detail returns boolean | Checks to see if the indicated detail is required $param string $detail returns boolean | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4. | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L640 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 640 | ||
*Signature: public function isRequired($detail) | *Signature: public function isRequired($detail) | ||
*Parameters: | *Parameters: | ||
Line 176: | Line 203: | ||
===logActivity()=== | ===logActivity()=== | ||
Logs a user activiity @param string $actitivty, such as login, logout, access. Default is access @param int $timesamp. Defaults to null, in which case it should be now | Logs a user activiity @param string $actitivty, such as login, logout, access. Default is access @param int $timesamp. Defaults to null, in which case it should be now | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4. | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L511 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 511 | ||
*Signature: public function logActivity($username,$activity,$timestamp) | *Signature: public function logActivity($username,$activity,$ip_address,$timestamp) | ||
*Parameters: | *Parameters: | ||
** [http://www.php.net/manual/en/language.types.string.php string ] $username | ** [http://www.php.net/manual/en/language.types.string.php string ] $username | ||
**$activity | **$activity | ||
***Default Value: 'access' | ***Default Value: 'access' | ||
**$ip_address | |||
***Default Value: '127.0.0.1' | |||
**$timestamp | **$timestamp | ||
***Default Value: null | ***Default Value: null | ||
===logOutPreviousSessions()=== | |||
Logs out any previous existing sessions if single login option is set. | |||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php#L589 i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php] on line 589 | |||
*Signature: public function logOutPreviousSessions($username) | |||
*Parameters: | |||
** [http://www.php.net/manual/en/language.types.string.php string ] $username | |||
*Returns: [http://www.php.net/manual/en/language.types.boolean.php boolean ] | |||
==Inherited Methods== | ==Inherited Methods== | ||
===changePassword()=== | ===changePassword()=== | ||
Line 190: | Line 226: | ||
===createUser()=== | ===createUser()=== | ||
This public method is inherited from [[Class: I2CE_UserAccess_Mechanism (Development)#createUser() | I2CE_UserAccess_Mechanism->createUser()]] | This public method is inherited from [[Class: I2CE_UserAccess_Mechanism (Development)#createUser() | I2CE_UserAccess_Mechanism->createUser()]] | ||
===doAutoLogin()=== | |||
This public method is inherited from [[Class: I2CE_UserAccess_Mechanism (Development)#doAutoLogin() | I2CE_UserAccess_Mechanism->doAutoLogin()]] | |||
===generatePassword()=== | ===generatePassword()=== | ||
This public method is inherited from [[Class: I2CE_UserAccess_Mechanism (Development)#generatePassword() | I2CE_UserAccess_Mechanism->generatePassword()]] | This public method is inherited from [[Class: I2CE_UserAccess_Mechanism (Development)#generatePassword() | I2CE_UserAccess_Mechanism->generatePassword()]] | ||
===getAutoLoginUser()=== | |||
This public method is inherited from [[Class: I2CE_UserAccess_Mechanism (Development)#getAutoLoginUser() | I2CE_UserAccess_Mechanism->getAutoLoginUser()]] | |||
===getSessionActivity()=== | |||
This public method is inherited from [[Class: I2CE_UserAccess_Mechanism (Development)#getSessionActivity() | I2CE_UserAccess_Mechanism->getSessionActivity()]] | |||
===getSessionDetails()=== | ===getSessionDetails()=== | ||
Line 208: | Line 253: | ||
===getUserId()=== | ===getUserId()=== | ||
This public method is inherited from [[Class: I2CE_UserAccess_Mechanism (Development)#getUserId() | I2CE_UserAccess_Mechanism->getUserId()]] | This public method is inherited from [[Class: I2CE_UserAccess_Mechanism (Development)#getUserId() | I2CE_UserAccess_Mechanism->getUserId()]] | ||
===getUserIds()=== | |||
This public method is inherited from [[Class: I2CE_UserAccess_Mechanism (Development)#getUserIds() | I2CE_UserAccess_Mechanism->getUserIds()]] | |||
===getUserInfo()=== | ===getUserInfo()=== | ||
Line 229: | Line 277: | ||
===unsetSession()=== | ===unsetSession()=== | ||
This public method is inherited from [[Class: I2CE_UserAccess_Mechanism (Development)#unsetSession() | I2CE_UserAccess_Mechanism->unsetSession()]] | This public method is inherited from [[Class: I2CE_UserAccess_Mechanism (Development)#unsetSession() | I2CE_UserAccess_Mechanism->unsetSession()]] | ||
===updateSessionActivity()=== | |||
This public method is inherited from [[Class: I2CE_UserAccess_Mechanism (Development)#updateSessionActivity() | I2CE_UserAccess_Mechanism->updateSessionActivity()]] | |||
===userExists()=== | ===userExists()=== | ||
This public method is inherited from [[Class: I2CE_UserAccess_Mechanism (Development)#userExists() | I2CE_UserAccess_Mechanism->userExists()]] | This public method is inherited from [[Class: I2CE_UserAccess_Mechanism (Development)#userExists() | I2CE_UserAccess_Mechanism->userExists()]] | ||
===userHasDefaultPassword()=== | |||
This public method is inherited from [[Class: I2CE_UserAccess_Mechanism (Development)#userHasDefaultPassword() | I2CE_UserAccess_Mechanism->userHasDefaultPassword()]] | |||
===userHasPassword()=== | ===userHasPassword()=== |
Latest revision as of 08:20, 6 May 2015
This article describes the class I2CE_UserAccess .
- Extends the class: I2CE_UserAccess_Mechanism.
- Location: Part of the module UserAccess in the package I2CE 4.1-dev
- Source: Defined in the file modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 34
- Author: Carl Leitner <litlfred@ibiblio.org>
- Since: v4.0.3
@filesource Class I2CE_UserAccess_Internal A user access control mechansim where username and the user details are stored in one table and access is in another table and the tables are joined on a userid.
Variables
$detailTable
@var protected string $userTable the user detail table.
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 147
- Type: protected $detailTable
$accessTable
the user access table.
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 152
- Type: protected string $accessTable
$logTable
the user acitivity log table.
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 159
- Type: protected string $logTable
Methods
__construct()
Create a new instance of a default I2CE table user access mechanism
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 136
- Signature: public function __construct()
_changePassword()
Change the password for this user. Worker method 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/modules/UserAccess/lib/I2CE_UserAccess.php on line 423
- Signature: public function _changePassword($username,$old_password,$new_password)
- Parameters:
- Returns: boolean
_createUser()
Create user worker method
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 614
- Signature: public function _createUser($username,$password,$role,$details)
- Parameters:
- Returns: boolean.
true on success
_getUserId()
Gets the user id from the user name
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 352
- Signature: public function _getUserId($username)
- Parameters:
- string $username
- Returns: int
or false on failure
_getUserIds()
Gets the user id
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 371
- Signature: public function _getUserIds()
- Returns: array
of ids
_getUserInfo()
Gets the indicated user details as well the role
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 225
- Signature: public function _getUserInfo($username,$getRole,$details)
- Parameters:
- string $username @oaram boolean $getRole Defaults to false
- $getRole
- Default Value: false
- $details
- Default Value: array()
- Returns: array.
associative array of user info (role, email and other details)
_getUserNameFromId()
Gets the user id from the username
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 396
- Signature: public function _getUserNameFromId($userid)
- Parameters:
- int $userid
- Returns: string
or false on failure
_getUsersByInfo()
Gets the userss by the indicated details as well as the role. worker method @oaram boolean $role Defaults to false
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 266
- Signature: public function _getUsersByInfo($role,$details)
- Parameters:
- $role
- Default Value: false
- array $details
of string. The details we wish on the user. Defaults to empty array- Default Value: array()
- $role
- Returns: array
of usernames which mathc the give input
_setUserInfo()
Gets the role assigned to a user
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 174
- Signature: public function _setUserInfo($username,$setRole,$details)
- Parameters:
- Returns: boolean.
true on success
_userExists()
See if a user is in the system
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 327
- Signature: public function _userExists($username,$has_role)
- Parameters:
- Returns: boolean.
_userHasDefaultPassword()
checks to see if the user has a default password (one set by administrator) @param string $password
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 484
- Signature: public function _userHasDefaultPassword($username)
- Parameters:
- string $username
- Returns: boolean
_userHasPassword()
verifies that the specified user has the specified password
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 455
- Signature: public function _userHasPassword($username,$password)
- Parameters:
- Returns: boolean
canChangePassword()
Whether or not this acccess mechansim can change a user's password
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 315
- Signature: public function canChangePassword()
- Returns: boolean
canCreateNewUser()
Whether or not this acccess mechansim can create ne users
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 50
- Signature: public function canCreateNewUser()
- Returns: boolean
canEditUserDetails()
Whether or not this acccess mechansim can create edit details of existing users
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 58
- Signature: public function canEditUserDetails()
- Returns: boolean
displayName()
Gets the display name for the user
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 631
- Signature: public function displayName($username,$user)
- Parameters:
- Returns: string
encryptPassword()
Encrypts the password @param string $passwd
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 42
- Signature: protected function encryptPassword($password)
- Parameters:
- $password
- Returns: string
ensureDefaultOptions()
ensrure default options are set
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 129
- Signature: public function ensureDefaultOptions($options)
- Parameters:
- array $options
- Returns: array
getAllowedDetails()
Gets an array of the allowed details
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 68
- Signature: public function getAllowedDetails()
- Returns: array
getDetailColumnTypes()
An array of the details and their associated mdb2 types
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 92
- Signature: protected function getDetailColumnTypes()
getDetailColumns()
An array of the details and their associated columns
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 78
- Signature: protected function getDetailColumns()
getDetailName()
Returns the display name of the given detail
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 108
- Signature: public function getDetailName($detail)
- Parameters:
- string $detail
- Returns: string
hasBeenLoggedOut()
Check to see if this user has been logged out by other means.
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 574
- Signature: public function hasBeenLoggedOut($username)
- Parameters:
- string $username
- Returns: boolean
isLoggingFromAnotherIP()
Check if the user is logged in from a given IP address
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 554
- Signature: public function isLoggingFromAnotherIP($username,$ip_address)
- Parameters:
- Returns: boolean.
true when a user is attempting multiple logins
isRequired()
Checks to see if the indicated detail is required $param string $detail returns boolean
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 640
- Signature: public function isRequired($detail)
- Parameters:
- $detail
logActivity()
Logs a user activiity @param string $actitivty, such as login, logout, access. Default is access @param int $timesamp. Defaults to null, in which case it should be now
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 511
- Signature: public function logActivity($username,$activity,$ip_address,$timestamp)
- Parameters:
- string $username
- $activity
- Default Value: 'access'
- $ip_address
- Default Value: '127.0.0.1'
- $timestamp
- Default Value: null
logOutPreviousSessions()
Logs out any previous existing sessions if single login option is set.
- Defined in i2ce/modules/User/modules/UserAccess/lib/I2CE_UserAccess.php on line 589
- Signature: public function logOutPreviousSessions($username)
- Parameters:
- string $username
- Returns: boolean
Inherited Methods
changePassword()
This public method is inherited from I2CE_UserAccess_Mechanism->changePassword()
createUser()
This public method is inherited from I2CE_UserAccess_Mechanism->createUser()
doAutoLogin()
This public method is inherited from I2CE_UserAccess_Mechanism->doAutoLogin()
generatePassword()
This public method is inherited from I2CE_UserAccess_Mechanism->generatePassword()
getAutoLoginUser()
This public method is inherited from I2CE_UserAccess_Mechanism->getAutoLoginUser()
getSessionActivity()
This public method is inherited from I2CE_UserAccess_Mechanism->getSessionActivity()
getSessionDetails()
This public method is inherited from I2CE_UserAccess_Mechanism->getSessionDetails()
getSessionID()
This public method is inherited from I2CE_UserAccess_Mechanism->getSessionID()
getSessionRole()
This public method is inherited from I2CE_UserAccess_Mechanism->getSessionRole()
getSessionUserName()
This public method is inherited from I2CE_UserAccess_Mechanism->getSessionUserName()
getUserId()
This public method is inherited from I2CE_UserAccess_Mechanism->getUserId()
getUserIds()
This public method is inherited from I2CE_UserAccess_Mechanism->getUserIds()
getUserInfo()
This public method is inherited from I2CE_UserAccess_Mechanism->getUserInfo()
getUserNameFromId()
This public method is inherited from I2CE_UserAccess_Mechanism->getUserNameFromId()
getUsersByInfo()
This public method is inherited from I2CE_UserAccess_Mechanism->getUsersByInfo()
hasSession()
This public method is inherited from I2CE_UserAccess_Mechanism->hasSession()
setSession()
This public method is inherited from I2CE_UserAccess_Mechanism->setSession()
setUserInfo()
This public method is inherited from I2CE_UserAccess_Mechanism->setUserInfo()
unsetSession()
This public method is inherited from I2CE_UserAccess_Mechanism->unsetSession()
updateSessionActivity()
This public method is inherited from I2CE_UserAccess_Mechanism->updateSessionActivity()
userExists()
This public method is inherited from I2CE_UserAccess_Mechanism->userExists()
userHasDefaultPassword()
This public method is inherited from I2CE_UserAccess_Mechanism->userHasDefaultPassword()
userHasPassword()
This public method is inherited from I2CE_UserAccess_Mechanism->userHasPassword()
_hasMethod()
This public method is inherited from I2CE_Fuzzy->_hasMethod()
Inherited Variables
$options
Theis protected variable is inherited from I2CE_UserAccess_Mechanism->$options
$protocol
Theis protected variable is inherited from I2CE_UserAccess_Mechanism->$protocol
Inherited Fuzzy Methods
userMessage()
This method is inherited from I2CE_Fuzzy->userMessage()