Inheritance diagram for CalendarEvent:

Public Member Functions
	getOwner ()

	__clone ()

	toStringCategories ($as_array=false)

	toStringGroupStatus ($status=null)

	getRecurrence ($index=null)

	setRecurrence ($r_rule)

	toStringRecurrence ($only_type=false)

	toStringPriority ()

	toStringAccessibility ()

	getExceptions ()

	setExceptions ($exceptions)

	getTitle ()

	setTitle ($title)

	getStart ()

	setStart ($timestamp)

	getEnd ()

	setEnd ($timestamp)

	getAuthorId ()

	setAuthorId ($author_id)

	setEditorId ($editor_id)

	getDuration ()

	getLocation ()

	getUid ()

	getDescription ()

	getCategory ()

	getUserDefinedCategories ()

	setUserDefinedCategories ($categories)

	setAccessibility ($class)

	setPriority ($priority)

	getEditorId ()

	isDayEvent ()

	getAccessibility ()

	getAccessibilityOptions ($permission)

	getChangeDate ()

	getImportDate ()

	getType ()

	getPriority ()

	getName ()

	getProperties ()

	getProperty ($name)

	setPermissionUser ($user_id)

	havePermission ($permission, $user_id=null)

	getPermission ($user_id=null)

	getAuthor ()

	getEditor ()

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)

	isRelation ($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 ()

Public Member Functions inherited from Event
	toStringCategories ()

Static Public Member Functions
static	deleteBySQL ($where, $params=[])

static	findByUid ($uid, $range_id=null)

static	getEventsByInterval ($range_id, DateTime $start, DateTime $end)

static	exportUserData (StoredUserData $storage)

Static Public Member Functions inherited from SimpleORMap
static	tableScheme ($db_table)

static	expireTableScheme ()

static	exists ($id)

static	countBySql ($sql= '1', $params=[])

static	create ($data)

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)

Data Fields
const	PARTSTAT_TENTATIVE = 1

const	PARTSTAT_ACCEPTED = 2

const	PARTSTAT_DECLINED = 3

const	PARTSTAT_DELEGATED = 4

const	PARTSTAT_NEEDS_ACTION = 5

Data Fields inherited from SimpleORMap
const	ID_SEPARATOR = '_'

Data Fields inherited from Event
const	PERMISSION_FORBIDDEN = 0

const	PERMISSION_CONFIDENTIAL = 1

const	PERMISSION_READABLE = 2

const	PERMISSION_DELETABLE = 3

const	PERMISSION_WRITABLE = 4

const	PERMISSION_OWN = 5

Static Protected Member Functions
static	configure ($config=[])

Static Protected Member Functions inherited from SimpleORMap
static	db_table ()

static	db_fields ()

static	pk ()

static	default_values ()

static	serialized_fields ()

static	alias_fields ()

static	i18n_fields ()

static	additional_fields ()

static	has_many ()

static	has_one ()

static	belongs_to ()

static	has_and_belongs_to_many ()

static	registered_callbacks ()

static	known_slots ()

static	notification_map ()

static	getter_setter_map ()

static	configure ($config=[])

static	config ($key)

static	registerCallback ($types, $cb)

static	unregisterCallback ($types, $cb)

Additional Inherited Members
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)

	cbNotificationMapper ($cb_type)

	cbAfterInitialize ($cb_type)

	setSerializedValue ($field, $value)

	setI18nValue ($field, $value)

Protected Attributes inherited from SimpleORMap
	$content = []

	$content_db = []

	$is_new = true

	$is_deleted = false

	$relations = []

	$additional_data = []

Static Protected Attributes inherited from SimpleORMap
static	$config = []

static	$reserved_slots = ['value','newid','iterator','tablemetadata', 'relationvalue','wherequery','relationoptions','data','new','id']

static	$performs_batch_operation = false

Member Function Documentation

__clone ( )

Keeps the event data

static configure ( $config = [] )

staticprotected

static deleteBySQL	(	$where,
		$params = `[]`
	)

static

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

Implements PrivacyObject.

static findByUid	(	$uid,
		$range_id = `null`
	)

static

Finds calendar events by the uid of the event data.

Parameters

string $uid The global unique id of this event.

Returns: null|CalendarEvent The calendar event, an array of calendar events or null.

getAccessibility ( )

Returns the state of accessibility as string. Possible values: PUBLIC, PRIVATE, CONFIDENTIAL The default is CONFIDENTIAL.

Returns: string

Implements Event.

getAccessibilityOptions ( $permission )

Returns an array with options for accessibility depending on the permission of the given calendar permission.

Parameters

int $permission The calendar permission

Returns: array The accessibility options.

getAuthor ( )

Returns the user id of the event's author.

Returns: string The user id of the author.

Implements Event.

getAuthorId ( )

Returns the user id of the author.

Returns: string User id of the author.

getCategory ( )

Returns the index of the category. If the user has no permission, 255 is returned.

See Also: config/config.inc.php $TERMIN_TYP

Returns: int The index of the category

Implements Event.

getChangeDate ( )

Returns: type

Implements Event.

getDescription ( )

Returns the description of the topic. If the user has no permission or the event has no topic or the topics have no descritopn an empty string is returned.

Returns: String the description

Implements Event.

getDuration ( )

Returns the duration of this event in seconds.

Returns: int the duration of this event in seconds

Implements Event.

getEditor ( )

Returns teh user id of the event's last editor.

Returns: string The uder id og the editor.

Implements Event.

getEditorId ( )

Returns the user id of the editor.

Returns: string User id of the editor

Implements Event.

getEnd ( )

Returns the endtime as unix timestamp of this event.

Returns: int the endtime of this event as a unix timestamp

Implements Event.

static getEventsByInterval	(		$range_id,
		DateTime	$start,
		DateTime	$end
	)

static

Returns all CalendarEvents in the given time range for the given range_id.

Parameters

string	$range_id	Id of Stud.IP object from type user, course, inst
DateTime	$start	The start date time.
DateTime	$end	The end date time.

Returns: SimpleORMapCollection Collection of found CalendarEvents.

getExceptions ( )

Returns the exceptions as array of unix timestamps.

Returns: array Array of unix timestamps.

getImportDate ( )

Returns the date time the event was imported.

TODO not sure if we need this anymore

Returns: int Date time of import as unix timestamp:

Implements Event.

getLocation ( )

Returns the location. Without permission or the location is not set an empty string is returned.

Returns: string The location

Implements Event.

getName ( )

Returns: string

getOwner ( )

Returns the owner of this event as an object of type User, Course or Institute.

Returns: object

getPermission ( $user_id = null )

Returns the permission of the given user or the user set by CalendarEvent::setPermssionUser previously.

array $permissions

Parameters

string $user_id The user's id.

Returns: int The permission.

Implements Event.

getPriority ( )

Returns the priority: 0 means priority is not stated 1 means "high" 2 means "middle" 3 means "low" If the user has no permission it returns 0.

Returns: int The priority.

getProperties ( )

Returns all properties of this event. The name of the properties correspond to the properties of the iCalendar calendar data exchange format. There are a few properties with the suffix STUDIP_ which have no eqivalent in the iCalendar format.

DTSTART: The start date-time as unix timestamp. DTEND: The end date-time as unix timestamp. SUMMARY: The short description (title) that will be displayed in the views. DESCRIPTION: The long description. UID: The global unique id of this event. CLASS: CATEGORIES: A comma separated list of categories. PRIORITY: The priority. LOCATION: The location. EXDATE: A comma separated list of unix timestamps. CREATED: The creation date-time as unix timestamp. LAST-MODIFIED: The date-time of last modification as unix timestamp. DTSTAMP: The cration date-time of this instance of the event as unix timestamp. RRULE: All data for the recurrence rule for this event as array. EVENT_TYPE:

Returns: array The properties of this event.

Implements Event.

getProperty ( $name )

Returns the value of property with given name.

Parameters

type $name See CalendarEvent::getProperties() for accepted values.

Returns: mixed The value of the property.

Exceptions

InvalidArgumentException

Implements Event.

getRecurrence ( $index = null )

Returns all values that defines a recurrence rule or a single value named by $index.

Parameters

string $index Name of the value to retrieve (optional).

Returns: string|array The value(s) of the recurrence rule.

Exceptions

InvalidArgumentException

Implements Event.

getStart ( )

Returns the starttime as unix timestamp of this event.

Returns: int The starttime of this event as a unix timestamp

Implements Event.

getTitle ( )

Returns the title of this event. If the user has not the permission Event::PERMISSION_READABLE, the title is "Keine Berechtigung.".

Returns: string

Implements Event.

getType ( )

Returns the object type this event belongs to. Possible values are 'user', 'sem', 'inst', 'fak'.

Returns: string The object type.

Implements Event.

getUid ( )

Returns the global unique id of this event.

Returns: string The global unique id.

Implements Event.

getUserDefinedCategories ( )

Returns a csv list of categories. If no categories are stated or the user has no permission an empty string will be returned.

Returns: string csv list of categories or empty string

havePermission	(	$permission,
		$user_id = `null`
	)

Checks the permission of the user previously set with CalendarEvent::setPermissisonUser or given by second argument. Returns true if the user have the at least the given permission.

Parameters

int	$permission
string	$user_id

Returns: boolean

Implements Event.

isDayEvent ( )

Returns whether this event is an all day event.

Returns: boolean true if all day event

Implements Event.

setAccessibility ( $class )

Sets the accessibility (class). Possible classes are 'PUBLIC', 'PRIVATE' and 'CONFIDENTIAL'. If the given class is unknown, the event gets the class 'PRIVATE'.

Parameters

string $class The name of the class.

setAuthorId ( $author_id )

Sets the author by given user id.

Parameters

string $author_id User id of the author.

setEditorId ( $editor_id )

Sets the editor id by given user id.

Parameters

string $editor_id User id of the editor.

setEnd ( $timestamp )

Sets the end date time by given unix timestamp.

Parameters

string $timestamp Unix timestamp.

setExceptions ( $exceptions )

Sets proper timestamps as exceptions for given unix timestamps.

Parameters

array $exceptions Array of exceptions as unix timestamps.

setPermissionUser ( $user_id )

Sets the user_id to check his permission.

Parameters

string $user_id The id of the user.

setPriority ( $priority )

Sets the priority. Possible values are 0: not specified 1: high 2: middle 3: low Default is 0.

Parameters

int $priority The priority between 0 and 3.

setRecurrence ( $r_rule )

TODO should throw an exception if input values are wrong

Parameters

array $r_rule

Returns: array|false The values of the recurrence rule.

setStart ( $timestamp )

Sets the start date time with given unix timestamp.

Parameters

string $timestamp Unix timestamp.

setTitle ( $title )

Sets the title of this event.

Parameters

type $title The title of this event.

setUserDefinedCategories ( $categories )

Stores user defined categories as a csv list.

Parameters

array | string $categories An array or csv list of user defined categories.

toStringAccessibility ( )

Returns the accessibilty in a human readable form. If the user has no permission an epmty string will be returned.

Returns: string The accessibility as string.

Implements Event.

toStringCategories ( $as_array = false )

Returns a list of all categories the event belongs to. Returns an empty string if no permission.

Returns: string All categories as list.

toStringGroupStatus ( $status = null )

Returns the name of the group status. Returns an empty string status is unknown.

Returns: string All categories as list.

toStringPriority ( )

Returns the priority in a human readable form. If the user has no permission an epmty string will be returned.

Returns: string The priority as a string.

Implements Event.

toStringRecurrence ( $only_type = false )

Returns a string representation of the recurrence rule. If $only_type is true returns only the type of the recurrence.

Parameters

bool $only_type If true returns only the type of recurrence.

Returns: string The recurrence rule - human readable

Implements Event.

Field Documentation

const PARTSTAT_ACCEPTED = 2

const PARTSTAT_DECLINED = 3

const PARTSTAT_DELEGATED = 4

const PARTSTAT_NEEDS_ACTION = 5

const PARTSTAT_TENTATIVE = 1

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

lib/models/CalendarEvent.class.php

Public Member Functions

Static Public Member Functions

Data Fields

Static Protected Member Functions

Additional Inherited Members

Member Function Documentation

Field Documentation