User Class Reference

Inheritance diagram for User:

Collaboration diagram for User:

Public Member Functions
	store ()
	triggerChdate ()
	getFullName ($format='full')
	toArrayRecursive ($only_these_fields=null)
	hasRole ($role, $institute_id='')
	getRoles ($with_implicit=false)
	isFriendOf ($another_user)
	isDirty ()
	isFieldDirty ($field)
	revertValue ($field)
	getPristineValue ($field)
	toRawArray ($only_these_fields=null)
	initRelation ($relation)
	getInstitutePerms ()
	getStudipKingIcon ()
	getHomepageElements ()
	changeEmail ($email, $force=false)
	describeRange ()
	getRangeType ()
	getRangeId ()
	userMayAccessRange ($user_id=null)
	userMayEditRange ($user_id=null)
	userMayAdministerRange ($user_id=null)
Public Member Functions inherited from SimpleORMap
	__construct ($id=null)
	__clone ()
	getRelationOptions ($relation)
	getTableMetadata ()
	hasAutoIncrementColumn ()
	setId ($id)
	getId ()
	getNewId ()
	toArray ($only_these_fields=null)
	toRawArray ($only_these_fields=null)
	toArrayRecursive ($only_these_fields=null)
	getValue ($field)
	getRelationValue ($relation, $field)
	getDefaultValue ($field)
	setValue ($field, $value)
	__get ($field)
	__set ($field, $value)
	__isset ($field)
	offsetExists ($offset)
	offsetGet ($offset)
	offsetSet ($offset, $value)
	offsetUnset ($offset)
	getIterator ()
	count ()
	isField ($field)
	isAdditionalField ($field)
	isAliasField ($field)
	isI18nField ($field)
	setData ($data, $reset=false)
	isNew ()
	isDeleted ()
	setNew ($is_new)
	getWhereQuery ()
	restore ()
	store ()
	triggerChdate ()
	delete ()
	isDirty ()
	isFieldDirty ($field)
	revertValue ($field)
	getPristineValue ($field)
	initRelation ($relation)
	resetRelation ($relation)
	cleanup ()

Static Public Member Functions
static	findCurrent ()
static	build ($data, $is_new=true)
static	findFull ($id)
static	findFullMany ($ids, $order_by='')
static	findByUsername ($username)
static	findByDatafield ($datafield_id, $value)
static	findDozentenByTermin_id ($termin_id)
static	search ($attributes)
static	convert ($old_id, $new_id, $identity=false)
static	exportUserData (StoredUserData $storage)
Static Public Member Functions inherited from SimpleORMap
static	tableScheme ($db_table)
static	expireTableScheme ()
static	find ($id)
static	exists ($id)
static	countBySql ($sql=1, $params=[])
static	create ($data)
static	build ($data, $is_new=true)
static	buildExisting ($data)
static	import ($data)
static	findBySQL ($sql, $params=[])
static	findOneBySQL ($where, $params=[])
static	findThru ($foreign_key_value, $options)
static	findEachBySQL ($callable, $sql, $params=[])
static	findMany ($pks=[], $order='', $order_params=[])
static	findEachMany ($callable, $pks=[], $order='', $order_params=[])
static	findAndMapBySQL ($callable, $where, $params=[])
static	findAndMapMany ($callable, $pks=[], $order='', $order_params=[])
static	deleteBySQL ($where, $params=[])
static	toObject ($id_or_object)
static	__callStatic ($name, $arguments)

Static Protected Member Functions
static	configure ($config=[])
static	configure ($config=[])
Static Protected Member Functions inherited from SimpleORMap
static	configure ($config=[])
static	config ($key)

Additional Inherited Members
Data Fields inherited from SimpleORMap
const	ID_SEPARATOR = '_'
Static Public Attributes inherited from SimpleORMap
static	$schemes = null
Protected Member Functions inherited from SimpleORMap
	_getId ($field)
	_setId ($field, $value)
	_getAdditionalValueFromRelation ($field)
	_setAdditionalValueFromRelation ($field, $value)
	_getAdditionalValue ($field)
	_setAdditionalValue ($field, $value)
	parseRelationOptions ($type, $name, $options)
	storeRelations ($only_these=null)
	deleteRelations ()
	initializeContent ()
	applyCallbacks ($type)
	registerCallback ($types, $cb)
	unregisterCallback ($types, $cb)
	cbAutoIncrementColumn ($type)
	cbAutoKeyCreation ()
	cbNotificationMapper ($cb_type)
	cbAfterInitialize ($cb_type)
	setSerializedValue ($field, $value)
	setI18nValue ($field, $value)
	cbI18N ($type)
Protected Attributes inherited from SimpleORMap
	$content = []
	$content_db = []
	$is_new = true
	$is_deleted = false
	$db_table = ''
	$db_fields = null
	$pk = null
	$default_values = []
	$serialized_fields = []
	$alias_fields = []
	$i18n_fields = []
	$additional_fields = []
	$relations = []
	$has_many = []
	$has_one = []
	$belongs_to = []
	$has_and_belongs_to_many = []
	$registered_callbacks = []
	$known_slots = []
	$notification_map = []
	$additional_data = []
	$getter_setter_map = []
Static Protected Attributes inherited from SimpleORMap
static	$config = []
static	$reserved_slots = ['value','newid','iterator','tablemetadata', 'relationvalue','wherequery','relationoptions','data','new','id']

Member Function Documentation

build()

static build (   $data,   $is_new = true  )

static

build new object with given data

Parameters

$data

array assoc array of record

Returns

User

Reimplemented from SimpleORMap.

Here is the call graph for this function:

Here is the caller graph for this function:

changeEmail()

changeEmail	(		$email,
			$force = false
	)

Changes a user's email adress.

Parameters

string	$email	New email
bool	$force	Force update (even if nothing actually changed)

Returns

bool

Here is the call graph for this function:

configure()

static configure (   $config = [] )

staticprotected

Parameters

string

$id

primary key of table

Reimplemented from AuthUserMd5.

convert()

static convert (   $old_id,   $new_id,   $identity = false  )

static

Merge an user ($old_id) to another user ($new_id). This is a part of the old numit-plugin.

Parameters

string	$old_user
string	$new_user
boolean	$identity	merge identity (if true)

Returns

array() messages to display after migration

Deprecated:

Here is the call graph for this function:

Here is the caller graph for this function:

describeRange()

describeRange

(

)

Returns a descriptive text for the range type.

Returns

string

exportUserData()

static exportUserData ( StoredUserData  $storage )

static

Export available data of a given user into a storage object (an instance of the StoredUserData class) for that user.

Parameters

StoredUserData

$storage

object to store data into

Here is the call graph for this function:

findByDatafield()

static findByDatafield (   $datafield_id,   $value  )

static

returns an array of User-objects that have the given value in the given datafield.

Parameters

string	$datafield_id
	array	of User

Here is the call graph for this function:

findByUsername()

static findByUsername (   $username )

static

return user object for given username

Parameters

string

$username

a username

Returns

User

Here is the caller graph for this function:

findCurrent()

static findCurrent ( )

static

Returns the currently authenticated user.

Returns

User User

Here is the caller graph for this function:

findDozentenByTermin_id()

static findDozentenByTermin_id (   $termin_id )

static

Here is the call graph for this function:

findFull()

static findFull (   $id )

static

Returns user object including user_info

Parameters

string

$id

Returns

User User

Here is the call graph for this function:

Here is the caller graph for this function:

findFullMany()

static findFullMany (   $ids,   $order_by = ''  )

static

Returns user objects including user_info

Parameters

array	$ids
string	$order_by

Returns

User[] User

Here is the caller graph for this function:

getFullName()

getFullName

(

$format = 'full'

)

returns the name in specified format (formats defined in $GLOBALS['_fullname_sql'])

Parameters

string

one of full,full_rev,no_title,no_title_rev,no_title_short,no_title_motto,full_rev_username

Returns

string guess what - the fullname

Here is the call graph for this function:

Here is the caller graph for this function:

getHomepageElements()

getHomepageElements

(

)

Builds an array containing all available elements that are part of a user's homepage together with their visibility. It isn't sufficient to just load the visibility settings from database, because if the user has added some data (e.g. CV) but not yet assigned a special visibility to that field, it wouldn't show up.

Returns

array An array containing all available homepage elements together with their visibility settings in the form $name => $visibility.

Here is the call graph for this function:

getInstitutePerms()

getInstitutePerms

(

)

This function returns the perms allowed for an institute for the current user

Returns

array list of perms

getPristineValue()

getPristineValue

(

$field

)

returns unmodified value of given field

Parameters

string

$field

Exceptions

InvalidArgumentException

Returns

mixed

Reimplemented from SimpleORMap.

getRangeId()

getRangeId

(

)

Returns the id of the current range

Returns

mixed (string|int)

getRangeType()

getRangeType

(

)

Returns a unique identificator for the range type.

Returns

string

getRoles()

getRoles

(

$with_implicit = false

)

Returns the roles that were assigned to the user.

Parameters

boolean

$with_implicit

Returns

array

Here is the call graph for this function:

getStudipKingIcon()

getStudipKingIcon

(

)

Get the decorated StudIP-Kings information

Returns

String

Here is the call graph for this function:

hasRole()

hasRole	(		$role,
			$institute_id = ''
	)

Returns whether the user was assigned a certain role.

Parameters

string	$role	The role to check
string	$institute_id	An optional institute_id

Returns

bool True if the user was assigned this role, false otherwise

Here is the call graph for this function:

initRelation()

initRelation

(

$relation

)

Parameters

string

$relation

Reimplemented from SimpleORMap.

Here is the call graph for this function:

isDirty()

isDirty

(

)

checks if at least one field was modified since last restore

Returns

boolean

Reimplemented from SimpleORMap.

Here is the caller graph for this function:

isFieldDirty()

isFieldDirty

(

$field

)

checks if given field was modified since last restore

Parameters

string

$field

Returns

boolean

Reimplemented from SimpleORMap.

isFriendOf()

isFriendOf

(

$another_user

)

Returns whether the given user is stored in contacts.

Parameters

User

$another_user

Returns

bool

Here is the call graph for this function:

revertValue()

revertValue

(

$field

)

reverts value of given field to last restored value

Parameters

string

$field

Returns

mixed the restored value

Reimplemented from SimpleORMap.

search()

static search (   $attributes )

static

Temporary migrate to User.class.php

Parameters

$attributes

Returns

array

Here is the call graph for this function:

Here is the caller graph for this function:

store()

store

(

)

See also

SimpleORMap::store()

Reimplemented from SimpleORMap.

Here is the call graph for this function:

Here is the caller graph for this function:

toArrayRecursive()

toArrayRecursive

(

$only_these_fields = null

)

returns data of table row as assoc array including related records with a 'has*' relationship recurses one level without param

$only_these_fields limits output for relationships in this way: $only_these_fields = array('field_1', 'field_2', 'relation1', 'relation2' => array('rel2_f1', 'rel2_f2', 'rel2_rel11' => array( rel2_rel1_f1) ) ) Here all fields of relation1 will be returned.

Parameters

mixed

$only_these_fields

limit returned fields

Returns

array

Reimplemented from SimpleORMap.

toRawArray()

toRawArray

(

$only_these_fields = null

)

Returns data of table row as assoc array with raw contents like they are in the database. Pass array of fieldnames or ws separated string to limit fields.

Parameters

mixed

$only_these_fields

Returns

array

Reimplemented from SimpleORMap.

triggerChdate()

triggerChdate

(

)

See also

SimpleORMap::triggerChdate()

Reimplemented from SimpleORMap.

userMayAccessRange()

userMayAccessRange

(

$user_id = null

)

Decides whether the user may access the range.

Parameters

string

$user_id

Optional id of a user, defaults to current user

Returns

bool

Here is the call graph for this function:

userMayAdministerRange()

userMayAdministerRange

(

$user_id = null

)

Decides whether the user may administer the range.

Parameters

string

$user_id

Optional id of a user, defaults to current user

Returns

bool

Here is the call graph for this function:

userMayEditRange()

userMayEditRange

(

$user_id = null

)

Decides whether the user may edit/alter the range.

Parameters

string

$user_id

Optional id of a user, defaults to current user

Returns

bool

Here is the call graph for this function:

Here is the caller graph for this function:

---

The documentation for this class was generated from the following file:

• lib/models/User.class.php