Introduction

This project defines a custom site dashlet which embeds a map display, with geotagged content marked on the map. Currently Google Maps is used to render the map, based on the method used by the map dashlet distributed with the Calais Integration forge project.

Installation

The dashlet is packaged as a single JAR file for easy installation into Alfresco Share.

To install the dashlet, simply drop the site-geotagged-content-dashlet.jar file into the tomcat/shared/lib folder within your Alfresco installation, and restart the application server. You might need to create this folder if it does not already exist.

Building from Source

Check out the project if you have not already done so

svn checkout http://share-extras.googlecode.com/svn/trunk/Site%20Geotagged%20Content%20Dashlet

Change into the new directory

cd "Site Geotagged Content Dashlet"

An Ant build script is provided to build a JAR file containing the custom files, which can then be installed into the tomcat/shared/lib folder of your Alfresco installation.

To build the JAR file, run the following command from the base project directory.

ant clean dist-jar

The command should build a JAR file named site-geotagged-content-dashlet.jar in the dist directory within your project, which you can then copy into the tomcat/shared/lib folder of your Alfresco installation.

Alternatively, you can use the build script to hot deploy the JAR file directly into a local Tomcat instance for testing. You will need to use the hotcopy-tomcat-jar task and set the tomcat.home property in Ant.

ant -Dtomcat.home=C:/Alfresco/tomcat clean dist-jar hotcopy-tomcat-jar

After you have deployed the JAR file you will need to restart Tomcat to ensure it picks up the changes.

Usage

1. Log in to Alfresco Share and navigate to a site where you are a Site Manager
2. On the site dashboard and click the Customize Dashboard button to edit the contents of the dashboard. Drag the dashlet into one of the columns from the list of dashlets to add it.
3. Click OK to save the configuration.
4. The map view should now be visible in your dashboard.

Known Issues

• A maximum of 100 items is displayed on the map for performance reasons. However you can zoom in using the map controls to get more detail on a specific area.
• The map centre and zoom level are persisted to your user preferences but currently this is a global setting, rather than site-specific.