The Object State Handler interface provides managing of object states and groups.
Methods
Creates a new object state in the given group.
The new state gets the last priority.
Note: in current kernel: If it is the first state all content objects will
set to this state.
Parameters
Name |
Type |
Default value |
Description |
$groupId
|
mixed
|
-
|
-
|
$input
|
InputStruct
|
-
|
-
|
Return values
ObjectState
Creates a new object state group.
Parameters
Name |
Type |
Default value |
Description |
$input
|
InputStruct
|
-
|
-
|
Return values
Group
Deletes a object state. The state of the content objects is reset to the
first object state in the group.
|
public delete(mixed $stateId) : mixed
|
Parameters
Name |
Type |
Default value |
Description |
$stateId
|
mixed
|
-
|
-
|
Deletes a object state group including all states and links to content.
|
public deleteGroup(mixed $groupId) : mixed
|
Parameters
Name |
Type |
Default value |
Description |
$groupId
|
mixed
|
-
|
-
|
Returns the number of objects which are in this state.
|
public getContentCount(mixed $stateId) : int
|
Parameters
Name |
Type |
Default value |
Description |
$stateId
|
mixed
|
-
|
-
|
Return values
int
Gets the object-state of object identified by $contentId.
|
public getContentState(mixed $contentId, mixed $stateGroupId) : ObjectState
|
The $state is the id of the state within one group.
Parameters
Name |
Type |
Default value |
Description |
$contentId
|
mixed
|
-
|
-
|
$stateGroupId
|
mixed
|
-
|
-
|
Return values
ObjectState
Loads an object state.
Parameters
Name |
Type |
Default value |
Description |
$stateId
|
mixed
|
-
|
-
|
Return values
ObjectState
Tags
-
Throws
-
NotFoundException
if the state was not found
Loads all object state groups.
|
public loadAllGroups([int $offset = 0 ][, int $limit = -1 ]) : array<string|int, Group>
|
Parameters
Name |
Type |
Default value |
Description |
$offset
|
int
|
0
|
-
|
$limit
|
int
|
-1
|
-
|
Return values
array<string|int, Group>
Loads an object state by identifier and group it belongs to.
|
public loadByIdentifier(string $identifier, mixed $groupId) : ObjectState
|
Parameters
Name |
Type |
Default value |
Description |
$identifier
|
string
|
-
|
-
|
$groupId
|
mixed
|
-
|
-
|
Return values
ObjectState
Tags
-
Throws
-
NotFoundException
if the state was not found
Loads a object state group.
|
public loadGroup(mixed $groupId) : Group
|
Parameters
Name |
Type |
Default value |
Description |
$groupId
|
mixed
|
-
|
-
|
Return values
Group
Tags
-
Throws
-
NotFoundException
if the group was not found
Loads a object state group by identifier.
|
public loadGroupByIdentifier(string $identifier) : Group
|
Parameters
Name |
Type |
Default value |
Description |
$identifier
|
string
|
-
|
-
|
Return values
Group
Tags
-
Throws
-
NotFoundException
if the group was not found
This method returns the ordered list of object states of a group.
|
public loadObjectStates(mixed $groupId) : array<string|int, ObjectState>
|
Parameters
Name |
Type |
Default value |
Description |
$groupId
|
mixed
|
-
|
-
|
Return values
array<string|int, ObjectState>
Sets the object-state of a state group to $stateId for the given content.
|
public setContentState(mixed $contentId, mixed $groupId, mixed $stateId) : bool
|
Parameters
Name |
Type |
Default value |
Description |
$contentId
|
mixed
|
-
|
-
|
$groupId
|
mixed
|
-
|
-
|
$stateId
|
mixed
|
-
|
-
|
Return values
bool
Changes the priority of the state.
|
public setPriority(mixed $stateId, int $priority) : mixed
|
Parameters
Name |
Type |
Default value |
Description |
$stateId
|
mixed
|
-
|
-
|
$priority
|
int
|
-
|
-
|
Updates an object state.
Parameters
Name |
Type |
Default value |
Description |
$stateId
|
mixed
|
-
|
-
|
$input
|
InputStruct
|
-
|
-
|
Return values
ObjectState
Updates an object state group.
Parameters
Name |
Type |
Default value |
Description |
$groupId
|
mixed
|
-
|
-
|
$input
|
InputStruct
|
-
|
-
|
Return values
Group