Docs For Class LiveUser_Perm

LiveUser_Perm_Common LiveUser_Perm_Common(
)

Class constructor. Feel free to override in backend subclasses.

[ Top ]

boolean checkLevel(
integer
$level, mixed
$owner_user_id, mixed
$owner_group_id)

Checks if the current user has a certain right in a given area at the necessary level.

Level 1: requires that owner_user_id matches $this->permUserId Level 2: requires that the $owner_group_id matches the id one of the (sub)groups that $this->permUserId is a memember of or requires that the $owner_user_id matches a perm_user_id of a memeber of one of $this->permUserId's (sub)groups Level 3: no requirements

Important note: Every ressource MAY be owned by a user and/or by a group. Therefore, $owner_user_id and/or $owner_group_id can either be an integer or null.

Return: true if the level is sufficient to grant access else false.

Parameters:

integer	`$level`	—	Level value as returned by checkRight().
mixed	`$owner_user_id`	—	Id or array of Ids of the owner of the
mixed	`$owner_group_id`	—	Id or array of Ids of the group of the ressource for which the right is requested.

[ Top ]

integer checkRight(
integer
$right_id)

Checks if the current user has a certain right in a given area.

If $this->ondemand is true, the rights will be loaded on the fly.

Return: Level of the right.
Access: public

Parameters:

integer $right_id — Id of the right to check for.

[ Top ]

boolean checkRightLevel(
integer
$right_id, integer
$owner_user_id, mixed
$owner_group_id, [integer
$area_id = null])

Checks if the current user has a certain right in a given area with the sufficient level to gain access to a specific ressource in that area.

Return: true if the level is sufficient to grant access else false.

Overridden in child classes as:

LiveUser_Perm_Container_MDB2_Complex::checkRightLevel(): LiveUser_Perm_Container_MDB2_Complex::checkRightLevel()

LiveUser_Perm_Container_DB_Complex::checkRightLevel(): LiveUser_Perm_Container_DB_Complex::checkRightLevel()

LiveUser_Perm_Container_MDB_Complex::checkRightLevel(): LiveUser_Perm_Container_MDB_Complex::checkRightLevel()

Parameters:

integer	`$area_id`	—	Id of the area in which the right is stored.
integer	`$right_id`	—	Id of the right within the AuthArea to check for.
integer	`$owner_user_id`	—	Id of the owner of the ressource for which the right is requested.
mixed	`$owner_group_id`	—	Id or array of Ids of the group of the ressource for which the right is requested.

[ Top ]

void disconnect(
)

properly disconnect from resources

Access: public

Overridden in child classes as:

LiveUser_Perm_Container_MDB2_Simple::disconnect(): properly disconnect from resources

LiveUser_Perm_Container_XML_Simple::disconnect(): properly disconnect from resources

LiveUser_Perm_Container_DB_Simple::disconnect(): properly disconnect from resources

LiveUser_Perm_Container_MDB_Simple::disconnect(): properly disconnect from resources

[ Top ]

void freeze(
)

store all properties in an array

Access: public

[ Top ]

mixed getProperty(
string
$what)

Function returns the inquired value if it exists in the class.

Return: null, a value or an array.

Parameters:

string $what — Name of the property to be returned.

[ Top ]

mixed getRights(
[boolean
$withLevels = false])

Returns a one-dimensional array with all rights assigned

to this user. Array format depends on the optional parameter: true: array(intRight_ID => intRightLevel, ...) false array(intRight_ID, ...) [Default] If no rights are available, false is returned.

Access: public

Parameters:

boolean $withLevels —

[ Top ]

boolean init(
string
$uid)

Tries to find the user with the given user ID in the permissions container. Will read all permission data and return true on success.

Return: true if init process was successfull else false.
Access: public

Overridden in child classes as:

LiveUser_Perm_Container_MDB2_Simple::init(): Tries to find the user with the given user ID in the permissions container. Will read all permission data and return true on success.

LiveUser_Perm_Container_MDB2_Medium::init(): Tries to find the user with the given user ID in the permissions container. Will read all permission data and return true on success.

LiveUser_Perm_Container_XML_Simple::init(): Tries to find the user with the given user ID in the permissions container. Will read all permission data and return true on success.

LiveUser_Perm_Container_DB_Simple::init(): Tries to find the user with the given user ID in the permissions container. Will read all permission data and return true on success.

LiveUser_Perm_Container_DB_Medium::init(): Tries to find the user with the given user ID in the permissions container. Will read all permission data and return true on success.

LiveUser_Perm_Container_MDB_Simple::init(): Tries to find the user with the given user ID in the permissions container. Will read all permission data and return true on success.

LiveUser_Perm_Container_MDB_Medium::init(): Tries to find the user with the given user ID in the permissions container. Will read all permission data and return true on success.

Parameters:

string $uid — User id in the auth container.

[ Top ]

void readGroupRights(
)

Reads all individual rights of current user into a two-dimensional array of this format: "GroupName" => "AreaName" -> "RightName"

Again, this does nothing in the base class. The described functionality must be implemented in a subclass overriding this method.

Overridden in child classes as:

LiveUser_Perm_Container_MDB2_Medium::readGroupRights(): Reads the group rights and put them in the array

LiveUser_Perm_Container_DB_Medium::readGroupRights(): Reads the group rights and put them in the array

LiveUser_Perm_Container_MDB_Medium::readGroupRights(): Reads the group rights and put them in the array

[ Top ]

void readRights(
)

Reads all rights of current user into a two-dimensional associative array, having the area names as the key of the 1st dimension.

Group rights and invididual rights are being merged in the process.

Overridden in child classes as:

LiveUser_Perm_Container_MDB2_Simple::readRights(): Reads all rights of current user into an associative array.

LiveUser_Perm_Container_XML_Simple::readRights(): Reads all rights of current user into an associative array.

LiveUser_Perm_Container_DB_Simple::readRights(): Reads all rights of current user into an associative array.

LiveUser_Perm_Container_MDB_Simple::readRights(): Reads all rights of current user into an associative array.

[ Top ]

void readUserRights(
)

Reads all individual rights of current user into a two-dimensional array of this format: AreaName => RightName -> Value

Again, this does nothing in the base class. The described functionality must be implemented in a subclass overriding this method.

Overridden in child classes as:

LiveUser_Perm_Container_MDB2_Medium::readUserRights(): Reads the user rights and put them in an array

LiveUser_Perm_Container_DB_Medium::readUserRights(): Reads the user rights and put them in an array

LiveUser_Perm_Container_MDB_Medium::readUserRights(): Reads the user rights and put them in an array

[ Top ]

void unfreeze(
array
$propertyValues)

Reinitializes properties

Access: public

Parameters:

array $propertyValues —

[ Top ]

boolean userExists(
integer
$user_id)

Checks if a user with the given perm_user_id exists in the permission container and returns true on success.

Return: true if the id was found, else false.
Access: public

Overridden in child classes as:

LiveUser_Perm_Container_MDB2_Simple::userExists(): LiveUser_Perm_Container_MDB2_Complex::userExists()

LiveUser_Perm_Container_XML_Simple::userExists(): LiveUser_Perm_Container_MDB_Complex::userExists()

LiveUser_Perm_Container_DB_Simple::userExists(): LiveUser_Perm_Container_DB_Complex::userExists()

LiveUser_Perm_Container_MDB_Simple::userExists(): LiveUser_Perm_Container_MDB_Complex::userExists()

Parameters:

integer $user_id — The users id in the permission table.

[ Top ]

Class: LiveUser_Perm_Common

Class Overview

Author(s):

Version:

Variables

Methods

Child classes:

Inherited Variables

Inherited Methods

Class Details

Class Variables

$groupIds = false

$groupRights = array()

$ondemand = false

$permUserId = ''

$rights = false

$userRights = array()

$userType = LIVEUSER_ANONYMOUS_TYPE_ID

Method Detail

LiveUser_Perm_Common (Constructor) [line 136]

checkLevel [line 332]

Parameters:

checkRight [line 289]

Parameters:

checkRightLevel [line 351]

Parameters:

disconnect [line 178]

freeze [line 160]

getProperty [line 377]

Parameters:

getRights [line 266]

Parameters:

init [line 149]

Parameters:

readGroupRights [line 248]

readRights [line 202]

readUserRights [line 217]

unfreeze [line 188]

Parameters:

userExists [line 365]

Parameters: