PersonalNotifications Class Reference

Inheritance diagram for PersonalNotifications:

Collaboration diagram for PersonalNotifications:

Public Member Functions
	getLiElement ()
	more_unseen ()
Public Member Functions inherited from SimpleORMap
	__construct ($id=null)
	__clone ()
	getRelationOptions ($relation)
	getTableMetadata ()
	hasAutoIncrementColumn ()
	setId ($id)
	getId ()
	getNewId ()
	toArray ($only_these_fields=null)
	toArrayRecursive ($only_these_fields=null)
	getValue ($field)
	getRelationValue ($relation, $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)
	setData ($data, $reset=false)
	haveData ()
	isNew ()
	isDeleted ()
	setNew ($is_new)
	getWhereQuery ()
	restore ()
	store ()
	triggerChdate ()
	delete ()
	isDirty ()
	isFieldDirty ($field)
	revertValue ($field)
	getPristineValue ($field)
	initRelation ($relation)
	resetRelation ($relation)

Static Public Member Functions
static	doGarbageCollect ()
static	add ($user_ids, $url, $text, $html_id=null, $avatar=null)
static	getMyNotifications ($only_unread=true, $user_id=null, $limit=15)
static	markAsRead ($notification_id, $user_id=null)
static	markAsReadByHTML ($html_id, $user_id=null)
static	activate ($user_id=null)
static	deactivate ($user_id=null)
static	activateAudioFeedback ($user_id=null)
static	deactivateAudioFeedback ($user_id=null)
static	isGloballyActivated ()
static	isActivated ($user_id=null)
static	isAudioActivated ($user_id=null)
Static Public Member Functions inherited from SimpleORMap
static	expireTableScheme ()
static	find ($id)
static	exists ($id)
static	countBySql ($sql=1, $params=array())
static	create ($data)
static	build ($data, $is_new=true)
static	buildExisting ($data)
static	import ($data)
static	findBySQL ($sql, $params=array())
static	findByObject (SimpleORMap $object)
static	findOneBySQL ($where, $params=array())
static	findThru ($foreign_key_value, $options)
static	findEachBySQL ($callable, $sql, $params=array())
static	findMany ($pks=array(), $order= '', $order_params=array())
static	findEachMany ($callable, $pks=array(), $order= '', $order_params=array())
static	findAndMapBySQL ($callable, $where, $params=array())
static	findAndMapMany ($callable, $pks=array(), $order= '', $order_params=array())
static	deleteBySQL ($where, $params=array())
static	toObject ($id_or_object)
static	__callStatic ($name, $arguments)

Static Protected Member Functions
static	configure ($config=array())
Static Protected Member Functions inherited from SimpleORMap
static	tableScheme ($db_table)

Additional Inherited Members
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)
	getTableScheme ()
	storeRelations ($only_these=null)
	deleteRelations ()
	initializeContent ()
	applyCallbacks ($type)
	registerCallback ($types, $cb)
	unregisterCallback ($types, $cb)
	cbAutoIncrementColumn ($type)
	cbAutoKeyCreation ()
	cbNotificationMapper ($cb_type)
	setSerializedValue ($field, $value)
Protected Attributes inherited from SimpleORMap
	$content = array()
	$content_db = array()
	$is_new = true
	$db_table = ''
	$db_fields = null
	$pk = null
	$default_values = array()
	$serialized_fields = array()
	$alias_fields = array()
	$additional_fields = array()
	$relations = array()
	$has_many = array()
	$has_one = array()
	$belongs_to = array()
	$has_and_belongs_to_many = array()
	$registered_callbacks
	$known_slots = array()
	$reserved_slots = array('value','newid','iterator','tablemetadata', 'relationvalue','wherequery','relationoptions','data','new','id')
	$notification_map = array()
	$additional_data = array()
Static Protected Attributes inherited from SimpleORMap
static	$schemes = null
static	$config = array()

Member Function Documentation

static activate (   $user_id = null )

static

Activates personal notifications for a given user.

Parameters

string | null

$user_id

: ID of special user the notification should belong to or (default:) null for current user

Here is the call graph for this function:

Here is the caller graph for this function:

static activateAudioFeedback (   $user_id = null )

static

Activates audio plopp for new personal notifications for a given user.

Parameters

string | null

$user_id

: ID of special user the notification should belong to or (default:) null for current user

Here is the call graph for this function:

Here is the caller graph for this function:

static add (   $user_ids,   $url,   $text,   $html_id = null,   $avatar = null  )

static

Central function to add a personal notification to the user. This could be anything that needs to catch the attention of the user. The notification will be displayed in realtime to the user and he/she can get to the url.

Parameters

array | string	$user_ids	: array of user_ids or a single md5-user_id
string	$url	: URL of the point of interest of the notification
string	$text	: a displayed text that describes the notification
null | string	$html_id	: id in the html-document. If user reaches this html-element the notification will be marked as read, so the user does not need to handle the information twice. Optional. Default: null
string	$avatar	: URL of an image for the notification. Best size: 40px x 40px

Returns

boolean : true on success

Here is the call graph for this function:

Here is the caller graph for this function:

static configure (   $config = array() )

staticprotected

set configuration data from subclass

Parameters

array

$config

configuration data

Returns

void

Reimplemented from SimpleORMap.

static deactivate (   $user_id = null )

static

Deactivates personal notifications for a given user.

Parameters

string | null

$user_id

: ID of special user the notification should belong to or (default:) null for current user

Here is the call graph for this function:

Here is the caller graph for this function:

static deactivateAudioFeedback (   $user_id = null )

static

Deactivates audio plopp for new personal notifications for a given user.

Parameters

string | null

$user_id

: ID of special user the notification should belong to or (default:) null for current user

Here is the call graph for this function:

Here is the caller graph for this function:

static doGarbageCollect ( )

static

Here is the call graph for this function:

Here is the caller graph for this function:

getLiElement

(

)

Returns HTML-represantation of the notification which is a list-element.

Returns

string : html-output;

static getMyNotifications (   $only_unread = true,   $user_id = null,   $limit = 15  )

static

Returns all notifications fitting to the parameters.

Parameters

boolean	$only_unread	: true for getting only unread notifications, false for all.
null | string	$user_id	: ID of special user the notification should belong to or (default:) null for current user

Returns

array of in ascending order of mkdate

Here is the call graph for this function:

Here is the caller graph for this function:

static isActivated (   $user_id = null )

static

Checks if a given user should see the personal notification. Either the Stud.IP or the user could deactivate personal notification. If neither is the case, this function returns true.

Parameters

string | null

$user_id

: ID of special user the notification should belong to or (default:) null for current user

Returns

boolean : true if activated else false

Here is the call graph for this function:

Here is the caller graph for this function:

static isAudioActivated (   $user_id = null )

static

Checks if a given user should hear audio plopp for new personal notification. Either the Stud.IP or the user could deactivate personal notification or audio feedback. If neither is the case, this function returns true.

Parameters

string | null

$user_id

: ID of special user the notification should belong to or (default:) null for current user

Returns

boolean : true if activated else false

Here is the call graph for this function:

static isGloballyActivated ( )

static

Checks if personal notifications are activated for the whole Stud.IP. This could be false for performance issues.

Returns

boolean : true if activated else false

Here is the caller graph for this function:

static markAsRead (   $notification_id,   $user_id = null  )

static

Mark a notification as read by the user. It won't appear anymore in the notification-list on top of its site.

Parameters

string	$notification_id	: ID of the notification
string | null	$user_id	: ID of special user the notification should belong to or (default:) null for current user

Returns

boolean : true on success, false if it failed.

Here is the call graph for this function:

Here is the caller graph for this function:

static markAsReadByHTML (   $html_id,   $user_id = null  )

static

Mark a notification as read for the user by the given HTML-ID. It won't appear anymore in the notification-list on top of its site.

Parameters

string	$html_id	: HTML ID attribute of the notification
string | null	$user_id	: ID of special user the notification should belong to or (default:) null for current user

Returns

boolean : true on success, false if it failed.

Here is the call graph for this function:

Here is the caller graph for this function:

more_unseen

(

)

Here is the call graph for this function:

---

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

• lib/models/PersonalNotifications.class.php