Getting started with PortletFaces is as easy as 1...2...3...

1. Include the PortletFaces JAR in your portlet's Maven 2 pom.xml file or download the binary distribution and copy the JARs into your portlet's WEB-INF/lib folder. Details can be found on the Download page.
2. Throw away the JSFPorltetUtil.java class that you wrote. :-) Let's be honest -- if you have written JSF portlets before, then you've written a utility class with a bunch of static methods like getPortletRequest(). Instead call PortletFacesContext.getInstance() at the top of your backing managed-bean and then call methods like:
   • portletFacesContext.getPortletRequest()
   • portletFacesContext.getPermissionChecker()
   • portletFacesContext.getThemeDisplay()
3. Check out the example portlets for ideas, and also read Chapter 6 and Chapter 5 of the edoras framework User's Guide.

Get Involved!

Here are some ways you can help us make PortletFaces better:

• Download the source code
• Checkout the source code from SVN
• Participate in the forums
• File bugs and feature requests in the JIRA issue tracker