Class cApiPropertyCollection

Property collection

cGenericDb

cApiPropertyCollection

Package: Core\GenericDB\Model
Copyright: four for business AG <www.4fb.de>
License: http://www.contenido.org/license/LIZENZ.txt
Author: Murat Purc murat@purc.de
Located at classes/contenido/class.property.php

Methods summary
`public`	# `__construct( integer $idclient = 0 )` Constructor function Constructor function Parameters `$idclient` Client id Throws `cInvalidArgumentException` If table name or primary key is not set Overrides `ItemCollection::__construct()`
`public static`	# `reset( )` Resets the states of static properties. Resets the states of static properties.
`public cApiProperty`	# `create( mixed $itemtype, mixed $itemid, mixed $type, mixed $name, mixed $value, boolean $bDontEscape = false )` Creates a new property item. Creates a new property item. Example: $properties = new cApiPropertyCollection($clientid); $property = $properties->create('idcat', 27, 'visual', 'image', 'images/tool.gif'); Parameters `$itemtype` Type of the item (example: idcat) `$itemid` ID of the item (example: 31) `$type` Type of the data to store (arbitary data) `$name` Entry name `$value` Value `$bDontEscape` Optionally default false (on internal call do not escape parameters again NOTE: This parameter is deprecated since 2013-11-26 Returns `cApiProperty`
`public mixed`	# `getValue( mixed $itemtype, mixed $itemid, mixed $type, mixed $name, mixed $default = false )` Returns the value for a given item. Returns the value for a given item. Example: $properties = new cApiPropertyCollection($clientid); $value = $properties->getValue('idcat', 27, 'visual', 'image'); Parameters `$itemtype` Type of the item (example: idcat) `$itemid` ID of the item (example: 31) `$type` Type of the data to store (arbitary data) `$name` Entry name `$default` to be returned if no item was found Returns mixed Value
`public array`	# `getValuesByType( mixed $itemtype, mixed $itemid, mixed $type )` Returns the value for a given item. Returns the value for a given item. Example: $properties = new cApiPropertyCollection($clientid); $values = $properties->getValuesByType('idcat', 27, 'visual'); Parameters `$itemtype` Type of the item (example: idcat) `$itemid` ID of the item (example: 31) `$type` Type of the data to store (arbitary data) Returns array Value
`public array`	# `getValuesOnlyByTypeName( mixed $type, mixed $name )` Returns the values only by type and name. Returns the values only by type and name. Example: $properties = new cApiPropertyCollection($clientid); $values = $properties->getValuesOnlyByTypeName('note', 'category'); Parameters `$type` $itemtype Type of the item (example: idcat) `$name` Type of the data to store (arbitary data) Returns array Value
`public`	# `setValue( mixed $itemtype, mixed $itemid, mixed $type, mixed $name, mixed $value, integer $idProp = 0 )` Sets a property item. Handles creation and updating. Existing item will be updated, not existing item will be created. Sets a property item. Handles creation and updating. Existing item will be updated, not existing item will be created. Example: $properties = new cApiPropertyCollection($clientid); $properties->setValue('idcat', 27, 'visual', 'image', 'images/tool.gif'); Parameters `$itemtype` Type of the item (example: idcat) `$itemid` ID of the item (example: 31) `$type` Type of the data to store (arbitary data) `$name` Entry name `$value` Value `$idProp` Id of database record (if set, update on this basis (possiblity to update name value and type))
`public`	# `deleteValue( mixed $itemtype, mixed $itemid, mixed $type, mixed $name )` Delete a property item. Delete a property item. Example: $properties = new cApiPropertyCollection($clientid); $properties->deleteValue('idcat', 27, 'visual', 'image'); Parameters `$itemtype` Type of the item (example: idcat) `$itemid` ID of the item (example: 31) `$type` Type of the data to store (arbitary data) `$name` Entry name
`public array`	# `getProperties( mixed $itemtype, mixed $itemid )` Checks if values for a given item are available. Checks if values for a given item are available. Parameters `$itemtype` Type of the item (example: idcat) `$itemid` ID of the item (example: 31) Returns array For each given item
`public array`	# `getAllValues( mixed $field, mixed $fieldValue, cAuth $auth = NULL )` Returns all datasets selected by given field and value combination Returns all datasets selected by given field and value combination Parameters `$field` Field to search in `$fieldValue` Value to search for `$auth` Narrow result down to user in auth objext Returns array For each given item
`public`	# `deleteProperties( mixed $itemtype, mixed $itemid )` Delete all properties which match itemtype and itemid Delete all properties which match itemtype and itemid Parameters `$itemtype` Type of the item (example: idcat) `$itemid` ID of the item (example: 31)
`public`	# `deletePropertiesMultiple( mixed $itemtype, array $itemids )` Delete all properties which match itemtype and multiple itemids. Delete all properties which match itemtype and multiple itemids. Parameters `$itemtype` Type of the item (example: idcat) `$itemids` Ids of multiple items (example: array(31,12,22))
`public`	# `changeClient( integer $idclient )` Changes the client Changes the client Parameters `$idclient`
`protected`	# `_loadFromCache( )` Loads/Caches configured properties, but only for current client! NOTE: It loads properties for global set client, not for the client set in this instance! Loads/Caches configured properties, but only for current client! NOTE: It loads properties for global set client, not for the client set in this instance!
`protected boolean`	# `_useCache( string $itemtype = NULL, integer $itemid = NULL )` Parameters `$itemtype` `$itemid` Returns boolean
`protected`	# `_deletePropertiesByIds( array $ids )` Deletes multiple property entries by their ids. Deletes them also from internal cache. Deletes multiple property entries by their ids. Deletes them also from internal cache. Parameters `$ids`
`protected`	# `_addToCache( cApiUserProperty $entry )` Adds a entry to the cache. Adds a entry to the cache. Parameters `$entry`
`protected`	# `_deleteFromCache( integer $id )` Removes a entry from cache. Removes a entry from cache. Parameters `$id`
`protected`	# `_deleteFromCacheMultiple( array $ids )` Removes multiple entries from cache. Removes multiple entries from cache. Parameters `$ids`
`protected mixed`	# `_getValueFromCache( mixed $itemtype, mixed $itemid, mixed $type, mixed $name, mixed $default = false )` Returns the value for a given item from cache. Returns the value for a given item from cache. Parameters `$itemtype` Type of the item (example: idcat) `$itemid` ID of the item (example: 31) `$type` Type of the data to store (arbitary data) `$name` Entry name `$default` to be returned if no item was found Returns mixed Value
`protected array`	# `_getValuesByTypeFromCache( mixed $itemtype, mixed $itemid, mixed $type )` Returns the values for a given item by its type from cache. Returns the values for a given item by its type from cache. Parameters `$itemtype` Type of the item (example: idcat) `$itemid` ID of the item (example: 31) `$type` Type of the data to store (arbitary data) Returns array Value
`public array`	# `_getPropertiesFromCache( mixed $itemtype, mixed $itemid )` Returns poperties for given item are available. Returns poperties for given item are available. Parameters `$itemtype` Type of the item (example: idcat) `$itemid` ID of the item (example: 31) Returns array For each given item

Methods inherited from ItemCollection
_buildGroupWhereStatements(), _buildWhereStatements(), _delete(), _deleteMultiple(), _fetchJoinTables(), _findReverseJoinPartner(), _initializeDriver(), _recursiveStructuredFetch(), _resolveLinks(), _setItemClass(), _setJoinPartner(), addResultField(), copyItem(), count(), createNewItem(), delete(), deleteBy(), deleteByWhereClause(), deleteWhere(), deleteWhereGroup(), exists(), fetchArray(), fetchById(), fetchObject(), fetchTable(), flexSelect(), getAllIds(), getFieldsByWhereClause(), getIdsByWhereClause(), link(), loadItem(), next(), query(), queryAndFetchStructured(), removeResultField(), resetQuery(), select(), setEncoding(), setGroupCondition(), setInnerGroupCondition(), setLimit(), setOrder(), setWhere(), setWhereGroup()

Methods inherited from cItemBaseAbstract
`_getPropertiesCollectionInstance(), _getSecondDBInstance(), _resetItem(), escape()`

Methods inherited from cGenericDb
`_executeCallbacks(), register(), unregister()`

Constants inherited from cGenericDb
`CREATE_BEFORE, CREATE_FAILURE, CREATE_SUCCESS, DELETE_BEFORE, DELETE_FAILURE, DELETE_SUCCESS, STORE_BEFORE, STORE_FAILURE, STORE_SUCCESS`

Properties summary
`public integer`	`$client` Client id Client id	#
`protected static array`	`$_entries` List of cached entries List of cached entries	#
`protected static boolean`	`$_enableCache` Flag to enable caching. Flag to enable caching.	#
`protected static array`	`$_cacheItemtypes` Itemtypes and itemids array Itemtypes and itemids array	#

Properties inherited from ItemCollection
`$_JoinPartners, $_aOperators, $_bAllMode, $_collectionCache, $_driver, $_encoding, $_forwardJoinPartners, $_groupConditions, $_innerGroupConditions, $_itemClass, $_itemClassInstance, $_iteratorItem, $_lastSQL, $_limitCount, $_limitStart, $_links, $_order, $_resultFields, $_where, $_whereRestriction, $objects`

Properties inherited from cItemBaseAbstract
`$_className, $_oCache, $_settings, $db, $lasterror, $primaryKey, $properties, $secondDb, $table, $virgin`

Packages

Classes

Class cApiPropertyCollection

Parameters

Throws

Overrides

Parameters

Returns

Parameters

Returns

Parameters

Returns

Parameters

Returns

Parameters

Parameters

Parameters

Returns

Parameters

Returns

Parameters

Parameters

Parameters

Parameters

Returns

Parameters

Parameters

Parameters

Parameters

Parameters

Returns

Parameters

Returns

Parameters

Returns