Hey Mark,
a) For a widget in the home page of a socail group, how would I find the group name from within my widget's freemarker file?
Is
this available from the context already or would my java class have to
provide that information? If the latter, where do I get that
information in my widget's Java code?
The easiest way to do this (instead of messing around with freemarker statics and such) is to simply get it from your java code. In your widget, you will want to create a getter method for the social group:
public SocialGroup getCurrentSocialGroup() {
return currentSocialGroup; (this would be a global variable in your widget)
}
Then in your loadProperties method you will set the social group appropriately:
if (widgetContext.getWidgetType() == WidgetType.SOCIALGROUP) {
SocialGroupWidgetContext socialGroupWidgetContext = (SocialGroupWidgetContext) widgetContext;
currentSocialGroup = socialGroupWidgetContext.getSocialGroup();
}
properties.put("currentSocialGroup", currentSocialGroup);
Then in your FTL you can reference the social group object like this:
${socialGroup.name}
In FTL's that are mapped to java actions, any get methods automatically strip this when you use the variable. Otherwise the variable would be like this:
${getSocialGroup().getName()} // The first is much easier to read and is what you should use
b)
how, in general, do answer questions like this? I am guessing there is
some place in the source where I can look for this information. Is
there a document that describes this process? The notes on Freemarker I
have seen are not specific to clearspace and most of the clearspace
documentation is for template theme customisation, im not clear how
much of this is the same in the cae of widget templates.
Check out our developer community, we have tons of documentation around customizations:
Thanks.
-Todd
