The collector to read the xml content resources. Collectors are defined in java classes which are configured in the opencms-vfs.xml configuration file. OpenCms contains already a class CmsDefaultResourceCollector which is an aggregation of the following collectors:

singleFile 

Gets a single xml content resource. The name of the resource is given in the param attribute.

allInFolder

Gets a list of all xml content resources of a folder. The folder name is given in the param attribute.

allInFolderDateReleasedDesc 

Gets a list of all xml content resources of a folder, sorted by the release date. The folder name is given in the param attribute.

allInFolderNavPos 

Gets a list of all xml content resources of a folder, sorted by the "NavPos" property value. The folder name is given in the param attribute.

allInSubTree

Gets a list of all xml content resources of a sub tree. The tree root is given in the param attribute.

allInSubTreeDateReleasedDesc 

Gets a list of all xml content resources of a sub tree, sorted by the release date. The tree root is given in the param attribute.

allInSubTreeNavPos 

Gets a list of all xml content resources of a sub tree, sorted by the "NavPos" property value. The tree root is given in the param attribute. 

Other collectors are available in the class CmsPriorityResourceCollector which sorts resources by the values of the properties "collector.priority" and "collector.date". The following collectors can be used from this class:

allInFolderPriorityDateDesc / allInFolderPriorityDateAsc

Gets a list of all xml content resources of a folder, sorted by the "collector.priority" property in descending / ascending order. If resources have the same priority, the "collector.date" property is used as second sorting criteria. The folder name is given in the param attribute.

allInFolderPriorityTitleDesc

Gets a list of all xml content resources of a folder, sorted by the "collector.priority" property. If resources have the same priority, the "Title" property is used as second sorting criteria. The folder name is given in the param attribute.

allInSubTreePriorityDateDesc / allInSubTreePriorityDateAsc

Gets a list of all xml content resources of a sub tree, sorted by the "collector.priority" property in descending / ascending order. If resources have the same priority, the "collector.date" property is used as second sorting criteria. The tree root is given in the param attribute.

allInSubTreePriorityTitleDesc

Gets a list of all xml content resources of a sub tree, sorted by the "collector.priority" property. If resources have the same priority, the "Title" property is used as second sorting criteria. The tree root is given in the param attribute.

allMappedToUriPriorityDateAsc / allMappedToUriPriorityDateDesc

Gets a list of all resource from specified folder that have been mapped to the currently requested uri, sorted by priority, then date in descending / ascending order. A Resource is mapped to a uri by setting it's property "collector.channel" to a path without site root (e.g.: "/de/news". Then this resource will be shown on e.g. "/de/news/list.jsp" even it is located somewhere else).

Instead of specifying the collector name hardwired in the collector attribute, the name of the collector can also be specified in a macro expression telling the attribute to read the collector name from a property "collector" on the JSP page, e.g.:

%(property.collector)

The param attribute is used to give additional information to the collector.

When using one of the collectors in CmsDefaultResourceCollector, the param attribute provides additional information about the resource name of xml content resources to be read by the collectors. The format of this parameter is: "[filename]|[resource type]|[count]"

[filename] 

The name of the resource to load, it can include a makro value "%(number)", which replaced with the number of the the next xml content resource while looping through the single elements.

[resource type]

One of the resource types of xml contents defined in the opencms-vfs.xml configuration file.

[count]

Will use the current uri in the OpenCms VFS as resource name. Its typical to use this with the singleFile collector a detail view jsp.

 

Again you are free to use macro expressions in the param attribute to set the value of the collector's param, e.g.:

%(property.xml-content)

Will be replaced by the value of the property "xml-content"

%(opencms.uri) 

Will be replaced by the current OpenCms VFS URI. Its typical to use this with the singleFile collector a detail view jsp.

%(opencms.filename)

Will be replaced by the resource name of the current xml content resource while looping through the single resources.

${param.resourceType} 

Will be replaced by the value of the Http reuest parameter "resourceType.

This attribute defines if the xml content supports the direct edit feature.

The following values are supported:

true

The xml content can be edited from the frontend directly.

false (default)

The xml content cannot be edited from the frontend directly. This is the default if the attribute is not set.

This attribute defines if the collector will proload itts content. This is required to check if the collector has returned any results at all, which can be done in combination with the

The following values are supported:

true

          Activates the preload