Portlet support in ICEfaces is now provided by third-party bridges. There are two bridges to choose from and the one you should use depends on the portal platform and version you are using:
* PortletFaces Bridge
* Liferay Faces Bridge
Consult the following sections for additional details related to running the sample portlet applications provided in the ICEfaces distrubution as well as developing portlets of your own.
h3. PortletFaces Bridge vs Liferay Faces Bridge
The [PortletFaces Bridge|http://www.portletfaces.org/projects/portletfaces-bridge] is an implementation of the [JSR 329: Portlet 2.0 Bridge for JavaServer Faces|http://www.jcp.org/en/jsr/detail?id=329]. The portlet bridge specification technically applies to JSF 1.2 but was adapted to support JSF 2. However, this bridge is a legacy product and has since been discontinued and no longer available.
The version of the PortletFaces Bridge that is currently shipped with ICEfaces is maintained in the ICEfaces bundle for legacy purposes and to support running ICEfaces on older portal platforms like Liferay 5. It includes fixes that aren't available with the originally released version allowing it to run on WebSphere Portal. Support for WebSphere Portal is provided as part of [ICEfaces EE (Enterprise Edition)|http://www.icesoft.org/products/ICEfaces-EE/overview.jsf]. Ensure you use the copy of the library that ships with ICEfaces for older ICEfaces portlet deployments.
The [Liferay Faces Bridge|http://www.liferay.com/community/liferay-projects/liferay-faces/overview|Liferay Faces] is part of a suite of tools currently supported by Liferay to allow developers to build and run JSF-based portlets on Liferay Portal. It supports Liferay version 6 and above. There is more information about the different Liferay Faces Bridge versions and the platforms they support on [Liferay's site|http://www.liferay.com/web/neil.griffin/blog/-/blogs/announcement-liferay-faces-3-1-0-ga1-released].
Due to licensing restrictions, the Liferay Faces Bridge libraries do not come bundled with the ICEfaces product. You can find information [here|http://www.liferay.com/community/liferay-projects/liferay-faces/download|Liferay Faces downloads] for:
* downloading them directly for use in Ant-based builds
* incorporating them as dependencies into your Maven-based project
h3. Sample Applications
Because the Liferay Faces Bridge libraries are not included in the bundle, the sample portlet builds included in the ICEfaces distribution default to using the PortletFaces Bridge. However, if you are running on newer versions of Liferay, you can specify a property (Ant) or profile (Maven) to instruction the samples to use the Liferay Faces Bridge. More information on building running the samples can be found at:
Portlet Development
