2/14/2011

Getting started with Liferay 6 and ICEfaces 2.0 - Part 1

Because of a request on linkedin (http://de.linkedin.com/in/liferayblogging) I am putting together a "Hello World" for Liferay 6 and ICEfaces 2.0. There are plenty of introductions, tutorials and "hello worlds" out there, so what I intend to do for Part 1 is to link to the best of them (mostly from the official pages). Part 2 will contain a step-by-step introduction on how to create an ICEfaces portlet if you already have Liferay running. I´ll also provide some links to books I read ... Let´s get started !


Getting started with Liferay and Liferay IDE


So ... first steps in Liferay 6. At first you need to download Liferay and choose an IDE. I am always using Eclipse, so I suggest you use Liferay IDE which is a very good extension for Eclipse.


Download Liferay (bundles with Tomcat) here : http://www.liferay.com/de/downloads/liferay-portal/available-releases


Unzip the file somewhere on your harddrive and start up the portal by double-clicking the "startup.bat" in the "bin" folder. Now it´s time to install the Liferay IDE plugin for Eclipse. Here is a fine tutorial to do so:


http://www.liferay.com/de/community/wiki/-/wiki/Main/Liferay+IDE+Installation+Guide


If you need an overview about all that is possible with the Liferay IDE, take a look at this fantastic page: http://www.liferay.com/de/community/wiki/-/wiki/Main/Liferay+IDE .


If you want to know how Liferay works and what it is capable of (from an administrators view), I can recommend the "Portal administration guide", directly from Liferay:


5.2 : http://docs.liferay.com/portal/5.2/official/liferay-administrator-guide-5.2.pdf

6.0 : http://docs.liferay.com/portal/6.0/official/liferay-administrator-guide-6.0.pdf


If you are into developing, you might want to take a look into the developers guide:


6.0 : http://docs.liferay.com/portal/6.0/official/liferay-developer-guide-6.0.pdf


What you have now is a configured Eclipse and Liferay that lets you develop portlets very easy. Unfortunately it´s only JSP Portlets, so ... how do you get ICEfaces to run ?


Geting started with ICEfaces 2.0


We will do this in two steps. Step 1 is to understand how ICEfaces applications are done, step 2 is to integrate ICEfaces into Liferay.


The best starting point to see how Eclipse and ICEFaces 2.0 work together is here: http://wiki.icefaces.org/display/ICE/Creating+ICEfaces+Applications+with+Eclipse


So - how do ICEfaces applications run within Liferay ? ICEfaces uses the portlet bridge which translates between the JSF and the portlet lifecycle. The portletfaces bridge is already included in ICEfaces 2.0, but if you want to take alook at the project, you can do it here: http://www.portletfaces.org/projects/portletfaces-bridge;jsessionid=663389E7787ED007F47E0ED3ED3AD419


This page also allows you to download a sample ICEfaces 2.0 portlet that you can just deploy and run in Liferay 6 (http://www.portletfaces.org/portletfaces-bridge/examples/jsf-2.0/icefaces-2.x-portlet).


If you want to take a look at the ICEfaces developers guide, take a look here: 

1.8: http://www.icefaces.org/docs/latest/ICEfacesDevelopersGuide.pdf

2.0http://wiki.icefaces.org/display/ICE/ICEfaces+2+Documentation



So - that´s it for today. I will try to write down a "step-by-step" introduction on how to create an ICEfaces 2.0 portlet tomorrow.



If you liked this tutorial it would be very nice, if you could click on some of the google ads you see on the right side. It helps me run this block and motivates me ;)

If you have any questions, feel free to leave a comment.