Home > vivo_portlet

vivo_portlet

Vivo_portlet is a project mainly written in JAVA and SHELL, based on the MIT license.

A JSR-286 portlet that uses the search service provided by VIVO Widgets to provide the ability to search VIVO content.

Vivo Portlet

A JSR-286 portlet that integrates with a VIVO server for searching of semantic web data.

Note: even though it is a JSR-286 portlet and we've made efforts to help it work in other portals, it has only been tested in Liferay 6.0.6. We do not use a Liferay-specific build (it uses Maven without all of the liferay repositories, etc.), but the go.sh script is for Liferay 6.0.6 only. If you are using another portal, just deploy the war.

Demonstration

See the screenshot or the video.

Download

Releases - please right-click to download

2011-08-08 - current - working with hardcoded service url. Tested w/Liferay 6.0.6 in Firefox 5.0.1 and Chrome 13.0 in OS X 10.6.
2011-06-03 - search not working
2011-05-26 - working search but no persistence

Setting Up Liferay

You don't have to use Liferay to use the portlet, but the portlet was developed and tested with Liferay.

Download Liferay 6.0.6.
If you want to be consistent with other instructions for building, create the path /usr/java/ and unzip Liferay into that directory, so that Liferay's home directory is /usr/java/liferay-portal-6.0.6.
Start Liferay according to its instructions.

e.g. Here are the commands to use in OS X 10.6:

  mkdir -p /usr/java
  cd /usr/java
  wget http://downloads.sourceforge.net/project/lportal/Liferay%20Portal/6.0.6/liferay-portal-tomcat-6.0.6-20110225.zip?r=&ts=1312902524&use_mirror=cdnetworks-us-2
  unzip liferay-portal-tomcat-6.0.6-20110225.zip
  cd liferay-portal-6.0.6/tomcat-6.0.29/bin
  ./startup.sh

Deploy

Copy the vivo.war you downloaded from the releases section into /usr/java/liferay-portal-6.0.6/deploy.

  cp ~/Downloads/vivo.war /usr/java/liferay-portal-6.0.6/deploy/

Adding the Portlet

In Liferay 6.0.6, login and go to Add->More...->Social->Vivo->Add. If you are not logged-in, history is not stored, but search still works.

Configuration

If you have installed VIVO and VIVO Widgets, then you can have the portlet point at your own VIVO instance.

Modify the portlet's WEB-INF/classes/vivo.properties to set the vivoUrl like:

  vivoUrl=http://vivo.example.com/widgets/search.jsonp?query=

Modify the portlet's META-INF/persistence.xml to use your favorite database. It uses H2 as an in-memory-only database by default, so unless you change that, data will not be saved on restart of the portal.

Restart Liferay after making these changes.

Development

Install Maven and follow the instructions on the Maven site for setting it up. Java 6 (or possibly higher) is required.

Running the following command should do a clean build of the portlet. The resulting portlet should be in target/vivo.war:

  mvn clean install

If you want to ensure a fresh build and deploy to a completely clean Liferay HSQL database, if you are using OS X 10.6 (or possibly higher) then you can use go.sh if you dare, but please understand that go.sh will DELETE /usr/java/liferay-portal-6.0.6. go.sh uses Maven to build, stops Liferay, deletes Liferay, unzips Liferay, copies the war so that it will be deployed on start, starts Liferay, and tails the log. go.sh may take a few minutes to complete, or longer if your computer is slower.

License

Previous：Stepper

Next：znlib