WebSphere Portal

Setting up Websphere Portal

• Download Websphere Portal from IBM
• Follow the installation guide here to install
• Browse http://localhost:10039/wps/portal and set up admin account and password

Create ZK portlet project

since 6.0.1

• Create a ZK project by ZK Studio
• Add the following portlet.xml file under /WEB-INF

<?xml version="1.0" encoding="UTF-8"?>
<portlet-app version="2.0"
	xmlns="http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd 
                                        http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd">
	<portlet>
		<portlet-name>zk</portlet-name>
		<display-name>zk</display-name>
		<portlet-class>org.zkoss.zk.ui.http.DHtmlLayoutPortlet</portlet-class>
		<init-param>
			<name>zk_page</name>
			<value>/index.zul</value> <!-- the main page of portlet -->
		</init-param>
		<expiration-cache>0</expiration-cache>
		<supports>
			<mime-type>text/html</mime-type>
		</supports>
		<portlet-info>
			<title>zk</title>
			<short-title>zk</short-title>
			<keywords>zk</keywords>
		</portlet-info>
		<security-role-ref>
			<role-name>administrator</role-name>
		</security-role-ref>
		<security-role-ref>
			<role-name>guest</role-name>
		</security-role-ref>
		<security-role-ref>
			<role-name>power-user</role-name>
		</security-role-ref>
		<security-role-ref>
			<role-name>user</role-name>
		</security-role-ref>
	</portlet>
</portlet-app>

• Export the project as a war file

Deploy ZK portlet in WebSphere Portal

• Browse http://localhost:10039/wps/portal and login with admin account
• Click Administration tab at the top of the page

• Select Web Module then click the install button.

• Click Choose File button to select the war file then press the Next button.

• Check the war information and choose Start application, then click the Finish button.

• Go back to Home page

• Add a new tab page by clicking Action -> EditPage

• Click New Page then enter "Page name" and "Friendly URL Name"

• Add the deployed portlet to the created new page by clicking Action -> EditPage.
• Click Customize -> All -> in the search box, enter the portlet name defined in portlet.xml

• Drag and drop the portlet into the created new page and click Save & Exit button.

• ZK project is now deployed in a Websphere Portal