Administration
Portal 2.1 Community Portlets
 |
 |
 |
 |
Table of Contents |
 |
 |
 |
 |
Community developed Portlets in the caGrid Portal
Overview
This is a short tutorial on how to deploy a user/community developed Portlet into the current caGrid Portal. This feature is not currently in the caGrid Portal, but this tutorial will help you install a local instance with a modified layout that will support adding user developed portlets.
caGrid Portal is a web application which is developed on the Liferay Portal
. caGrid Portal has a number of JSR-168 compliant portlets that are deployed by default. We are now opening up the caGrid Portal to the caBIG community so that the developers in the community can develop their own JSR-168 compliant portlets and have these Portlets deployed in the caGrid Portal. This will allow developers an instant hosting environment for their User Interface components as well as bringing their applications in front of the entire caBIG community.
Before you can submit your Portlet to the caGrid Team, it is recommended that you test your Portlet locally. Below are the steps on how you can deploy a JSR-168 Portlet into a local installation of caGrid Portal.
Developing Portlets
The following links should help
Also, look at the EVS portlet developed specifically to serve as sample for Portlet developers. You can find more information on the EVS Portlet here
Deploying Portlets in the caGrid Portal
Install caGrid Portal
- Download the latest release of caGrid Portal from the gforge site
- Download the modified layout file from here
- Unzip the caGrid Portal Release to ${PORTAL_HOME} directory.
- Copy the downloaded layout file (.lar) to ${PORTAL_HOME}/cagrid-portal/portals/liferay/lars
- Install and configure the caGrid Portal. Installation instructions can be found here
Download Sample Portlet
- For this example we will use a sample Portlet that can be downloaded here.
Note: Download a version compatible with Liferay 4.3.3
Deploy Sample Portlet
- Place the downloaded sample Portlet in the ${PORTAL_LIFERAY}/deploy folder.
Note: The ${PORTAL_LIFERAY} folder is the directory where you chose to install the Portal.
- Startup your local JBOSS server.
- Login to the caGrid Portal as the admin user. Please refer the administration guide found here for more information
- Once you login you will see the default page as shown below
 |
| Homepage for Admin User |
- From the drop down menu (top right), select My Places->Guest->Public Pages as shown below
 |
| Admin Menu |
- Select the "Community" tab as shown in the screenshot below. This is where all the community Porlets will be hosted
 |
| caGrid Portal 2.1 with the community tab |
- Once you are in the community page, you should see a blank page with no portlets. From from the drop down menu (top right), select the "Add Content" link. This will display(shown below) a list of portlets that can be deployed in the caGrid Portal.
 |
| Add New Portlet |
- The sample Portal that we deployed in Step 1 should also show up under "Sample/Spring/Pets". Select the Pets portlet and the page will update itself.
 |
| Sample Portlet deployed |
- Logout
- Now when you see open the Portal in a web browser (http://localhost:8080) you will see the Sample Portlet in the community section of the caGrid Portal. We have just successfully deployed the sample portlet as a community Portlet in the caGrid Portal!!
Redeploy
To re-deploy a previously deployed community or sample Portlet, do the following
- Shutdown your local JBOSS instance
- Copy the new portlet archive(war) into the $
Unknown macro: {PORTAL_LIFERAY}
/deploy
- Startup JBOSS