To write a ColdFusion portlet:
Create a CFC that extends the CFIDE.portlets.ColdFusionPortlet package. For example, the following HelloPortlet.cfc extends this package and defines the doView() and doHelp()methods:
<cfcomponent extends="CFIDE.portlets.ColdFusionPortlet">
<cffunction name="doView" returntype="void" output="true">
<cfargument name="renderRequest" type="any" required="true" hint="A
javax.portlet.RenderRequest java object">
<cfargument name="renderResponse" type="any" required="true" hint="A
javax.portlet.RenderResponse java object">
<cfoutput>
Hello World ColdFusion Portlet
</cfoutput>
</cffunction>
<cffunction name="doHelp" returntype="void" output="true">
<cfargument name="renderRequest" type="any" required="true" hint="A
javax.portlet.RenderRequest java object">
<cfargument name="renderResponse" type="any" required="true" hint="A
javax.portlet.RenderResponse java object">
<h1>ColdFusion Help</h1>
<p>This is a Help message for the Hello Portlet.</p>
</cffunction>
</cfcomponent>- Save HelloPortlet.cfc }}in {{<jboss_server_home>\server\default\deploy\cfusion.ear\cfusion.war\portlets\hello.
Define HelloPortlet.cfc in portlet.xml, which is located in the WEB-INF folder of ColdFusion web root. The portlet.xmlfile looks similar to the following:
<?xml version="1.0" encoding="UTF-8"?>
<portlet-app xmlns="http://java.sun.com/xml/ns/portlet/portlet-app_1_0.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/portlet/portlet-app_1_0.xsd http://java.sun.com/xml/ns/portlet/portlet-app_1_0.xsd" version="1.0">
<portlet>
<description xml:lang="en">This Portlet is a Hello World CF Portlet</description>
<portlet-name>ColdFusionPortlet</portlet-name>
<display-name xml:lang="en">CF Hello Portlet</display-name>
<portlet-class>coldfusion.portlet.ColdFusionPortlet</portlet-class>
<init-param>
<name>cfcName</name>
<value>portlets.hello.HelloPortlet</value>
</init-param>
<supports>
<mime-type>text/html</mime-type>
<portlet-mode>VIEW</portlet-mode>
<portlet-mode>HELP</portlet-mode>
</supports>
<portlet-info>
<title>ColdFusion Hello World Portlet</title>
</portlet-info>
</portlet>
</portlet-app>The portlet is defined and registered for portlet definition, with targeted cfcName defined as the INIT parameter. The INIT parameter value must be from the web root of ColdFusion.
- Run the JBoss server by running one of the following commands: On UNIX{{<JBoss_home>/bin/run.sh}} On Windows<JBoss_home>\bin\run.bat}}By default JBoss only binds to localhost. You can have it bind to any IP address by running {{bin/run.sh -b 0.0.0.0 }}on UNIX or {{bin/run.bat -b 0.0.0.0 on Windows.
- Launch the JBoss portal server. By default, JBoss binds to port 8080, so launch the server using the URL: http://<matching_IP>:<port>/portal/. For example: http://127.0.0.1:8080/portal.
- Log in to the portal by clicking the login link in the upper-right corner. The default credentials are admin/admin.
- Click the Admin option in the upper-right corner.
- Click the Portlet Definitions tab. The portlet name, CF HelloPortlet is listed here.
- Create an instance of this portlet by clicking Create Instance under Actions.
- Specify the instance name.
- Add the instance display name.
- Click the Portal Objects tab.
- Create a new portal page by specifying the portal name in the Create a portal named box.
- Select the created portal page from the list of portals.
- From Actions, select Page Layout.
- From the Portlet instance associated with this Window list, select the portlet instance you created in step 10.
- In the Page Layout section, click Add for the center region or left region to add the portlet container in the required area.
- Go back to the Portal Objects > Portals page and select Make Default option to set the new portal as default.
- Click the Portal option on the upper-right corner to view the new portal page containing the portlet.
