Inheritance diagram for Clipboard:

Collaboration diagram for Clipboard:

Public Member Functions
	addItem ($range_id=null, $range_type='StudipItem')

	removeItem ($range_id=null)

	getContent ()

	getAllRangeIds ($range_types='StudipItem')

	getSomeRangeIds ($range_types='StudipItem', $item_ids=[])

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	configure ($config=[])

static	getClipboardsForUser ($user_id='', $item_range_types=[])

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

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	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)

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)

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

static	config ($key)

Protected Attributes inherited from SimpleORMap
	$content = array()

	$content_db = array()

	$is_new = true

	$is_deleted = false

	$db_table = ''

	$db_fields = null

	$pk = null

	$default_values = array()

	$serialized_fields = array()

	$alias_fields = array()

	$i18n_fields = array()

	$additional_fields = array()

	$relations = array()

	$has_many = array()

	$has_one = array()

	$belongs_to = array()

	$has_and_belongs_to_many = array()

	$registered_callbacks = array()

	$known_slots = array()

	$notification_map = array()

	$additional_data = array()

	$getter_setter_map = array()

Static Protected Attributes inherited from SimpleORMap
static	$config = array()

static	$reserved_slots = array('value','newid','iterator','tablemetadata', 'relationvalue','wherequery','relationoptions','data','new','id')

Member Function Documentation

◆ addItem()

addItem	(	$range_id = `null`,
		$range_type = `'StudipItem'`
	)

Adds an item to the clipboard by specifying the ID of the object that shall be added to it.

Parameters

string $range_id The ID of the object that shall be added.

Exceptions

ClipboardException If an error occurs.

Returns: ClipboardItem A ClipboardItem instance on success, false on failure.

◆ configure()

static configure ( $config = [] )

static

set configuration data from subclass

Parameters

array $config configuration data

Returns: void

Reimplemented from SimpleORMap.

◆ getAllRangeIds()

getAllRangeIds ( $range_types = 'StudipItem' )

Retrieves all range-IDs of objects that are associated with this clipboard. The objects can be filtered by their range type.

Parameters

string | string[] $range_types The class name(s) of the objects which shall be included in the result set. This parameter can be a string or an array of strings.

Returns: string[] An array with all range-IDs that match the specified range type.

Here is the call graph for this function:

◆ getClipboardsForUser()

static getClipboardsForUser	(	$user_id = `''`,
		$item_range_types = `[]`
	)

static

This class returns all clipboards for a specified user, optionally filtered by required item range types.

Parameters

string	$user_id,	The ID of the user whose clipboards shall be returned.
array	$item_range_types,	The range types which at least one item of the clipboard must have to be included in the result set.

Returns: Clipboard[] An array of clipboard objects which are associated with the user specified by $user_id.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getContent()

getContent ( )

Formats the content of the clipboard for display. This method should be overloaded by derived classes to output the data of the clipboard with appropriate names and other attributes which may be needed.

Returns: string[][] A two-dimensional array with strings. The first dimension represents the list of clipboard items. The second dimension represents an item and holds at least the following attributes of the item: id, name. These attributes are the keys of the second array dimension. The array has the following structure: [ [ 'id' => (id of the item) 'name' => (name of the item) ], [ â¦ ] ]

Derived classes may add further attributes to the array, if necessary.

◆ getSomeRangeIds()

getSomeRangeIds	(	$range_types = `'StudipItem'`,
		$item_ids = `[]`
	)

Retrieves specific range-IDs of objects that are associated with this clipboard and referenced by the specified clipboard item-IDs. The objects can be filtered by their range type, too.

Parameters

string \| string[]	$range_types	The class name(s) of the objects which shall be included in the result set. This parameter can be an array or a string.
string[]	$item_ids	The item-IDs of the clipboard items whose range-IDs shall be included in the result set. Note that the clipboard items must be associated with this clipboard.

Returns: string[] An array with all range-IDs that match the specified range type.

Here is the call graph for this function:

◆ removeItem()

removeItem ( $range_id = null )

Removes an item from the clipboard by specifying the ID of the object that shall be removed from the pad.

Parameters

string $range_id The ID of the object that shall be removed.

Returns: bool True on success, false on failure.

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

lib/models/Clipboard.class.php

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Member Function Documentation

◆ addItem()

◆ configure()

◆ getAllRangeIds()

◆ getClipboardsForUser()

◆ getContent()

◆ getSomeRangeIds()

◆ removeItem()