eZPublish  3.9
eZCollaborationItemHandler Class Reference

The class eZCollaborationItemHandler does. More...

+ Inheritance diagram for eZCollaborationItemHandler:

Public Member Functions

attribute ($attribute)
 
 attributes ()
 
 classes ()
 
 content (&$collaborationItem)
 
contentAttribute (&$collaborationItem, $attribute)
 
 customInput ($name)
 
 eZCollaborationItemHandler ($typeIdentifier, $typeName, $parameters=array())
 
 handleCustomAction (&$module, &$collaborationItem)
 
 hasAttribute ($attr)
 
 hasContentAttribute (&$collaborationItem, $attribute)
 
 hasCustomInput ($name)
 
 isCustomAction ($name)
 
 messageCount (&$collaborationItem)
 
 notificationCollectionHandling ()
 
 notificationParticipantTemplate ($participantRole)
 
notificationTypes ()
 
 participantRoleString ($participantRole)
 
 participantTypeString ($participantType)
 
 readItem (&$collaborationItem, $viewMode=false)
 
 removeItem (&$collaborationItem)
 
 roleName ($collaborationID, $roleID)
 
 template ($viewMode)
 
 templateName ()
 
 title (&$collaborationItem)
 
 unreadMessageCount (&$collaborationItem)
 
 useMessages (&$collaborationItem)
 

Static Public Member Functions

 activeHandlers ()
 
 defaultRepositories ()
 
 extensionRepositories ()
 
fetchList ()
 
 handleCollaborationEvent (&$event, &$item, &$parameters)
 
 handlerRepositories ()
 
ini ()
 
instantiate ($handler, $repositories=false)
 

Private Attributes

 $Info
 

Detailed Description

Member Function Documentation

eZCollaborationItemHandler::activeHandlers ( )
static
Returns
an array with handler identifiers that are considered active.

Referenced by fetchList().

& eZCollaborationItemHandler::attribute (   $attribute)
Returns
the attribute $attribute if it exists or null.
eZCollaborationItemHandler::attributes ( )

Referenced by hasAttribute().

eZCollaborationItemHandler::classes ( )
Returns
a list of classes this handler supports.
eZCollaborationItemHandler::content ( $collaborationItem)
Returns
the content of the collaborationitem.
Note
This is specific to the item type, some might return an array and others an object.
& eZCollaborationItemHandler::contentAttribute ( $collaborationItem,
  $attribute 
)
Returns
the attribute $attribute if it exists in the content data or null.
eZCollaborationItemHandler::customInput (   $name)
Returns
value of the custom input variable $name.

Referenced by eZApproveCollaborationHandler\handleCustomAction().

eZCollaborationItemHandler::defaultRepositories ( )
static
Returns
an array with directories which acts as default collaboration repositories.
See Also
handlerRepositories

Referenced by handlerRepositories().

eZCollaborationItemHandler::extensionRepositories ( )
static
Returns
an array with directories which acts as collaboration extension repositories.
See Also
handlerRepositories

Referenced by handlerRepositories().

eZCollaborationItemHandler::eZCollaborationItemHandler (   $typeIdentifier,
  $typeName,
  $parameters = array() 
)

Initializes the handler with identifier and name. Optional parameters can be placed in $parameters.

Referenced by eZApproveCollaborationHandler\eZApproveCollaborationHandler().

& eZCollaborationItemHandler::fetchList ( )
static
Returns
a list of collaboration handler objects.
See Also
instantiate, activeHandlers

Referenced by eZCollaborationNotificationHandler\collaborationHandlers().

eZCollaborationItemHandler::handleCollaborationEvent ( $event,
$item,
$parameters 
)
static

Handles a notification event for collaboration items.

Note
The default implementation sends out a generic email.
Transaction unsafe. If you call several transaction unsafe methods you must enclose the calls within a db transaction; thus within db->begin and db->commit.
eZCollaborationItemHandler::handleCustomAction ( $module,
$collaborationItem 
)

This function is called when a custom action is executed for a specific collaboration item. The module object is available in $module and the item in $collaborationItem.

Note
The default does nothing, the function must be reimplemented in real handlers.
See Also
isCustomAction
eZCollaborationItemHandler::handlerRepositories ( )
static
Returns
an array with directories which acts as collaboration repositories.
See Also
defaultRepositories, extensionRepositories

Referenced by fetchList(), and instantiate().

eZCollaborationItemHandler::hasAttribute (   $attr)
Returns
true if the attribute $attribute exists.
eZCollaborationItemHandler::hasContentAttribute ( $collaborationItem,
  $attribute 
)
Returns
true if the attribute $attribute exists in the content data.
eZCollaborationItemHandler::hasCustomInput (   $name)
Returns
true if the custom input variable $name exists.
& eZCollaborationItemHandler::ini ( )
static
Returns
the ini object which handles collaboration settings.

Referenced by activeHandlers(), defaultRepositories(), and extensionRepositories().

& eZCollaborationItemHandler::instantiate (   $handler,
  $repositories = false 
)
static
Returns
a unique instance of the handler for the identifier $handler. If $repositories is left out it will use the handlerRepositories.

Referenced by fetchList(), and eZCollaborationItem\handler().

eZCollaborationItemHandler::isCustomAction (   $name)
Returns
true if the current custom action is $name.

Referenced by eZApproveCollaborationHandler\handleCustomAction().

eZCollaborationItemHandler::messageCount ( $collaborationItem)
Returns
the number of messages for the collaboration item $collaborationItem.
Note
The default implementation returns 0, if you want real counts the handler must reimplement this function.
eZCollaborationItemHandler::notificationCollectionHandling ( )
Returns
how the handler wants collections to be made.
Note
The default is to create one collection for all participants.
eZCollaborationItemHandler::notificationParticipantTemplate (   $participantRole)
& eZCollaborationItemHandler::notificationTypes ( )
Returns
what kind of notification types this handler supports. Can either return an array or a boolean. If it returns true the handler supports notification but does not have subnotifications. If it returns false the handler does not support notificiation. If it returns an array the array contains a list associative arrays each containing a name and value entry.

Referenced by attribute().

eZCollaborationItemHandler::participantRoleString (   $participantRole)
Returns
a textual representation of the participant role id $participantRole
Note
It's up to the real handlers to implement this if they use custom participation roles.
eZCollaborationItemHandler::participantTypeString (   $participantType)
Returns
a textual representation of the participant type id $participantType
Note
It's up to the real handlers to implement this if they use custom participation types.
eZCollaborationItemHandler::readItem ( $collaborationItem,
  $viewMode = false 
)

This is called whenever the item is considered to be read, it can be used by handlers to update when the item was last read.

Note
Default implementation does nothing.
eZCollaborationItemHandler::removeItem ( $collaborationItem)

This is called whenever a collaboration item is to be removed. Reimplementing this function can be used to cleanup external tables or other resources.

eZCollaborationItemHandler::roleName (   $collaborationID,
  $roleID 
)
Returns
a description of the role id $roleID in the current language.
Note
It's up to the real handlers to implement this if they use custom participation roles.
eZCollaborationItemHandler::template (   $viewMode)
Returns
the template name for the viewmode $viewmode.
eZCollaborationItemHandler::templateName ( )
Returns
the name of the template file for this handler. Default is to append .tpl to the identifier.

Referenced by template().

eZCollaborationItemHandler::title ( $collaborationItem)
Returns
the title of the collaboration item.
eZCollaborationItemHandler::unreadMessageCount ( $collaborationItem)
Returns
the number of unread messages for the collaboration item $collaborationItem.
Note
The default implementation returns 0, if you want real counts the handler must reimplement this function.
eZCollaborationItemHandler::useMessages ( $collaborationItem)
Returns
true if the collaboration item $collaborationItem supports messages.
Note
The handler can either determine this by passing $useMessages to the constructor or by reimplementing this function to do it per item.

Member Data Documentation

eZCollaborationItemHandler::$Info
private

Referenced by attribute().


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