Docs For Class LiveUser_Admin_Perm_Container_DB

LiveUser_Admin_Perm_Container_DB_Simple (Constructor) [line 48]

void LiveUser_Admin_Perm_Container_DB_Simple(
array
&$connectOptions)

Constructor

See: LiveUser::factory()
Access: protected

Parameters:

array &$connectOptions — full liveuser configuration array

[ Top ]

addApplication [line 541]

mixed addApplication(
string
$define_name, string
$application_name, [string
$application_description = null])

Add an application

Return: integer (application_id) or DB Error object
Access: public

Parameters:

string	`$define_name`	—	name of application constant
string	`$application_name`	—	name of application
string	`$application_description`	—	description of application

[ Top ]

addArea [line 591]

mixed addArea(
string
$application_id, string
$define_name, string
$area_name, [string
$area_description = null])

Add an area

Return: integer (area_id) or DB Error object
Access: public

Parameters:

string	`$application_id`	—	id of application
string	`$define_name`	—	name of area constant
string	`$area_name`	—	name of area
string	`$area_description`	—	description of area

[ Top ]

addLanguage [line 377]

mixed addLanguage(
string
$two_letter_code, string
$native_name, string
$language_name, [string
$language_description = null])

Add a new language

Return: integer (language_id) or DB Error object
Access: public

Parameters:

string	`$two_letter_code`	—	two letter code of language
string	`$native_name`	—	native name of language
string	`$language_name`	—	name of language
string	`$language_description`	—	description of language

[ Top ]

addRight [line 858]

mixed addRight(
integer
$area_id, string
$define_name, string
$right_name, [string
$right_description = null])

Add a right in special area

Return: integer (right_id) or DB Error object
Access: public

Parameters:

integer	`$area_id`	—	id of area
string	`$define_name`	—	name of right constant
string	`$right_name`	—	name of right
string	`$right_description`	—	description of right

[ Top ]

addTranslation [line 215]

mixed addTranslation(
integer
$section_id, integer
$section_type, string
$language, string
$name, [string
$description = null])

Assigns name (and description) in specified language to a section

Return: boolean or DB Error object
Access: public

Parameters:

integer	`$section_id`	—	id of [section]
integer	`$section_type`	—	type of section
string	`$language`	—	language (two letter code) of name/description
string	`$name`	—	name of [section]
string	`$description`	—	description of [section]

[ Top ]

addUser [line 1008]

mixed addUser(
string
$authId, [
$authName = null], [int
$type = LIVEUSER_USER_TYPE_ID], [mixed
$permId = null], string
$authname)

Add a user

Return: string (perm_user_id) or DB Error object
Access: public

Overrides LiveUser_Admin_Perm_Common::addUser() (Adds a new user to Perm.)

Parameters:

string	`$authId`	—	Auth user ID of the user that should be added.
string	`$authname`	—	Auth container name.
int	`$type`	—	User type (constants defined in Perm/Common.php) (optional).
mixed	`$permId`	—	If specificed no new ID will be automatically generated instead
	`$authName`	—

[ Top ]

addUserAreaAdmin [line 1596]

mixed addUserAreaAdmin(
mixed
$permId, int
$area_id)

Make a user an admin of a given area.

Return: true on success, DB Error object or false
Access: public

Parameters:

mixed	`$permId`	—	user identifier
int	`$area_id`	—	area identifier

[ Top ]

getApplications [line 1254]

mixed getApplications(
[array
$options = null])

Get list of all applications

This method accepts the following options... 'where_application_id' = [APPLICATION_ID]

Return: array or DB Error object
Access: public

Parameters:

array $options — an array determining which fields and conditions to use

[ Top ]

getAreas [line 1305]

mixed getAreas(
[array
$options = null])

Get list of all areas within a given application

This method accepts the following options... 'where_area_id' = [AREA_ID], 'where_application_id' = [APPLICATION_ID], 'with_applications' = [BOOLEAN]

Return: array or DB Error object
Access: public

Parameters:

array $options — an array determining which fields and conditions to use

[ Top ]

getAuthUserId [line 107]

mixed getAuthUserId(
string
$permId)

Gets the auth ID of a user.

Return: Permission ID or MDB2 error.
Access: public

Overrides LiveUser_Admin_Perm_Common::getAuthUserId() (Gets the auth ID of a user.)

Parameters:

string $permId — Perm user ID.

[ Top ]

getCurrentApplication [line 199]

string getCurrentApplication(
)

Get current application

Return: name of the current application
Access: public

[ Top ]

getCurrentLanguage [line 174]

string getCurrentLanguage(
)

Get current language

Return: name of the current language
Access: public

[ Top ]

getLanguages [line 1371]

mixed getLanguages(
[array
$options = null])

Get list of all languages

This method accepts the following options... 'where_language_id' = [LANGUAGE_ID], 'with_translations' = [BOOLEAN]

Return: array or DB Error object
Access: public

Parameters:

array $options — an array determining which fields and conditions to use

[ Top ]

getPermUserId [line 84]

mixed getPermUserId(
string
$authId, string
$authName)

Gets the perm ID of a user.

Return: Permission ID or DB error.
Access: public

Overrides LiveUser_Admin_Perm_Common::getPermUserId() (Gets the perm ID of a user.)

Parameters:

string	`$authId`	—	Auth user ID.
string	`$authName`	—	Auth container name.

[ Top ]

getRights [line 1453]

mixed getRights(
[array
$options = null])

Get list of all rights

This method accepts the following options... 'where_user_id' = [AUTH_USER_ID], 'where_group_id' = [GROUP_ID], 'where_right_id' = [RIGHT_ID], 'where_area_id' = [AREA_ID], 'where_application_id' = [APPLICATION_ID], 'with_areas' = [BOOLEAN], 'with_applications' = [BOOLEAN]

Return: array or DB Error object
Access: public

Overridden in child classes as:

LiveUser_Admin_Perm_Container_DB_Complex::getRights(): Get list of all rights

Parameters:

array $options — an array determining which fields and conditions to use

[ Top ]

getTranslation [line 344]

mixed getTranslation(
integer
$section_id, integer
$section_type)

Get name (and description) of the [section] in specified language

Return: array or DB Error object
Access: public

Parameters:

integer	`$section_id`	—	id of [section]
integer	`$section_type`	—	type of section

[ Top ]

getUsers [line 1671]

mixed getUsers(
[array
$filters = array()], [boolean
$options = array()], [boolean
$rekey = false])

Fetch users from the database.

The only supported filter is perm_user_id => 'value'

The array will look like this:

 $userData[0]['perm_user_id'] = 1;

             ['type']         = 1;
             ['container']    = '';
             ['rights']       = array(); // the array returned by getRights()

Return: Array with user data or error object.
See: LiveUser_Admin_Perm_DB_Common::getRights()
Access: public

Overrides LiveUser_Admin_Perm_Common::getUsers() (Gets all perm_user_id, type, container and rights)

Parameters:

array	`$filters`	—	filters to apply to fetched data
boolean	`$options`	—	If true the rights for each user will be retrieved.
boolean	`$rekey`	—	will return an associative array with the auth_user_id as the key by using DB::getAssoc() instead of DB::getAll()

[ Top ]

grantUserRight [line 1149]

mixed grantUserRight(
string
$permId, integer
$right_id)

Grant right to user

Return: boolean or DB Error object
Access: public

Overridden in child classes as:

LiveUser_Admin_Perm_Container_DB_Complex::grantUserRight(): Grant right to user

Parameters:

string	`$permId`	—	id of user
integer	`$right_id`	—	id of right

[ Top ]

removeApplication [line 640]

mixed removeApplication(
integer
$application_id)

Delete an application

Return: boolean or DB Error object or false
Access: public

Parameters:

integer $application_id — id of application

[ Top ]

removeArea [line 700]

mixed removeArea(
integer
$area_id)

Delete an area

Return: boolean or DB Error object or false
Access: public

Parameters:

integer $area_id — id of area

[ Top ]

removeLanguage [line 439]

mixed removeLanguage(
integer
$language)

Remove a language

Return: boolean or DB Error object
Access: public

Parameters:

integer $language — language (two letter code)

[ Top ]

removeRight [line 908]

mixed removeRight(
integer
$right_id)

Delete a right

Return: boolean or DB Error object
Access: public

Overridden in child classes as:

LiveUser_Admin_Perm_Container_DB_Complex::removeRight(): Overriden method to delete implied rights mapping as well as the right.

Parameters:

integer $right_id — id of right

[ Top ]

removeTranslation [line 304]

mixed removeTranslation(
integer
$section_id, integer
$section_type, string
$language, [boolean
$recursive = false])

Remove name (and description) of the [section] in specified language

Return: boolean or DB Error object
Access: public

Parameters:

integer	`$section_id`	—	id of [section]
integer	`$section_type`	—	type of section
string	`$language`	—	language (two letter code) of name/description
boolean	`$recursive`	—	recursive delete of all translations

[ Top ]

removeUser [line 1088]

mixed removeUser(
string
$permId)

Delete user

Return: boolean or DB Error object
Access: public

Overridden in child classes as:

LiveUser_Admin_Perm_Container_DB_Complex::removeUser()

Overrides LiveUser_Admin_Perm_Common::removeUser() (Removes an existing user from Perm.)

Parameters:

string $permId — id of user

[ Top ]

removeUserAreaAdmin [line 1627]

mixed removeUserAreaAdmin(
mixed
$permId, [int
$area_id = null])

Remove the privilege of being an admin.

If no area_id is provided the user will be removed asan admin from all areas he was an admin for.

Return: true on success, DB Error object or false
Access: public

Parameters:

mixed	`$permId`	—	user identifier
int	`$area_id`	—	area identifier

[ Top ]

revokeUserRight [line 1223]

mixed revokeUserRight(
string
$permId, [integer
$right_id = null])

Revoke right from user

Return: boolean or DB Error object
Access: public

Parameters:

string	`$permId`	—	id of user
integer	`$right_id`	—	id of right

[ Top ]

setCurrentApplication [line 186]

boolean setCurrentApplication(
integer
$application_id)

Set current application

Return: always true
Access: public

Parameters:

integer $application_id — id of application

[ Top ]

setCurrentLanguage [line 151]

mixed setCurrentLanguage(
string
$language)

Set current language

Returns false if the language is not known

Return: boolean or DB Error object or false
Access: public

Parameters:

string $language — language short name

[ Top ]

updateApplication [line 772]

mixed updateApplication(
integer
$application_id, string
$define_name, string
$application_name, [string
$application_description = null])

Update an application

Return: boolean or DB Error object
Access: public

Parameters:

integer	`$application_id`	—	id of application
string	`$define_name`	—	name of application constant
string	`$application_name`	—	name of application
string	`$application_description`	—	description of application

[ Top ]

updateArea [line 813]

mixed updateArea(
integer
$area_id, int
$application_id, string
$define_name, string
$area_name, [string
$area_description = null])

Update an area

Return: boolean or DB Error object or false
Access: public

Parameters:

integer	`$area_id`	—	id of area
int	`$application_id`	—	id of application
string	`$define_name`	—	name of area constant
string	`$area_name`	—	name of area
string	`$area_description`	—	description of area

[ Top ]

updateAuthUserId [line 1054]

mixed updateAuthUserId(
int
$permId, mixed
$authId, [mixed
$authName = false])

Updates auth_user_id in the mapping table.

Return: true or DB Error object or false if there was an error to begin with
Access: public

Parameters:

int	`$permId`	—	perm_user_id of the user
mixed	`$authId`	—	new Auth user ID
mixed	`$authName`	—	new Auth Container name

[ Top ]

updateLanguage [line 487]

mixed updateLanguage(
integer
$language, string
$native_name, string
$language_name, [string
$language_description = null])

Update language

Return: boolean or DB Error object
Access: public

Parameters:

integer	`$language`	—	language (two letter code)
string	`$native_name`	—	native name of language
string	`$language_name`	—	name of language
string	`$language_description`	—	description of language

[ Top ]

updateRight [line 965]

mixed updateRight(
integer
$right_id, integer
$area_id, string
$define_name, string
$right_name, [string
$right_description = null])

Update a right

Return: boolean or DB Error object
Access: public

Parameters:

integer	`$right_id`	—	id of right
integer	`$area_id`	—	id of area
string	`$define_name`	—	name of right constant
string	`$right_name`	—	name of right
string	`$right_description`	—	description of right

[ Top ]

updateTranslation [line 261]

mixed updateTranslation(
integer
$section_id, integer
$section_type, string
$language, string
$name, [string
$description = null])

Updates name (and description) of [section] in specified language

Return: boolean or DB Error object
Access: public

Parameters:

integer	`$section_id`	—	id of [section]
integer	`$section_type`	—	type of section
string	`$language`	—	language (two letter code) of name/description
string	`$name`	—	name of [section]
string	`$description`	—	description of [section]

[ Top ]

updateUserRight [line 1195]

mixed updateUserRight(
string
$permId, integer
$right_id, integer
$right_level)

Update right level of userRight

Return: boolean or DB Error object
Access: public

Parameters:

string	`$permId`	—	id of user
integer	`$right_id`	—	id of right
integer	`$right_level`	—	right level

[ Top ]

Class: LiveUser_Admin_Perm_Container_DB_Simple

Class Overview

Author(s):

Version:

Methods

Child classes:

Inherited Variables

Class: LiveUser_Admin_Perm_Common

Inherited Methods

Class: LiveUser_Admin_Perm_Common

Class Details

Method Detail

LiveUser_Admin_Perm_Container_DB_Simple (Constructor) [line 48]

Parameters:

addApplication [line 541]

Parameters:

addArea [line 591]

Parameters:

addLanguage [line 377]

Parameters:

addRight [line 858]

Parameters:

addTranslation [line 215]

Parameters:

addUser [line 1008]

Parameters:

addUserAreaAdmin [line 1596]

Parameters:

getApplications [line 1254]

Parameters:

getAreas [line 1305]

Parameters:

getAuthUserId [line 107]

Parameters:

getCurrentApplication [line 199]

getCurrentLanguage [line 174]

getLanguages [line 1371]

Parameters:

getPermUserId [line 84]

Parameters:

getRights [line 1453]

Parameters:

getTranslation [line 344]

Parameters:

getUsers [line 1671]

Parameters:

grantUserRight [line 1149]

Parameters:

removeApplication [line 640]

Parameters:

removeArea [line 700]

Parameters:

removeLanguage [line 439]

Parameters:

removeRight [line 908]

Parameters:

removeTranslation [line 304]

Parameters:

removeUser [line 1088]

Parameters:

removeUserAreaAdmin [line 1627]

Parameters:

revokeUserRight [line 1223]

Parameters:

setCurrentApplication [line 186]

Parameters:

setCurrentLanguage [line 151]

Parameters:

updateApplication [line 772]

Parameters:

updateArea [line 813]

Parameters:

updateAuthUserId [line 1054]

Parameters:

updateLanguage [line 487]

Parameters:

updateRight [line 965]

Parameters:

updateTranslation [line 261]

Parameters: