Frontend Developer Manual / Version 2401
Table Of Contents
The Elastic Social FreeMarker API provides utility functions to enrich components with personal data. It uses the
namespace lc
for template calls. For more information see
Section 6.3, “Elastic Social” in
Blueprint Developer Manual
.
es.complaining
Adds user specific data to components and function calls about users which there are complaints. It uses the namespace es for template calls.
Parameter | Required | Description |
---|---|---|
value
| Returns the complain value if true. | |
id
| The HTML id prefix for this component. | |
collection
| The name of collection. | |
itemId
| The name of itemId. | |
navigationId
| The name of navigationId. | |
customClass
| The name of customClass. Defaults to empty. |
Table 6.57. Parameters of complaining
<@es.complaining id=userDetails.id collection="users" value=es.hasComplaintForCurrentUser(userDetails.id, "users") itemId=itemId navigationId=navigationId/>
Example 6.46. Enrich user specific data to component
es.getElasticSocialConfiguration(page)
Gets the Elastic Social configuration of a page. In general this is the root page of a site. Please check the
CMS Javadoc for all available properties of ElasticSocialConfiguration
.
Parameter | Required | Description |
---|---|---|
page
| The page to get the configuration for. |
Table 6.58. Parameter of getElasticSocialConfiguration
<#assign elasticSocialConfiguration=es.getElasticSocialConfiguration(cmpage)/> <#if elasticSocialConfiguration.isFeedbackEnabled()!false> ... </#if>
Example 6.47. Checks if Elastic Social is enabled
es.getLogin()
Checks page setting for Elastic Social Webflow login form.
<@cm.include self=es.getLogin()!cm.UNDEFINED view="asButtonGroup"/>
es.isAnonymousUser()
Checks if the current user of the web page is a logged-in user or it is an anonymous user. Returns to true if the current user is not logged in.
<#if es.isAnonymousUser()>...</#if>
es.isAnonymous(communityUser)
Checks if the user choose not to publish its user name, profile image, and other personal information with its contributions. Returns to true if the user wants to remain anonymous.
Parameter | Required | Description |
---|---|---|
communityUser
| The user to be checked. |
Table 6.59. Parameter of isAnonymous
<#if es.isAnonymous(self.author)>...</#if>
es.getCurrentTenant()
Returns the tenant of the current Thread. Throws Tenant Exception when no tenant has been set.
<#assign tenant=es.getCurrentTenant()/> <#assign myUrl=cm.getLink('/signin/example_' + tenant)/> <form action="${myUrl!""}" method="post"> ... </form>
Example 6.48. Sets the form action
es.hasUserWrittenReview(target)
Returns the written review of the user for a given bean.
es.getReviewView(review)
Returns the preview or live rendering depending on the state of the current user.
Parameter | Required | Description |
---|---|---|
review
| Attributing a target with text, title and rating from an author. |
Table 6.61. Parameter of getReviewView
<#assign reviewView=es.getReviewView(self)/> <#if ["default", "undecided", "rejected"]?seq_contains(reviewView)> ... </#if>
Example 6.49. Specified value rendering
es.hasUserRated(target)
Returns the rating score for the given community user and for a given bean.
es.getCommentView(comment)
Returns the preview or live rendering depending on the state of the current user.
Parameter | Required | Description |
---|---|---|
comment
| Attributing a target with text from an author. |
Table 6.63. Parameter of getCommentView
<#assign commentView=es.getCommentView(self)/> <#if ["default", "undecided", "rejected"]?seq_contains(commentView)> ... </#if>
Example 6.50. Specified value rendering
es.getMaxRating()
Returns 5.
es.getReviewMaxRating()
Returns 5.