Copyright © 2000-2006 Liferay, Inc. Basic Portlet Copyright © 2000-2006 Liferay, Inc. All Rights Reserved. No material may be reproduced electronically or in print without written permission from Liferay, LLC.

Introduction Difficulty Level: Easy The source code for this presentation is located here: source-code-part1 Make sure to read the code! It’s important to become familiar with the basic structure before the exercises get more complicated.

Objectives The goal of this tutorial is to create a JSP portlet Define the portlet portlet-ext.xml liferay-portlet-ext.xml Create the JSP view.jsp

Directory Structure Configuration files are located here: ext\ext-web\docroot\WEB-INF JSPs are located here: ext\ext-web\docroot\html

Define the Portlet The first step will be to define the portlet in portlet-ext.xml The second step will be to define the portlet in liferay-portlet-ext.xml

portlet-ext.xml <portlet> <portlet-name>EXT_2</portlet-name> <display-name>JSP Portlet Introduction</display-name> <portlet-class>com.liferay.portlet.JSPPortlet</portlet- class> <init-param> <name>view-jsp</name> <value>/portlet/ext/jsp_portlet/view.jsp</value> </init-param> <expiration-cache>0</expiration-cache>

<supports> <mime-type>text/html</mime-type> </supports> <resource- bundle>com.liferay.portlet.StrutsResourceBundle</resou rce-bundle> <security-role-ref> <role-name>power-user</role-name> </security-role-ref> <role-name>user</role-name> </portlet>

Checkpoint What is <portlet-name> used for? What is <portlet-class> used for? What is view-jsp? What is /portlet/ext/jsp_portlet/view.jsp? What is <role-name> used for?

liferay-portlet-ext.xml The second step is to define the portlet in liferay-portlet-ext.xml <portlet> <portlet-name>EXT_2</portlet-name> </portlet>

view.jsp Create the following directory structure: ext\ext-web\docroot\html\portlet\ext\jsp_portlet Create view.jsp ext\ext-web\docroot\html\portlet\ext\jsp_portlet \view.jsp Enter the following in view.jsp JSP Portlet!

Checkpoint Why did we place view.jsp here? ext\ext-web\docroot\html\portlet\ext\jsp_portlet \view.jsp Hint: portlet-ext.xml Where are configuration files like portlet- ext.xml and liferay-portlet-ext.xml located?

Deploy the Files to Tomcat Click Start  Run… Type cmd and press Enter Navigate to C:\Training\liferay\ext Type ant deploy

Checkpoint Verify that your files were deployed to Tomcat correctly. This is a required step! Go to \tomcat\webapps\ROOT\WEB-INF Check portlet-ext.xml and liferay-portlet-ext.xml and make sure they are correct Go to tomcat\webapps\ROOT\html\portlet \ext\jsp_portlet Make sure that view.jsp exists and that it is correct See the Troubleshooting section if your files were not deployed correctly.

Final Steps Restart Tomcat: Click on the Tomcat Window Press Ctrl-C Double click startup.bat Open up a new browser and type http://localhost:8080 Login: test@liferay.com Password: test Click Add Content  Undefined Click javax.portlet.title.EXT_2

Troubleshooting Question: My files are not being deployed to Tomcat correctly! Answer: You have an error in app.server.{user.name}.properties Make sure that app.server.{user.name}.properties is located in C:/Training/liferay/ext Verify that your {user.name} is correct Make sure that app.server.{user.name}.properties contains the following: app.server.type=tomcat app.server.tomcat.dir=C:/Training/liferay/tomcat

Troubleshooting Question: My portlet is not showing up when I click Add Content  Undefined Answer: Your portlet is not defined correctly in portlet-ext.xml or liferay-portlet-ext.xml Check portlet-ext.xml and liferay-portlet-ext.xml in C:/Training/liferay/tomcat/webapps/ROOT/WEB-INF Make sure that the EXT_2 portlet is defined correctly.

Congratulations! You’ve created your first JSP Portlet! Defined the portlet in portlet-ext.xml Defined the portlet in liferay-portlet-ext.xml Created the JSP in ext\ext-web\docroot\html\portlet\ext\jsp_portlet \view.jsp

Revision History Edward Shin 09/14/06 Updated for Liferay 4.1.2