# jACMS Aps Core Tag Library

  • Version: 2.3

  • Short Name: jacmsaps

  • URI: /jacms-aps-core

# Tag content

# Tag Class com.agiletec.plugins.jacms.aps.tags.ContentTag

# Description

Displays the content given its ID.

# Attributes

Attribute Required Description

contentId

false

ID of the content to display. It can accept "expression language".

modelId

false

Id of the model to use to display the content. The model ID can be either specified explicitly (the model must match the content to serve) or the type name ("list" or "default"); in the latter case the model specified in the configuration will be used. The model must adhere to the content being returned. "Expression language" is accepted.

publishExtraTitle

false

Toggles the insertion of the values of the titles in the Request Context. The title values are extracted from the attribute marked with the role "jacms:title". Admitted values are (true, false), default 'false'.

var

false

Inserts the rendered content in a variable of the page context with the name provided.

attributeValuesByRoleVar

false

Inserts the map of the attribute values indexed by the attribute role, in a variable of the page context with the name provided.

# Tag contentInfo

# Tag Class com.agiletec.plugins.jacms.aps.tags.ContentInfoTag

# Description

Return information of a specified content. The content can will be extracted by id from widget parameters or from request parameter. The tag extract any specific parameter (by "param" attribute) or entire ContentAuthorizationInfo object (setting "var" attribute and anything on "param" attribute).

# Attributes

Attribute Required Description

contentId

false

ID of the content

param

false

Admitted values for "param" attribute are: 'contentId' (returns the code of content id), 'mainGroup' (returns the code of owner group), 'authToEdit' (returns true if the current user can edit the content, else false).

var

false

Inserts the required parameter (or the entire authorization info object) in a variable of the page context with the name provided.

# Tag contentList

# Tag Class com.agiletec.plugins.jacms.aps.tags.ContentListTag

# Description

Loads a list of contents IDs by applying the filters (if any). Only the IDs of the contents accessible in the portal can be loaded.

# Attributes

Attribute Required Description

listName

true

Name of the variable in the page context that holds the search result.

contentType

false

Sets the code of the content types to search. The name must match the configured one, respecting capital letters and spaces.

category

false

Identifier string of the category of the content to search.

cacheable

false

Toggles the system caching usage when retrieving the list. Admitted values (true, false), default "true".

titleVar

false

Inserts the title on a variable of the page context with the name provided.

pageLinkVar

false

Inserts the code of the page to link on a variable of the page context with the name provided.

pageLinkDescriptionVar

false

Inserts the description of the page to link on a variable of the page context with the name provided.

userFilterOptionsVar

false

Name of the variable in the page context that holds the user filter options

# Tag contentListFilter

# Tag Class Tag class: com.agiletec.plugins.jacms.aps.tags.ContentListFilterTag

# Description

"ContentListTag" sub-tag, it creates a filter to restrict the result of the content search. Please note that the filters will be applied in the same order they are declared and the result of the search will reflect this fact.

# Attributes

Attribute Required Description

key

true

String used to filter and sort the contents. This string can be: - the name of a content attribute compatible with the type declared in the "contentListTag" (it requires the "attributeFilter" attribute to be "true") - the ID of one of the content metadata (the "attributeFilter" must be false) The allowed filter key that can be applied to content metadata are: - "created" allows sorting by date of creation of content - "modified" allows sorting by date of modification of content.

attributeFilter

true

Decides whether the filter must be applied to an attribute or to a content metadata, admitted values are (true, false). The "key" attribute will be checked for validity if the filter is going to be applied to a metadata

value

false

The filtering value.

start

false

Filters the contents by attribute type or by the field specified with the key (respect the following matches): Text field -→ start Text Text attribute type -→ start Text Numeric attribute type -→ start Numeric date attribute type -→ start data If the data filter is used: - today, oggi or odierna will select all the contents with a date greater or equal to the system date - using date with the pattern "dd/MM/yyyy" will select all the contents with a date greater or equal to the one inserted.

end

false

Similar the the "start" attribute but with the opposite behavior.

order

false

Specifies the sorting behavior of the IDs found: "ASC"ending or "DESC"ending. By default no ordering is performed.

likeOption

false

Toggles the 'like' functionality. Admitted values: (true, false). Default: false. The option is available for metadata and on Text Content attributes.

# Tag contentListUserFilterOption

# Tag Class Tag class: com.agiletec.plugins.jacms.aps.tags.ContentListUserFilterOptionTag=

# Description

"ContentListTag" sub-tag, it creates a custom user filter to restrict the result of the content search by front-end user.

# Attributes

Attribute Required Description

key

true

The key of the filter. This string can be: - the name of a content attribute compatible with the type declared in the "contentListTag" (it requires the "attributeFilter" attribute to be "true") - the ID of one of the content metadata (the "attributeFilter" must be false) The allowed filter key that can be applied to content metadata are: - "fulltext" allows filter by full-text search<br /> - "category" allows filter by a system category.

attributeFilter

true

Decides whether the filter must be applied to an attribute or to a content metadata, admitted values are (true, false). The "key" attribute will be checked for validity if the filter is going to be applied to a metadata.

# Tag searcher

# Tag Class com.agiletec.plugins.jacms.aps.tags.SearcherTag

# Description

Generates a list of content IDs, restricting them to the key word contained in the "search" parameter of the http request.

# Attributes

Attribute Required Description

listName

yes

Name of the variable, stored in the page context, containing the list of content IDs.

# Tag rowContentList

# Tag Class Tag class: com.agiletec.plugins.jacms.aps.tags.RowContentListTag

# Description

Publish a list of contents.

# Attributes

Attribute Required Description

listName

true

Name of the variable in the page context that holds the contents (list of properties of key "contentId" and "modelId").

titleVar

false

Inserts the title on a variable of the page context with the name provided.

pageLinkVar

false

Inserts the code of the page to link on a variable of the page context with the name provided.

pageLinkDescriptionVar

false

Inserts the description of the page to link on a variable of the page context with the name provided.