Download

XooSent is available as an easy to install zip.

Current version of XooSent is 0.1.1.

Install

Installing XooSent is really straightforward:

Download
Unzip
Launch xoosent.bat or xoosent.sh depending on your os

Note that you need java 6 in your path, and you need to run these scripts from their location (usually the default if you double click).

Open your browser to http://localhost:8080/
To stop XooSent, you can simply kill the process launched in the shell script

Customize

Data

Note: default data is loaded the first time you start XooSent. So if you have already started XooSent, you will need to drop your database, modify the files, and then launch again. To do so if you use the default embedded derby database, you only have to delete the db directory in your xoosent installation directory.

To customize data used for first initialisation of XooSent you simply have to edit the xml files located in webapp/WEB-INF/classes/data. The format used is self documenting. For instance:

  <status>
    <name>New</name>
    <color>#F2F2CC</color>
  </status>

For data using images urls, the given images should be located in:

webapp/WEB-INF/classes/org/xoocode/xoosent/web/images

Web UI

The html and css files used by XooSent are located in:

webapp/WEB-INF/classes/org/xoocode/xoosent/web

Feel free to naviagate in this lcoation and see what you can do here.

A very often customized html file is the welcome panel located in the welcome sub directory.

Database

To use a different database than embedded derby, you only have to modify two files:

webapp/WEB-INF/classes/hibernate.properties

Where you can set the appropriate jdbc url and hibernate dialect (see hibernate documentation for detail).

lib/org.xoocode.xoosent-xoosent-0.1.1.xml

This is the Ivy file descriptor used to load xoosent, where you can a dependency on the jdbc driver you need (search the module name on mvnrepository.com, and check Ivy's documentation for details about Ivy files). Then at your first launch Ivy will download the driver jar, and make it available to xoosent!

Example:
Searching mvnrepository for mysql leads to this page:
http://www.mvnrepository.com/artifact/mysql/mysql-connector-java

From which you can deduce the following dependency:

<dependency org="mysql" name="mysql-connector-java" rev="5.0.5" />

Home

XooSent