Category Archives: Dashlets

How To Install Alfresco Dashlets

Screen Shot 2013-02-05 at 2.20.30 PM

Summary

Alfresco Share Dashlets are mini applications (some may be tempted to say Applets but that is more of a Java term 😉 ) that are able to be added on the fly to add some very minor functionality to your Alfresco server. You can get Share dashlets here. In case you weren’t aware, you can pick up many new dashlets created by the community and even peek inside some sample ones to get an idea how to create your own.

Make sure you have a look at the individual page for each dashlet you’re interested. The dashlet’s page may tell you how to build them (usually with ant), deploy them, which Alfresco version is required, etc.

How To Deploy Dashlets to Alfresco

Which jar file to use for them may depend on the build method used.

Create a tomcat/shared/lib directory if you haven’t already:

# cd <alf_install>/tomcat
# mkdir -p shared/lib

Add the shared/lib/*.jar to shared.loader in tomcat/conf/catalina.properties:

shared.loader=${catalina.base}/shared/classes,${catalina.base}/shared/lib/*.jar

Afterwards, copy the dashlet jars into tomcat/shared/classes and restart Alfresco.

Open your Share page and go to Customize Dashboard.

Screen Shot 2013-02-05 at 10.07.15 AM

When you click on Add Dashlets you should now see your dashlet added to the list. In my case this is the BBC Weather dashlet.

Screen Shot 2013-02-05 at 10.08.03 AM

Drag this one to your list and click Ok. I dragged mine from Add Dashlets to Column 1 in this case. This will bring you to your dashboard and the dashlet should be now showing. To configure this particular one to show the weather for a particular city, click on the pencil icon in the upper right corner of the dashboard (look on yours, in the screenshot below the pencil icon isn’t shown).

Screen Shot 2013-02-05 at 10.10.23 AM

Change the city to yours and click Ok.

Screen Shot 2013-02-05 at 10.10.47 AM

Voila! The BBC Weather Dashlet should be showing on your dashboard.

This method should work for most dashlets but keep in mind, some of them may take some additional steps to configure.

Happy Dashletting!

Cheers! -H.S.