org.broadleafcommerce.cms.web.processor

Class ContentProcessor

java.lang.Object

org.broadleafcommerce.cms.web.processor.ContentProcessor

All Implemented Interfaces:

ContentExpression

@Component(value="blContentProcessor")
 @ConditionalOnTemplating
public class ContentProcessor
extends Object
implements ContentExpression

Processor used to display structured content that is maintained with the Broadleaf CMS. Usage based on the following attributes:

• contentType (required *) - only required if an extension manager is not defined to handle content lookup. If the content type is not found, it will try to retrieve content from any registered extension handlers. Specifies the content you are retrieving.
• contentName - if included will retrieve only content that matches the name. When no name is specified, all matching content items of the passed in type are retrieved.
• maxResults - if specified limits the results to a specified number of items. The content will be returned according to priority. If content items share the same priority, then they will be returned randomly. Consider the example with 5 matching items with priorities (1,2,3,3,3) respectively. If the count is set to 3. Items 1 and 2 will ALWAYS be returned. The third item returned will randomy rotate through the 3rd, 4th, and 5th item.
• contentListVar - allows you to specify an alternate name for the list of content results. By default, the results are returned in the page attributed "contentList"
• contentItemVar - since a typical usage is to only return one item, the first item is returned in the variable "contentItem". This variable can be used to change the attribute name.
• numResultsVar - variable holding the returns the number of results being returned to through the tag-lib. defaults to "numResults".
• fieldFilters - Thymeleaf key-value pair to filter the resulting StructuredContentDTO by particular field values. For instance, if you had a field in a piece of structured content called 'featured' and you wanted to return all of the featured content items, you could do the following:
• sorts - sorts to apply to the resulting list of content. These should be key-value pairs corresponding where the key is the field to sort and the value is the direction of the sort. If unspecified, the default sorting is used (by priority). The sort fields must occur in the dynamic fields for that piece of structured content. For instance: The list will be sorted first by dynamicFieldA descending and then dynamicFieldB ascending

Field Summary

Fields

Modifier and Type	Field and Description
protected ContentDeepLinkServiceImpl	contentDeepLinkService
protected ContentProcessorExtensionManager	extensionManager
protected org.apache.commons.logging.Log	LOG
protected StaticAssetService	staticAssetService
protected StructuredContentService	structuredContentService

Fields inherited from interface org.broadleafcommerce.cms.web.processor.ContentExpression

BLC_RULE_MAP_PARAM, REQUEST_DTO

Constructor Summary

Constructors

Constructor and Description
ContentProcessor()

Method Summary

Modifier and Type	Method and Description
protected Map<String,Object>	buildMvelParameters(javax.servlet.http.HttpServletRequest request, Map<String,String> tagAttributes, org.broadleafcommerce.presentation.model.BroadleafTemplateContext context) MVEL is used to process the content targeting rules.
protected String	getAttributeValue(Map<String,String> tagAttributes, String valueName, String defaultValue) Returns a default name
protected List<org.broadleafcommerce.common.structure.dto.StructuredContentDTO>	getContentItems(String contentName, Integer maxResults, javax.servlet.http.HttpServletRequest request, Map<String,Object> mvelParameters, org.broadleafcommerce.common.sandbox.domain.SandBox currentSandbox, StructuredContentType structuredContentType, org.broadleafcommerce.common.locale.domain.Locale locale, String tagName, Map<String,String> tagAttributes, Map<String,Object> newModelVars, org.broadleafcommerce.presentation.model.BroadleafTemplateContext context)
String	getName()
int	getPrecedence()
boolean	isSecure(javax.servlet.http.HttpServletRequest request)
Map<String,Object>	populateModelVariables(String tagName, Map<String,String> tagAttributes, org.broadleafcommerce.presentation.model.BroadleafTemplateContext context)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

LOG

protected final org.apache.commons.logging.Log LOG

structuredContentService

protected StructuredContentService structuredContentService

staticAssetService

protected StaticAssetService staticAssetService

extensionManager

protected ContentProcessorExtensionManager extensionManager

contentDeepLinkService

protected ContentDeepLinkServiceImpl contentDeepLinkService

Constructor Detail

ContentProcessor

public ContentProcessor()

Method Detail

getName

public String getName()

Specified by:

getName in interface ContentExpression

getPrecedence

public int getPrecedence()

Specified by:

getPrecedence in interface ContentExpression

getAttributeValue

protected String getAttributeValue(Map<String,String> tagAttributes,
                                   String valueName,
                                   String defaultValue)

Returns a default name

Parameters:

element -

valueName -

Returns:

populateModelVariables

public Map<String,Object> populateModelVariables(String tagName,
                                                 Map<String,String> tagAttributes,
                                                 org.broadleafcommerce.presentation.model.BroadleafTemplateContext context)

Specified by:

populateModelVariables in interface ContentExpression

getContentItems

protected List<org.broadleafcommerce.common.structure.dto.StructuredContentDTO> getContentItems(String contentName,
                                                                                                Integer maxResults,
                                                                                                javax.servlet.http.HttpServletRequest request,
                                                                                                Map<String,Object> mvelParameters,
                                                                                                org.broadleafcommerce.common.sandbox.domain.SandBox currentSandbox,
                                                                                                StructuredContentType structuredContentType,
                                                                                                org.broadleafcommerce.common.locale.domain.Locale locale,
                                                                                                String tagName,
                                                                                                Map<String,String> tagAttributes,
                                                                                                Map<String,Object> newModelVars,
                                                                                                org.broadleafcommerce.presentation.model.BroadleafTemplateContext context)

Parameters:

contentName - name of the content to be looked up (can be null)

maxResults - maximum results to return

request - servlet request

mvelParameters - values that should be considered when filtering the content list by rules

structuredContentType - the type of content that should be returned

locale - current locale

arguments - Thymeleaf Arguments passed into the tag

element - element context that this Thymeleaf processor is being executed in

Returns:

buildMvelParameters

protected Map<String,Object> buildMvelParameters(javax.servlet.http.HttpServletRequest request,
                                                 Map<String,String> tagAttributes,
                                                 org.broadleafcommerce.presentation.model.BroadleafTemplateContext context)

MVEL is used to process the content targeting rules.

Parameters:

request -

Returns:

isSecure

public boolean isSecure(javax.servlet.http.HttpServletRequest request)

Specified by:

isSecure in interface ContentExpression