JBoss Portal SVN: r10429 - in modules/portlet/trunk/docs/user-guide/en: modules and 1 other directory.
by portal-commits@lists.jboss.org
Author: julien(a)jboss.com
Date: 2008-03-31 06:22:20 -0400 (Mon, 31 Mar 2008)
New Revision: 10429
Added:
modules/portlet/trunk/docs/user-guide/en/images/admin1.png
modules/portlet/trunk/docs/user-guide/en/images/admin2.png
Modified:
modules/portlet/trunk/docs/user-guide/en/modules/simpleportal.xml
Log:
documentation for the admin portlet
Added: modules/portlet/trunk/docs/user-guide/en/images/admin1.png
===================================================================
(Binary files differ)
Property changes on: modules/portlet/trunk/docs/user-guide/en/images/admin1.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: modules/portlet/trunk/docs/user-guide/en/images/admin2.png
===================================================================
(Binary files differ)
Property changes on: modules/portlet/trunk/docs/user-guide/en/images/admin2.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Modified: modules/portlet/trunk/docs/user-guide/en/modules/simpleportal.xml
===================================================================
--- modules/portlet/trunk/docs/user-guide/en/modules/simpleportal.xml 2008-03-31 09:44:16 UTC (rev 10428)
+++ modules/portlet/trunk/docs/user-guide/en/modules/simpleportal.xml 2008-03-31 10:22:20 UTC (rev 10429)
@@ -550,10 +550,45 @@
</sect1>
<sect1>
<title>Administration</title>
- <para>todo</para>
<sect2>
<title>Admin portlet</title>
- <para>todo</para>
+ <para>The admin portlet shows the list of portlet applications deployed in the simple portal. For each
+ portlet application it is possible to unfold the appliation to display the portlet contained in the
+ unfolded application as well as the portlet filters.</para>
+ <sect3>
+ <title>Portlet application administration</title>
+ <para>By default the admin portlet displays the list of portlet applications. It shows the status
+ of each application and provides the capability to stop or start an application.</para>
+ <mediaobject>
+ <imageobject>
+ <imagedata align="center" fileref="images/admin1.png" format="PNG"
+ valign="middle"/>
+ </imageobject>
+ <caption>
+ <para>The admin portlet showing all the portlet applications.</para>
+ </caption>
+ </mediaobject>
+ <para>On the example we can see that all the applications are in started mode except the
+ <emphasis>samples-basic-portlet</emphasis> application. It is possible to manage the
+ life cycle of each application by clicking on the <emphasis>start</emphasis> link when it
+ is stopped or clicking on the <emphasis>stop</emphasis> link when it is started.</para>
+ </sect3>
+ <sect3>
+ <title>Portlet container and filter administration</title>
+ <para>Selecting a particular portlet application unfolds it and shows the list of portlet containers
+ that the application contains as well as the filters it contains.</para>
+ <mediaobject>
+ <imageobject>
+ <imagedata align="center" fileref="images/admin2.png" format="PNG"
+ valign="middle"/>
+ </imageobject>
+ <caption>
+ <para>The admin portlet showing the portlets container and filters contained in an application.</para>
+ </caption>
+ </mediaobject>
+ <para>Again here it displays the name of the container and filters, the status of the life cycle and
+ a link to start or stop the corresponding item.</para>
+ </sect3>
</sect2>
<sect2>
<title>Logging configuration</title>
16 years, 1 month
JBoss Portal SVN: r10428 - docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules.
by portal-commits@lists.jboss.org
Author: mmcallis
Date: 2008-03-31 05:44:16 -0400 (Mon, 31 Mar 2008)
New Revision: 10428
Modified:
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml
Log:
6.2.2. The portlet-instances.xml Descriptor
- minor revision to preference section (string
value foo, bar, bar1, 2 etc
Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml
===================================================================
--- docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml 2008-03-31 09:08:19 UTC (rev 10427)
+++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml 2008-03-31 09:44:16 UTC (rev 10428)
@@ -1188,7 +1188,7 @@
<programlisting><![CDATA[<preferences><preference>...</preference></preferences>]]></programlisting>
</para>
<para>
- The <computeroutput><preferences></computeroutput> element configures an instance with a set of preferences, and is a container for the <computeroutput><preference></computeroutput> element. The <computeroutput><preference></computeroutput> element configures an instance with a set of preferences. Preferences can be described as a <emphasis>String</emphasis> type, or a key-value pair. The following specifies preferences as a <emphasis>String[]</emphasis> type:
+ The <computeroutput><preference></computeroutput> element configures a preference as a key-value pair. This value can be composed of a single string value, or multiple strings. For example, the preference <emphasis>foo</emphasis> can have <emphasis>value0</emphasis>, or <emphasis>value0</emphasis>, <emphasis>value1</emphasis>, and <emphasis>value2</emphasis>:
</para>
<para>
<screen><![CDATA[
16 years, 1 month
JBoss Portal SVN: r10427 - in modules/portlet/trunk: docs/user-guide/en/images and 5 other directories.
by portal-commits@lists.jboss.org
Author: julien(a)jboss.com
Date: 2008-03-31 05:08:19 -0400 (Mon, 31 Mar 2008)
New Revision: 10427
Added:
modules/portlet/trunk/docs/user-guide/en/images/debugger1.png
modules/portlet/trunk/docs/user-guide/en/images/debugger2.png
Modified:
modules/portlet/trunk/build/distrib/distrib.xml
modules/portlet/trunk/docs/user-guide/en/modules/simpleportal.xml
modules/portlet/trunk/portal/pom.xml
modules/portlet/trunk/portal/src/assemble/simple-portal-jboss42.xml
modules/portlet/trunk/portal/src/assemble/simple-portal-tomcat60.xml
modules/portlet/trunk/portal/src/main/resources/simple-portal-war/layouts/nav/main.jsp
modules/portlet/trunk/samples/src/main/java/org/jboss/portal/portlet/samples/basic/RandomEventPortlet.java
Log:
added event debugger documentation
Modified: modules/portlet/trunk/build/distrib/distrib.xml
===================================================================
--- modules/portlet/trunk/build/distrib/distrib.xml 2008-03-31 05:53:27 UTC (rev 10426)
+++ modules/portlet/trunk/build/distrib/distrib.xml 2008-03-31 09:08:19 UTC (rev 10427)
@@ -1,4 +1,4 @@
-<project default="all" name="JBoss Portlet Container">
+im<project default="all" name="JBoss Portlet Container">
<property name="source.dir" value="../.."/>
<property name="src.docs.dir" value="${source.dir}/docs"/>
@@ -86,7 +86,7 @@
<!-- Simple portal -->
<copy todir="${pc.build.bin.as42}/server/default/deploy/simple-portal">
<fileset
- dir="${source.dir}/portal/target/portlet-portal-${maven.version}-simple-portal-jboss42.dir/simple-portal"/>
+ dir="${source.dir}/portal/target/simple-portal-jboss42.dir/simple-portal"/>
</copy>
<!-- Taglib integration -->
@@ -124,12 +124,12 @@
<!-- -->
<copy todir="${pc.build.bin.tomcat6}/lib">
<fileset
- dir="${source.dir}/portal/target/portlet-portal-${maven.version}-simple-portal-tomcat60.dir/simple-portal/lib"
+ dir="${source.dir}/portal/target/simple-portal-tomcat60.dir/simple-portal/lib"
includes="**/*.jar"/>
</copy>
<jar file="${pc.build.bin.tomcat6}/webapps/simple-portal.war">
<fileset
- dir="${source.dir}/portal/target/portlet-portal-${maven.version}-simple-portal-tomcat60.dir/simple-portal/simple-portal.war"
+ dir="${source.dir}/portal/target/tomcat60.dir/simple-portal/simple-portal.war"
includes="**"/>
</jar>
Added: modules/portlet/trunk/docs/user-guide/en/images/debugger1.png
===================================================================
(Binary files differ)
Property changes on: modules/portlet/trunk/docs/user-guide/en/images/debugger1.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: modules/portlet/trunk/docs/user-guide/en/images/debugger2.png
===================================================================
(Binary files differ)
Property changes on: modules/portlet/trunk/docs/user-guide/en/images/debugger2.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Modified: modules/portlet/trunk/docs/user-guide/en/modules/simpleportal.xml
===================================================================
--- modules/portlet/trunk/docs/user-guide/en/modules/simpleportal.xml 2008-03-31 05:53:27 UTC (rev 10426)
+++ modules/portlet/trunk/docs/user-guide/en/modules/simpleportal.xml 2008-03-31 09:08:19 UTC (rev 10427)
@@ -509,7 +509,44 @@
</sect1>
<sect1>
<title>Portlet debugging</title>
- <para>todo</para>
+ <para>The Portlet 2.0 specification provides a new eventing feature for coordinating several portlets.
+ This long awaited feature is very powerful but can sometime lead to complex scenarios when multiple
+ events are consumed and fired by multiple portlets on the same page.</para>
+ <para>The simple portal provides a visual debugger that can be used to understand what happens during the
+ event phase orchestrated by the portal. It comes as a portlet that you can place on any page and it shows
+ a tree of events that were produced and consumed during the event phase.</para>
+ <mediaobject>
+ <imageobject>
+ <imagedata align="center" fileref="images/debugger1.png" format="PNG"
+ valign="middle"/>
+ </imageobject>
+ <caption>
+ <para>Event debugger portlet.</para>
+ </caption>
+ </mediaobject>
+ <para>The event debugger displays a tree of events produced and consumed by portlets. The nodes of the
+ tree don't represent events, they rather represent event routings from a source portlet to
+ a destination portlet. By default it shows the name of the portlet that published the event,
+ the event name and the destination of the event that was chosen by the simple portal during
+ the event distribution phase. Hovering the mouse on a node shows more information.</para>
+ <mediaobject>
+ <imageobject>
+ <imagedata align="center" fileref="images/debugger2.png" format="PNG"
+ valign="middle"/>
+ </imageobject>
+ <caption>
+ <para>Event debugger portlet.</para>
+ </caption>
+ </mediaobject>
+ <para>When hovering the mouse on a node you can see the optional event payload represented by
+ the string returned when invoked its <code>toString()</code> method and the state of the portlet
+ after the event phase. The state of the portlet consist in its portlet mode, its window state and the
+ set of its render parameters. Adding the event debugger to a page is easy.</para>
+ <example>
+ <title>Adding the event debugger to a portal page</title>
+ <programlisting><![CDATA[
+...<xportal:portlet name="DebuggerPortlet" applicationName="simple-portal"/>...]]></programlisting>
+ </example>
</sect1>
<sect1>
<title>Administration</title>
Modified: modules/portlet/trunk/portal/pom.xml
===================================================================
--- modules/portlet/trunk/portal/pom.xml 2008-03-31 05:53:27 UTC (rev 10426)
+++ modules/portlet/trunk/portal/pom.xml 2008-03-31 09:08:19 UTC (rev 10427)
@@ -185,6 +185,7 @@
<plugin>
<artifactId>maven-assembly-plugin</artifactId>
<configuration>
+ <finalName>simple-portal</finalName>
<descriptors>
<descriptor>src/assemble/simple-portal-jboss42.xml</descriptor>
<descriptor>src/assemble/simple-portal-tomcat60.xml</descriptor>
Modified: modules/portlet/trunk/portal/src/assemble/simple-portal-jboss42.xml
===================================================================
--- modules/portlet/trunk/portal/src/assemble/simple-portal-jboss42.xml 2008-03-31 05:53:27 UTC (rev 10426)
+++ modules/portlet/trunk/portal/src/assemble/simple-portal-jboss42.xml 2008-03-31 09:08:19 UTC (rev 10427)
@@ -1,5 +1,5 @@
<assembly>
- <id>simple-portal-jboss42</id>
+ <id>jboss42</id>
<formats>
<format>dir</format>
</formats>
Modified: modules/portlet/trunk/portal/src/assemble/simple-portal-tomcat60.xml
===================================================================
--- modules/portlet/trunk/portal/src/assemble/simple-portal-tomcat60.xml 2008-03-31 05:53:27 UTC (rev 10426)
+++ modules/portlet/trunk/portal/src/assemble/simple-portal-tomcat60.xml 2008-03-31 09:08:19 UTC (rev 10427)
@@ -1,5 +1,5 @@
<assembly>
- <id>simple-portal-tomcat60</id>
+ <id>tomcat60</id>
<formats>
<format>dir</format>
</formats>
Modified: modules/portlet/trunk/portal/src/main/resources/simple-portal-war/layouts/nav/main.jsp
===================================================================
--- modules/portlet/trunk/portal/src/main/resources/simple-portal-war/layouts/nav/main.jsp 2008-03-31 05:53:27 UTC (rev 10426)
+++ modules/portlet/trunk/portal/src/main/resources/simple-portal-war/layouts/nav/main.jsp 2008-03-31 09:08:19 UTC (rev 10427)
@@ -30,7 +30,7 @@
<a href="${pageContext.request.contextPath}/demo/demo3.jsp" class="${fn:substringAfter(pageContext.request.servletPath, 'demo/') == 'demo3.jsp' ? 'selected' : ''}">Demo3</a>
</li>
<li>
- <a href="${pageContext.request.contextPath}/demo/demo4.jsp" class="${fn:substringAfter(pageContext.request.servletPath, 'demo/') == 'demo4.jsp' ? 'selected' : ''}">Demo3</a>
+ <a href="${pageContext.request.contextPath}/demo/demo4.jsp" class="${fn:substringAfter(pageContext.request.servletPath, 'demo/') == 'demo4.jsp' ? 'selected' : ''}">Demo4</a>
</li>
</ul>
<br class="clear"/>
Modified: modules/portlet/trunk/samples/src/main/java/org/jboss/portal/portlet/samples/basic/RandomEventPortlet.java
===================================================================
--- modules/portlet/trunk/samples/src/main/java/org/jboss/portal/portlet/samples/basic/RandomEventPortlet.java 2008-03-31 05:53:27 UTC (rev 10426)
+++ modules/portlet/trunk/samples/src/main/java/org/jboss/portal/portlet/samples/basic/RandomEventPortlet.java 2008-03-31 09:08:19 UTC (rev 10427)
@@ -113,22 +113,22 @@
}
//
- if (repeat > 0)
- {
- publishState(resp, repeat - 1);
- }
+ publishState(resp, repeat - 1);
}
private void publishState(StateAwareResponse resp, int repeat)
{
- QName name = pickQName();
- resp.setEvent(name, repeat);
+ if (repeat > 0)
+ {
+ QName name = pickQName();
+ resp.setEvent(name, repeat);
- //
- resp.setRenderParameter(pickValue(PARAM_NAMES), pickValue(PARAM_VALUES));
+ //
+ resp.setRenderParameter(pickValue(PARAM_NAMES), pickValue(PARAM_VALUES));
- //
- System.out.println("Portlet " + getPortletConfig().getPortletName() + " generated the event (" + name + "," + repeat + ")");
+ //
+ System.out.println("Portlet " + getPortletConfig().getPortletName() + " generated the event (" + name + "," + repeat + ")");
+ }
}
public void render(RenderRequest req, RenderResponse resp) throws PortletException, IOException
@@ -137,9 +137,16 @@
//
PrintWriter writer = resp.getWriter();
- writer.println("<form action=\"" + actionURL + "\" method=\"post\">");
- writer.println("<input type=\"text\" name=\"repeat\" value=\"2\"/>");
+
+ //
+ writer.println("<p>The random event portlet generates and consumes randomly generated events during the event " +
+ "phase of a portlet. It is used to show a complex eventing scenario and how the event debugger portlet " +
+ "can be useful to understand how the events were distributed during the event phase.</p>");
+
+ //
+ writer.println("<p><form action=\"" + actionURL + "\" method=\"post\">");
+ writer.println("Number maximum of event phases: <input type=\"text\" name=\"repeat\" value=\"3\"/>");
writer.println("<input type=\"submit\"/>");
- writer.println("</form>");
+ writer.println("</form></p>");
}
}
16 years, 1 month
JBoss Portal SVN: r10426 - docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules.
by portal-commits@lists.jboss.org
Author: mmcallis
Date: 2008-03-31 01:53:27 -0400 (Mon, 31 Mar 2008)
New Revision: 10426
Modified:
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml
Log:
6.2.2. The portlet-instances.xml Descriptor
- minor revisions
Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml
===================================================================
--- docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml 2008-03-31 05:07:09 UTC (rev 10425)
+++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml 2008-03-31 05:53:27 UTC (rev 10426)
@@ -1093,7 +1093,7 @@
<sect2 id="desc_instancesxml">
<title>The <filename>portlet-instances.xml</filename> Descriptor</title>
<para>
- The <filename>portlet-instances.xml</filename> descriptor is JBoss Portal specific, and allows developers to instantiate one-or-many instances of one-or-many portlets. The benefit of this allows one portlet to be instantiated several times, with different preference parameters. The following example instantiates two separate instances of the <computeroutput>NewsPorlet</computeroutput>, both using different parameters. One instance draws feeds for Red Hat announcements, and the other draws McDonalds announcements:
+ The <filename>portlet-instances.xml</filename> descriptor is JBoss Portal specific, and allows developers to instantiate one-or-many instances of one-or-many portlets. The benefit of this allows one portlet to be instantiated several times, with different preference parameters. The following example instantiates two separate instances of the <computeroutput>NewsPortlet</computeroutput>, both using different parameters. One instance draws feeds from Red Hat announcements, and the other from McDonalds announcements:
</para>
<para>
<screen><![CDATA[
@@ -1164,7 +1164,7 @@
<programlisting><![CDATA[<deployment><instance>...</instance></deployment>]]></programlisting>
</para>
<para>
- The <computeroutput><deployment></computeroutput> element, and the embedded <computeroutput><instance></computeroutput> element, specify a portlet instance. The <computeroutput><deployment></computeroutput> element specifies object deployments, such as portals, pages, windows, and so on. The <computeroutput><instance></computeroutput> is used to create instances of portlets. The portlet will only be created and configured if the portlet is present, and an instance with the same name does not already exist.
+ The <computeroutput><deployment></computeroutput> element, and the embedded <computeroutput><instance></computeroutput> element, specify a portlet instance. The <computeroutput><deployment></computeroutput> element specifies object deployments, such as portals, pages, windows, and so on. The <computeroutput><instance></computeroutput> element is used to create instances of portlets. The portlet will only be created and configured if the portlet is present, and an instance with the same name does not already exist.
</para>
</listitem>
<listitem>
16 years, 1 month
JBoss Portal SVN: r10425 - docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules.
by portal-commits@lists.jboss.org
Author: mmcallis
Date: 2008-03-31 01:07:09 -0400 (Mon, 31 Mar 2008)
New Revision: 10425
Modified:
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml
Log:
6.2.2. The portlet-instances.xml Descriptor
spelling corrections, minor content addition
Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml
===================================================================
--- docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml 2008-03-31 04:59:59 UTC (rev 10424)
+++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml 2008-03-31 05:07:09 UTC (rev 10425)
@@ -1093,7 +1093,7 @@
<sect2 id="desc_instancesxml">
<title>The <filename>portlet-instances.xml</filename> Descriptor</title>
<para>
- The <filename>portlet-instances.xml</filename> Descriptor is JBoss Portal specific, and allows developers to instantiate one-or-many instances of one-or-many portlets. The benifit of this allows one portlet to be instantiated several times, with different prefence parameters. The following example instiantiates two separate instances of the <computeroutput>NewsPorlet</computeroutput>, both using different parameters. One instance draws feeds for Red Hat annoucnments, and the other draws McDonalds announcements:
+ The <filename>portlet-instances.xml</filename> descriptor is JBoss Portal specific, and allows developers to instantiate one-or-many instances of one-or-many portlets. The benefit of this allows one portlet to be instantiated several times, with different preference parameters. The following example instantiates two separate instances of the <computeroutput>NewsPorlet</computeroutput>, both using different parameters. One instance draws feeds for Red Hat announcements, and the other draws McDonalds announcements:
</para>
<para>
<screen><![CDATA[
@@ -1164,7 +1164,7 @@
<programlisting><![CDATA[<deployment><instance>...</instance></deployment>]]></programlisting>
</para>
<para>
- The <computeroutput><deployment></computeroutput>, and the embedded <computeroutput><instance></computeroutput> elements, specify a portlet instance. The <computeroutput><deployment></computeroutput> element specifies object deployments, such as portals, pages, windows, and so on.
+ The <computeroutput><deployment></computeroutput> element, and the embedded <computeroutput><instance></computeroutput> element, specify a portlet instance. The <computeroutput><deployment></computeroutput> element specifies object deployments, such as portals, pages, windows, and so on. The <computeroutput><instance></computeroutput> is used to create instances of portlets. The portlet will only be created and configured if the portlet is present, and an instance with the same name does not already exist.
</para>
</listitem>
<listitem>
@@ -1188,7 +1188,7 @@
<programlisting><![CDATA[<preferences><preference>...</preference></preferences>]]></programlisting>
</para>
<para>
- The <computeroutput><preferences></computeroutput> element configures an instance with a set of preferences, and is a container for the <computeroutput><preference></computeroutput> element. The <computeroutput><preference></computeroutput> element configures an instance with a set of preferences. Prefences can be described as a <emphasis>String</emphasis> type, or a key-value pair. The following specifies preferences as a <emphasis>String[]</emphasis> type:
+ The <computeroutput><preferences></computeroutput> element configures an instance with a set of preferences, and is a container for the <computeroutput><preference></computeroutput> element. The <computeroutput><preference></computeroutput> element configures an instance with a set of preferences. Preferences can be described as a <emphasis>String</emphasis> type, or a key-value pair. The following specifies preferences as a <emphasis>String[]</emphasis> type:
</para>
<para>
<screen><![CDATA[
16 years, 1 month
JBoss Portal SVN: r10424 - docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules.
by portal-commits@lists.jboss.org
Author: mmcallis
Date: 2008-03-31 00:59:59 -0400 (Mon, 31 Mar 2008)
New Revision: 10424
Modified:
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml
Log:
6.2.2. The portlet-instances.xml Descriptor
- periodic backup
- minor revisions
Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml
===================================================================
--- docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml 2008-03-31 04:41:23 UTC (rev 10423)
+++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml 2008-03-31 04:59:59 UTC (rev 10424)
@@ -1208,9 +1208,6 @@
</listitem>
<listitem>
<para>
- The <computeroutput><security-constraint></computeroutput> element is a container for <computeroutput><policy-permission></computeroutput> elements. The following is an example of the <computeroutput><security-constraint></computeroutput> and <computeroutput><policy-permission></computeroutput> elements:
- </para>
- <para>
<screen><![CDATA[<security-constraint>
<policy-permission>
<action-name>viewrecursive</action-name>
@@ -1219,26 +1216,29 @@
</security-constraint>]]></screen>
</para>
<para>
+ The <computeroutput><security-constraint></computeroutput> element is a container for <computeroutput><policy-permission></computeroutput> elements. This example demonstrates the <computeroutput><security-constraint></computeroutput> and <computeroutput><policy-permission></computeroutput> elements.
+ </para>
+ <para>
The <computeroutput><action-name></computeroutput> element is used to define the access rights given to the role defined. Accepted values are:
</para>
<para>
<itemizedlist>
- <listitem>
+ <listitem override="bullet">
<para>
<computeroutput>view</computeroutput>: users can view the page.
</para>
</listitem>
- <listitem>
+ <listitem override="bullet">
<para>
<computeroutput>viewrecursive</computeroutput>: users can view the page and child pages.
</para>
</listitem>
- <listitem>
+ <listitem override="bullet">
<para>
<computeroutput>personalize</computeroutput>: users are able personalize the page's theme.
</para>
</listitem>
- <listitem>
+ <listitem override="bullet">
<para>
<computeroutput>personalizerecursive</computeroutput>: users are able personalize the page and child pages themes.
</para>
@@ -1250,12 +1250,12 @@
</para>
<para>
<itemizedlist>
- <listitem>
+ <listitem override="bullet">
<para>
<computeroutput>unchecked</computeroutput>: anyone can view the page.
</para>
</listitem>
- <listitem>
+ <listitem override="bullet">
<para>
<computeroutput><role-name>EXAMPLEROLE</role-name></computeroutput>: only allow users that are part of the <computeroutput>EXAMPLEROLE</computeroutput> role to access the instance.
</para>
@@ -1265,8 +1265,10 @@
</listitem>
</itemizedlist>
</para>
- <para>The example portlet-instances.xml, above, makes reference to items found in other descriptor files. To
- help with this topic, we have included a sample image that depicts the relationship:
+ <para>
+ The previous <filename>portlet-instances.xml</filename> example makes reference to items found in other descriptor files. The following diagram illustrates the relationship between the <filename>portlet.xml</filename>, <filename>portlet-instances.xml</filename>, and <filename>*-object.xml</filename> descriptors:
+ </para>
+ <para>
<mediaobject>
<imageobject>
<imagedata align="center" fileref="images/tutorials/first_portlet/desc_relationship.gif"
16 years, 1 month
JBoss Portal SVN: r10423 - docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules.
by portal-commits@lists.jboss.org
Author: mmcallis
Date: 2008-03-31 00:41:23 -0400 (Mon, 31 Mar 2008)
New Revision: 10423
Modified:
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml
Log:
6.2.2. The portlet-instances.xml Descriptor
- revising content
- adding content from previous sections
Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml
===================================================================
--- docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml 2008-03-31 04:10:24 UTC (rev 10422)
+++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml 2008-03-31 04:41:23 UTC (rev 10423)
@@ -376,7 +376,7 @@
</screen>
</para>
<para>
- The <computeroutput><portlet-ref></computeroutput> element defines the portlet that an instance will represent. The <computeroutput><portlet-ref></computeroutput> value must match the <computeroutput><portlet-name></computeroutput> given in the <filename>WEB-INF/portlet.xml</filename> file.
+ The <computeroutput><portlet-ref></computeroutput> element defines the portlet that an instance represents. The <computeroutput><portlet-ref></computeroutput> value must match the <computeroutput><portlet-name></computeroutput> given in the <filename>WEB-INF/portlet.xml</filename> file.
</para>
<para>
<screen><![CDATA[
@@ -384,7 +384,7 @@
</screen>
</para>
<para>
- The <computeroutput><preferences></computeroutput> element configures the instance with a set of preferences.
+ The <computeroutput><preferences></computeroutput> element configures an instance with a set of preferences.
</para>
</listitem>
</varlistentry>
@@ -1180,15 +1180,18 @@
<programlisting><![CDATA[<portlet-ref>...</portlet-ref>]]></programlisting>
</para>
<para>
- The <computeroutput><portlet-ref></computeroutput> element defines the portlet that an instance will represent. The <computeroutput><portlet-ref></computeroutput> value must match the <computeroutput><portlet-name></computeroutput> given in the <filename>WEB-INF/portlet.xml</filename> file.
+ The <computeroutput><portlet-ref></computeroutput> element defines the portlet that an instance represents. The <computeroutput><portlet-ref></computeroutput> value must match the <computeroutput><portlet-name></computeroutput> given in the <filename>WEB-INF/portlet.xml</filename> file.
</para>
</listitem>
<listitem>
<para>
<programlisting><![CDATA[<preferences><preference>...</preference></preferences>]]></programlisting>
- Preferences for this portlet instance are defined here, as type String, in a key-value pair style.
- It is also possible to specify preferences as type String[], as in:
- <programlisting><![CDATA[
+ </para>
+ <para>
+ The <computeroutput><preferences></computeroutput> element configures an instance with a set of preferences, and is a container for the <computeroutput><preference></computeroutput> element. The <computeroutput><preference></computeroutput> element configures an instance with a set of preferences. Prefences can be described as a <emphasis>String</emphasis> type, or a key-value pair. The following specifies preferences as a <emphasis>String[]</emphasis> type:
+ </para>
+ <para>
+<screen><![CDATA[
<preferences>
<preference>
<name>fruit</name>
@@ -1197,57 +1200,71 @@
<value>kiwi</value>
</preference>
</preferences>
-]]></programlisting>
- </para>
+]]></screen>
+ </para>
+ <para>
+ The <computeroutput><preference></computeroutput> element configures one preference, which is part of a set of preferences. Use the <computeroutput><preferences></computeroutput> element to define a set of preferences.
+ </para>
</listitem>
<listitem>
<para>
- <programlisting><![CDATA[<security-constraint>
+ The <computeroutput><security-constraint></computeroutput> element is a container for <computeroutput><policy-permission></computeroutput> elements. The following is an example of the <computeroutput><security-constraint></computeroutput> and <computeroutput><policy-permission></computeroutput> elements:
+ </para>
+ <para>
+<screen><![CDATA[<security-constraint>
<policy-permission>
<action-name>viewrecursive</action-name>
<unchecked/>
</policy-permission>
-</security-constraint>]]></programlisting>
- The security contraint portion is worth taking a look at, in an isolated fashion. It allows you to
- secure a specific portlet instance based on a user's role.
- </para>
- <para>
- <emphasis role="bold">Role definition:</emphasis>
- You must define a role that this security constraint will apply to. Possible values are:
- <itemizedlist>
- <listitem>
- <emphasis role="bold"><unchecked/></emphasis>
- Anyone can view this page.
- </listitem>
- <listitem>
- <emphasis role="bold"><role-name>SOMEROLE</role-name></emphasis>
- Access to this page is limited to the defined role.
- </listitem>
- </itemizedlist>
- <emphasis role="bold">Access Rights:</emphasis>
- You must define the access rights given to the role defined. Possible values are:
- <itemizedlist>
- <listitem>
- <emphasis role="bold">view</emphasis>
- Users can view the page.
- </listitem>
- <listitem>
- <emphasis role="bold">viewrecursive</emphasis>
- Users can view the page and child pages.
- </listitem>
- <listitem>
- <emphasis role="bold">personalize</emphasis>
- Users are able to personalize the page's theme.
- </listitem>
- <listitem>
- <emphasis role="bold">personalizerecursive</emphasis>
- Users are able to personalize the page AND its children's themes.
- </listitem>
- </itemizedlist>
- </para>
- </listitem>
- </itemizedlist>
- </para>
+</security-constraint>]]></screen>
+ </para>
+ <para>
+ The <computeroutput><action-name></computeroutput> element is used to define the access rights given to the role defined. Accepted values are:
+ </para>
+ <para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <computeroutput>view</computeroutput>: users can view the page.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <computeroutput>viewrecursive</computeroutput>: users can view the page and child pages.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <computeroutput>personalize</computeroutput>: users are able personalize the page's theme.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <computeroutput>personalizerecursive</computeroutput>: users are able personalize the page and child pages themes.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ You must define a role that the security constraint will apply to:
+ </para>
+ <para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <computeroutput>unchecked</computeroutput>: anyone can view the page.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <computeroutput><role-name>EXAMPLEROLE</role-name></computeroutput>: only allow users that are part of the <computeroutput>EXAMPLEROLE</computeroutput> role to access the instance.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </listitem>
+</itemizedlist>
+</para>
<para>The example portlet-instances.xml, above, makes reference to items found in other descriptor files. To
help with this topic, we have included a sample image that depicts the relationship:
<mediaobject>
16 years, 1 month
JBoss Portal SVN: r10422 - docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules.
by portal-commits@lists.jboss.org
Author: mmcallis
Date: 2008-03-31 00:10:24 -0400 (Mon, 31 Mar 2008)
New Revision: 10422
Modified:
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml
Log:
6.2.2. The portlet-instances.xml Descriptor
- periodic backup
- revising text
- adding text from previous sections
Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml
===================================================================
--- docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml 2008-03-31 03:22:45 UTC (rev 10421)
+++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml 2008-03-31 04:10:24 UTC (rev 10422)
@@ -376,7 +376,7 @@
</screen>
</para>
<para>
- The reference to the portlet, which is the name of the portlet. The <computeroutput><portlet-ref></computeroutput> value must match the <computeroutput><portlet-name></computeroutput> give in the <filename>WEB-INF/portlet.xml</filename> file.
+ The <computeroutput><portlet-ref></computeroutput> element defines the portlet that an instance will represent. The <computeroutput><portlet-ref></computeroutput> value must match the <computeroutput><portlet-name></computeroutput> given in the <filename>WEB-INF/portlet.xml</filename> file.
</para>
<para>
<screen><![CDATA[
@@ -1003,6 +1003,8 @@
<listitem>
<para>
<programlisting><![CDATA[<deployments>...</deployments>]]></programlisting>
+ </para>
+ <para>
The <computeroutput><deployments></computeroutput> element encapsulates the entire document, and is a container for <computeroutput><deployment></computeroutput> elements. Multiple deployments can be specified within the <computeroutput><deployments></computeroutput> element.
</para>
</listitem>
@@ -1081,7 +1083,7 @@
</para>
<para>
<note>
- <title>Are <filename>*-object.xml</filename> descriptors necessary?</title>
+ <title>Are <filename>*-object.xml</filename> descriptors required?</title>
<para>
Technically, they are not. The portal object hierarchy, such as creating portals, pages, instances, and organizing them on the page, can be defined using the management portlet, which is accessible to JBoss Portal administrators.
</para>
@@ -1089,20 +1091,12 @@
</para>
</sect2>
<sect2 id="desc_instancesxml">
- <title>portlet-instances.xml</title>
- <para>This is a JBoss Portal specific descriptor that allows a developer to instantiate one-or-many instances
- of one-or-many portlets. The benefit of using this technique, is to allow one portlet to be instantiated
- several times with different preference parameters.
- <note>
- <emphasis>Is this descriptor mandatory?</emphasis>
- Technically, no, as you can define your portal object hierarchy (create portals, pages, instances and
- organize them as you see fit) from the management portlet accessible to Portal administrators.
- </note>
- Our example, below, has us instantiating two separate instances of the
- <emphasis>NewsPortlet</emphasis>
- with different preference parameters, one instance will draw a feed for RedHat announcements and the other
- from McDonalds announcements.
- <programlisting><![CDATA[
+ <title>The <filename>portlet-instances.xml</filename> Descriptor</title>
+ <para>
+ The <filename>portlet-instances.xml</filename> Descriptor is JBoss Portal specific, and allows developers to instantiate one-or-many instances of one-or-many portlets. The benifit of this allows one portlet to be instantiated several times, with different prefence parameters. The following example instiantiates two separate instances of the <computeroutput>NewsPorlet</computeroutput>, both using different parameters. One instance draws feeds for Red Hat annoucnments, and the other draws McDonalds announcements:
+ </para>
+ <para>
+<screen><![CDATA[
<?xml version="1.0" standalone="yes"?>
<!DOCTYPE deployments PUBLIC
"-//JBoss Portal//DTD Portlet Instances 2.6//EN"
@@ -1153,48 +1147,41 @@
</instance>
</deployment>
</deployments>
-]]></programlisting>
+]]></screen>
+ </para>
+ <para>
<itemizedlist>
- <listitem>
+ <listitem>
+ <para>
+ <programlisting><![CDATA[<deployments>...</deployments>]]></programlisting>
+ </para>
+ <para>
+ The <computeroutput><deployments></computeroutput> element encapsulates the entire document, and is a container for <computeroutput><deployment></computeroutput> elements. Multiple deployments can be specified within the <computeroutput><deployments></computeroutput> element.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <programlisting><![CDATA[<deployment><instance>...</instance></deployment>]]></programlisting>
+ </para>
+ <para>
+ The <computeroutput><deployment></computeroutput>, and the embedded <computeroutput><instance></computeroutput> elements, specify a portlet instance. The <computeroutput><deployment></computeroutput> element specifies object deployments, such as portals, pages, windows, and so on.
+ </para>
+ </listitem>
+ <listitem>
<para>
- <programlisting><![CDATA[<deployments>...</deployments>]]></programlisting>
- The
- <emphasis>deployments</emphasis>
- tag, encapsulates the entire document. You may specify more than one portlet instance deployment,
- within this tag.
- </para>
- </listitem>
- <listitem>
- <para>
- <programlisting><![CDATA[<deployment><instance>...</instance></deployment>]]></programlisting>
- The
- <emphasis>deployment</emphasis>
- , and embedded
- <emphasis>instance</emphasis>
- tags are used to specify one portlet instance.
- </para>
- </listitem>
- <listitem>
- <para>
<programlisting><![CDATA[<instance-id>...</instance-id>]]></programlisting>
- A
- <emphasis role="bold">unique name</emphasis>
- given to this instance of the portlet. It must correspond to the value of
- <emphasis>instance-ref</emphasis>
- , assigned to the window in your
- <emphasis>*-object.xml</emphasis>
- .
+ </para>
+ <para>
+ The <computeroutput><instance-id></computeroutput> elements defines a <emphasis role="bold">unique name</emphasis> given to an instance of a portlet. The <computeroutput><instance-id></computeroutput> value can be named anything, but it must match the value of one of the <computeroutput><instance-ref></computeroutput> elements in the <filename>WEB-INF/*-object.xml</filename> file.
</para>
</listitem>
<listitem>
<para>
<programlisting><![CDATA[<portlet-ref>...</portlet-ref>]]></programlisting>
- The portlet that this instance will represent. It must correspond to the value of
- <emphasis>portlet-name</emphasis>
- , assigned in your
- <emphasis>portlet.xml</emphasis>
- .
- </para>
+ </para>
+ <para>
+ The <computeroutput><portlet-ref></computeroutput> element defines the portlet that an instance will represent. The <computeroutput><portlet-ref></computeroutput> value must match the <computeroutput><portlet-name></computeroutput> given in the <filename>WEB-INF/portlet.xml</filename> file.
+ </para>
</listitem>
<listitem>
<para>
@@ -1270,6 +1257,12 @@
</imageobject>
</mediaobject>
</para>
+ <note>
+ <title>Is the <filename>portlet-instances.xml</filename> descriptor required?</title>
+ <para>
+ Technically, they are not. The portal object hierarchy, such as creating portals, pages, instances, and organizing them on the page, can be defined using the management portlet, which is accessible to JBoss Portal administrators.
+ </para>
+ </note>
</sect2>
<sect2>
<title>jboss-portlet.xml</title>
16 years, 1 month
JBoss Portal SVN: r10421 - docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules.
by portal-commits@lists.jboss.org
Author: mmcallis
Date: 2008-03-30 23:22:45 -0400 (Sun, 30 Mar 2008)
New Revision: 10421
Modified:
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml
Log:
final revisions to 6.2.1. *-object.xml Descriptors
Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml
===================================================================
--- docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml 2008-03-31 02:58:46 UTC (rev 10420)
+++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml 2008-03-31 03:22:45 UTC (rev 10421)
@@ -327,7 +327,7 @@
</screen>
</para>
<para>
- The <computeroutput><if-exists></computeroutput> element is used to define the action to take if an instance with the same name already exists. Accepted values are <computeroutput>overwrite</computeroutput> and <computeroutput>keep</computeroutput>. The <computeroutput>overwrite</computeroutput> option destroys the existing object and create a new one based on the content of the deployment. The <computeroutput>keep</computeroutput> option maintains the existing object deployment, or creates a new one if it does not exist.
+ The <computeroutput><if-exists></computeroutput> element is used to define the action to take if an instance with the same name already exists. Accepted values are <computeroutput>overwrite</computeroutput> and <computeroutput>keep</computeroutput>. The <computeroutput>overwrite</computeroutput> option destroys the existing object, and creates a new one based on the content of the deployment. The <computeroutput>keep</computeroutput> option maintains the existing object deployment, or creates a new one if it does not exist.
</para>
</listitem>
</varlistentry>
@@ -1038,7 +1038,7 @@
<programlisting><![CDATA[<window>...</window>]]></programlisting>
</para>
<para>
- The <computeroutput><window></computeroutput> element defines a portlet window. The <computeroutput><window></computeroutput> element requires an <computeroutput><instance-ref></computeroutput> element, which is used to assign a portal instance to a window. As well, use the <computeroutput><region></computeroutput> and <computeroutput><height></computeroutput> elements to define where the window appears within the portlet.
+ The <computeroutput><window></computeroutput> element defines a portlet window. The <computeroutput><window></computeroutput> element requires an <computeroutput><instance-ref></computeroutput> element, which is used to assign a portal instance to a window.
</para>
</listitem>
<listitem>
@@ -1054,7 +1054,7 @@
<programlisting><![CDATA[<instance-ref>...</instance-ref>]]></programlisting>
</para>
<para>
- The <computeroutput><instance-ref></computeroutput> elements defines the portlet instances that windows represent. This value is the ID of a portlet instance, and must match the value of one of the <computeroutput><instance-id></computeroutput> elements in the <filename>WEB-INF/portlet-instances.xml</filename> file.
+ The <computeroutput><instance-ref></computeroutput> elements define the portlet instances that windows represent. This value is the ID of a portlet instance, and must match the value of one of the <computeroutput><instance-id></computeroutput> elements in the <filename>WEB-INF/portlet-instances.xml</filename> file.
</para>
</listitem>
<listitem>
@@ -1069,7 +1069,7 @@
</listitem>
</itemizedlist>
</para>
- <para>The previous <filename>*-object.xml</filename> example makes reference to items found in other descriptor files. The following diagram illustrates the relationship between the <filename>portlet.xml</filename>, <filename>portlet-instances.xml</filename>, and <filename>helloworld-object.xml</filename> descriptors:
+ <para>The previous <filename>*-object.xml</filename> example makes reference to items found in other descriptor files. The following diagram illustrates the relationship between the <filename>portlet.xml</filename>, <filename>portlet-instances.xml</filename>, and <filename>*-object.xml</filename> descriptors:
</para>
<para>
<mediaobject>
@@ -1661,7 +1661,7 @@
<emphasis>keep</emphasis>
.
<emphasis>Overwrite</emphasis>
- will destroy the existing object and create a
+ Fwill destroy the existing object and create a
new one based on the content of the deployment.
<emphasis>Keep</emphasis>
will
16 years, 1 month
JBoss Portal SVN: r10420 - docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules.
by portal-commits@lists.jboss.org
Author: mmcallis
Date: 2008-03-30 22:58:46 -0400 (Sun, 30 Mar 2008)
New Revision: 10420
Modified:
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/configuration.xml
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/installation.xml
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/migration.xml
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/tutorials.xml
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml
Log:
trying to remove the use of "will"
Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/configuration.xml
===================================================================
--- docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/configuration.xml 2008-03-31 00:55:17 UTC (rev 10419)
+++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/configuration.xml 2008-03-31 02:58:46 UTC (rev 10420)
@@ -28,7 +28,7 @@
</screen>
</para>
<para>
- This example changes the default port to port 8088. The JBoss EAP or JBoss AS server must be restarted before the new port settings will take affect.
+ This example changes the default port to port 8088. The JBoss EAP or JBoss AS server must be restarted before the new port settings take affect.
</para>
<para>
The default SSL port is 8843. To enable HTTPS support, refer to the <ulink url="http://docs.jboss.org/jbossas/jboss4guide/r4/html/ch9.chapt.html#d0e21962">JBoss AS Guide</ulink>. For further information, refer to <ulink url="http://tomcat.apache.org/tomcat-6.0-doc/ssl-howto.html">Tomcat's SSL configuration how-to</ulink>.
@@ -143,7 +143,7 @@
<sect1 id="configuration-hibdialect">
<title>Forcing the Database Dialect</title>
<para>
- This sections describes how to override the Database (DB) dialect settings. Under most circumstances, the auto-detect feature will work. If the Hibernate dialect is not working correctly, override the default behavior by following the instructions in this section.
+ This sections describes how to override the Database (DB) dialect settings. Under most circumstances, the auto-detect feature works. If the Hibernate dialect is not working correctly, override the default behavior by following the instructions in this section.
</para>
<sect2>
<title>Database Dialect Settings for JBoss Portal</title>
@@ -160,7 +160,7 @@
]]></screen>
</para>
<para>
- Note: this example is for a PostgreSQL database. If you use another database, you will need to modify <computeroutput>org.hibernate.dialect.PostgreSQLDialect</computeroutput> to reflect the correct database. For a list of supported dialects, refer to the <ulink url="http://www.hibernate.org/hib_docs/v3/reference/en/html/session-configurat...">dialects list on the Hibernate website</ulink>.
+ Note: this example is for a PostgreSQL database. If you use another database, you need to modify <computeroutput>org.hibernate.dialect.PostgreSQLDialect</computeroutput> to reflect the correct database. For a list of supported dialects, refer to the <ulink url="http://www.hibernate.org/hib_docs/v3/reference/en/html/session-configurat...">dialects list on the Hibernate website</ulink>.
</para>
</sect2>
<sect2>
@@ -189,7 +189,7 @@
</orderedlist>
</para>
<para>
- Note: this example is for a PostgreSQL database. If you use another database, you will need to modify <computeroutput>org.hibernate.dialect.PostgreSQLDialect</computeroutput> to reflect the correct database. For a list of supported dialects, refer to the <ulink url="http://www.hibernate.org/hib_docs/v3/reference/en/html/session-configurat...">dialects list on the Hibernate website</ulink>.
+ Note: this example is for a PostgreSQL database. If you use another database, you need to modify <computeroutput>org.hibernate.dialect.PostgreSQLDialect</computeroutput> to reflect the correct database. For a list of supported dialects, refer to the <ulink url="http://www.hibernate.org/hib_docs/v3/reference/en/html/session-configurat...">dialects list on the Hibernate website</ulink>.
</para>
</sect2>
</sect1>
@@ -252,12 +252,12 @@
</sect1>
<sect1>
<title>Configuring proxy settings</title>
- <para>There are a couple of scenarios where you will need your proxy to be correctly defined at the JVM
+ <para>There are a couple of scenarios where you need your proxy to be correctly defined at the JVM
level so that you can access documents from Internet. It could be to get the thirdparty libraries if you
decided to build JBoss Portal from the sources, to access RSS feeds or weather information in the samples
portlet we provide or for your own needs.</para>
- <para>To set up the proxy settings you will need to know the proxy host and the port to use then
- add them when starting java.</para>
+ <para>To configure the proxy settings, you need to know the proxy host and the port to use. Then,
+ add them when starting Java.</para>
<para>Usually setting up JAVA_OPTS environment variable to <literal>-Dhttp.proxyHost=YOUR_PROXY_HOST -Dhttp.proxyPort=YOUR_PROXY_PORT</literal>
is enough.</para>
</sect1>
Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/installation.xml
===================================================================
--- docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/installation.xml 2008-03-31 00:55:17 UTC (rev 10419)
+++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/installation.xml 2008-03-31 02:58:46 UTC (rev 10420)
@@ -72,7 +72,7 @@
</mediaobject>
</para>
<para>
- Files contained in this download will be used in later sections. Download and extract the JBoss Portal binary zip file before proceeding.
+ Files contained in this download are used in later sections. Download and extract the JBoss Portal binary zip file before proceeding.
</para>
</sect3>
<sect3>
@@ -98,7 +98,7 @@
<orderedlist>
<listitem>
<para>
- <emphasis role="bold">Create a new database:</emphasis> this guide assumes that the new database will be called <emphasis>jbossportal</emphasis>.
+ <emphasis role="bold">Create a new database:</emphasis> this guide assumes that the new database is called <emphasis>jbossportal</emphasis>.
</para>
</listitem>
<listitem>
@@ -259,7 +259,7 @@
</imageobject>
</mediaobject>
<para>
- If the source files were obtained from SVN, change into the <filename>trunk/src/</filename> directory to see the directories from the above image. As well, there will be an empty <filename>thirdparty</filename> directory. This directory will contain files after building the JBoss Portal source code (refer to <xref linkend="building_deploying_from_source" />). For more information about the JBoss Portal SVN repository, and accessing different versions of the JBoss Portal codebase, please visit the <ulink url="http://wiki.jboss.org/wiki/Wiki.jsp?page=PortalSVNRepo">JBoss Portal SVN Repo</ulink> page on the JBoss Wiki.
+ If the source files were obtained from SVN, change into the <filename>trunk/src/</filename> directory to see the directories from the above image. As well, there is an empty <filename>thirdparty</filename> directory. This directory contains files after building the JBoss Portal source code (refer to <xref linkend="building_deploying_from_source" />). For more information about the JBoss Portal SVN repository, and accessing different versions of the JBoss Portal codebase, please visit the <ulink url="http://wiki.jboss.org/wiki/Wiki.jsp?page=PortalSVNRepo">JBoss Portal SVN Repo</ulink> page on the JBoss Wiki.
</para>
</sect2>
<sect2>
@@ -298,7 +298,7 @@
<orderedlist>
<listitem>
<para>
- Add the following line to the <filename>~/.bashrc</filename> file. Note: this must be configured while logged in as the user who will run JBoss EAP or JBoss AS:
+ Add the following line to the <filename>~/.bashrc</filename> file. Note: this must be configured while logged in as the user who runs JBoss EAP or JBoss AS:
</para>
<para>
<screen>
@@ -329,7 +329,7 @@
<sect2 id="building_deploying_from_source">
<title>Building and Deploying from the Sources</title>
<para>
- During the first build, third-party libraries will be obtained from an online
+ During the first build, third-party libraries are obtained from an online
repository, so you must be connected to the Internet, and if you are behind a proxy server, you need to define your proxy server address and proxy server port number. If you are running Linux, add the following line to the <filename>$JBOSS_HOME/bin/run.sh</filename> file:
</para>
<para>
@@ -414,7 +414,7 @@
<orderedlist>
<listitem>
<para>
- <emphasis role="bold">Create a new database:</emphasis> this guide assumes that the new database will be called <emphasis>jbossportal</emphasis>.
+ <emphasis role="bold">Create a new database:</emphasis> this guide assumes that the new database is called <emphasis>jbossportal</emphasis>.
</para>
</listitem>
<listitem>
Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/migration.xml
===================================================================
--- docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/migration.xml 2008-03-31 00:55:17 UTC (rev 10419)
+++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/migration.xml 2008-03-31 02:58:46 UTC (rev 10420)
@@ -63,7 +63,7 @@
</mediaobject>
</para>
<para>
- If you use a default theme that exists in JBoss Portal 2.6, such as renaissance, no configuration should be necessary. Using old themes from JBoss Portal 2.4 may make JBoss Portal 2.6 unusable, for example, not being able to log in. To update custom themes, please refer to those bundled with JBoss Portal as an example.
+ If you use a default theme that exists in JBoss Portal 2.6, such as renaissance, no configuration shouldf be necessary. Using old themes from JBoss Portal 2.4 may make JBoss Portal 2.6 unusable, for example, not being able to log in. To update custom themes, please refer to those bundled with JBoss Portal as an example.
</para>
</sect2>
<sect2 id="upgrade_portal_database">
@@ -75,7 +75,7 @@
Database schema has not changed between the JBoss Portal 2.4 and 2.6 releases, but certain content that is kept in the databases has changed. Data can be updated manually by using the correct tools for your RDBMS. For example, if you are using a MySQL database, you can use the <ulink url="http://www.mysql.com/products/tools/query-browser/">MySQL Query Browser</ulink>.
</para>
<para>
- The following instructions refer to a standard JBoss Portal 2.4 deployment. If you named core portlets, portlet instances, or portlet windows differently, you will need to make the appropriate modifications. The following is an example of using the MySQL Query Browser:
+ The following instructions refer to a standard JBoss Portal 2.4 deployment. If you named core portlets, portlet instances, or portlet windows differently, you need to make the appropriate modifications. The following is an example of using the MySQL Query Browser:
</para>
<para>
<mediaobject>
Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/tutorials.xml
===================================================================
--- docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/tutorials.xml 2008-03-31 00:55:17 UTC (rev 10419)
+++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/tutorials.xml 2008-03-31 02:58:46 UTC (rev 10420)
@@ -22,7 +22,7 @@
<para>The JSR-168 Portlet Specification aims at defining portlets that can be used by any JSR-168 portlet container, also known as a portal. There are different portals with commercial and non-commercial licenses. This chapter gives a brief overview of the <ulink url="http://www.jcp.org/en/jsr/detail?id=168">JSR-168 Portlet Specification</ulink>. Portlet developers are strongly encouraged to read the <ulink url="http://www.jcp.org/en/jsr/detail?id=168">JSR-168 Portlet Specification</ulink>.
</para>
<para>
- JBoss Portal is fully JSR-168 compliant, which means any JSR-168 portlet will behave as it should inside the portal.
+ JBoss Portal is fully JSR-168 compliant, which means any JSR-168 portlet behaves as it should inside the portal.
</para>
<sect2>
<title>Portal Pages</title>
@@ -66,7 +66,7 @@
<sect2>
<title>Window States</title>
<para>
- Window states are an indicator of how much page real-estate a portlet will consume on any given page.
+ Window states are an indicator of how much page real-estate a portlet consumes on any given page.
The three states defined by the JSR-168 specification are:
</para>
<para>
@@ -317,7 +317,7 @@
<listitem>
<para>
The <computeroutput><supports></computeroutput> element allows you to declare all of the markup types that your portlet supports in the <literal>render</literal> method. This is accomplished via the
- <computeroutput><mime-type></computeroutput> element, which is required for every portlet. The declared MIME types must match the capability of the portlet. As well, it allows you to pair which modes and window states are supported for each markup type. All portlets must support the <computeroutput>view</computeroutput> portlet mode, so this does not have to be declared. Use the <computeroutput><mime-type></computeroutput> element to define which markup type your portlet supports, which in this example, is <computeroutput>text/html</computeroutput>. This section tells the portal that it will only output text and HTML, and that it only supports the <computeroutput>view</computeroutput> mode.
+ <computeroutput><mime-type></computeroutput> element, which is required for every portlet. The declared MIME types must match the capability of the portlet. As well, it allows you to pair which modes and window states are supported for each markup type. All portlets must support the <computeroutput>view</computeroutput> portlet mode, so this does not have to be declared. Use the <computeroutput><mime-type></computeroutput> element to define which markup type your portlet supports, which in this example, is <computeroutput>text/html</computeroutput>. This section tells the portal that it only outputs text and HTML, and that it only supports the <computeroutput>view</computeroutput> mode.
</para>
</listitem>
</varlistentry>
@@ -327,7 +327,7 @@
</portlet-info>]]></screen></term>
<listitem>
<para>
- When rendered, the portlet's title will be displayed as the header in the portlet window, unless it is overridden programmatically. In this example, the title would be <computeroutput>HelloWorld Portlet</computeroutput>.
+ When rendered, the portlet's title is displayed as the header in the portlet window, unless it is overridden programmatically. In this example, the title would be <computeroutput>HelloWorld Portlet</computeroutput>.
</para>
</listitem>
</varlistentry>
@@ -373,7 +373,7 @@
</listitem>
<listitem>
<para>
- specifies that the window will display the markup generated by the <computeroutput>HelloWorldPortletInstance</computeroutput> portlet instance.
+ specifies that the window displays the markup generated by the <computeroutput>HelloWorldPortletInstance</computeroutput> portlet instance.
</para>
</listitem>
<listitem>
@@ -383,7 +383,7 @@
</listitem>
<listitem>
<para>
- the <computeroutput><region></computeroutput> element specifies where the window will appear on the page.
+ the <computeroutput><region></computeroutput> element specifies where the window appears on the page.
</para>
</listitem>
</itemizedlist>
@@ -418,7 +418,7 @@
</screen></term>
<listitem>
<para>
- Tells the portal where this portlet will appear. In this case, <computeroutput>default.default</computeroutput> specifies that the portlet will appear in the portal instance named <computeroutput>default</computeroutput>, and on the page named <computeroutput>default</computeroutput>.
+ Tells the portal where this portlet appears. In this case, <computeroutput>default.default</computeroutput> specifies that the portlet appears in the portal instance named <computeroutput>default</computeroutput>, and on the page named <computeroutput>default</computeroutput>.
</para>
</listitem>
</varlistentry>
@@ -427,7 +427,7 @@
</screen></term>
<listitem>
<para>
- Instructs the portal to overwrite or keep this object if it already exists. Accepted values are <computeroutput>overwrite</computeroutput> and <computeroutput>keep</computeroutput>. The <computeroutput>overwrite</computeroutput> option will destroy the existing object and create a new one based on the content of the deployment. The <computeroutput>keep</computeroutput> option will maintain the existing object deployment, or create a new one if it does not exist.
+ Instructs the portal to overwrite or keep this object if it already exists. Accepted values are <computeroutput>overwrite</computeroutput> and <computeroutput>keep</computeroutput>. The <computeroutput>overwrite</computeroutput> option destroys the existing object, and creates a new one based on the content of the deployment. The <computeroutput>keep</computeroutput> option maintains the existing object deployment, or creates a new one if it does not exist.
</para>
</listitem>
</varlistentry>
@@ -456,7 +456,7 @@
</screen></term>
<listitem>
<para>
- Specifies where the window will appear within the page layout.
+ Specifies where the window appears within the page layout.
</para>
</listitem>
</varlistentry>
@@ -476,7 +476,7 @@
<para>
JBoss Portal 2.6 introduces the notion of <emphasis>content-type</emphasis>, which is a generic mechanism to
- specify what content will be displayed by a given portlet window. The <computeroutput>window</computeroutput> section
+ specify what content displayed by a given portlet window. The <computeroutput>window</computeroutput> section
of the previous example, <filename>HelloWorldPortlet/WEB-INF/helloworld-object.xml</filename>, can be re-written to take advantage of the new content framework. The following is an example deployment descriptor that uses the new content framework:
</para>
<para>
@@ -599,7 +599,7 @@
If you did not expand the <filename>helloworldportlet.war</filename> file, copy the <filename>HelloWorldPortlet/helloworldportlet.war</filename> file into the correct JBoss AS or JBoss EAP <filename>deploy/</filename> directory. If you expanded the <filename>helloworldportlet.war</filename> file, copy the <filename>HelloWorldPortlet/output/lib/exploded/helloworldportlet.war/</filename> directory into the correct JBoss AS or JBoss EAP <filename>deploy/</filename> directory. For example, if you are using JBoss AS, copy the WAR file or the expanded directory into the <filename>$JBOSS_HOME/server/default/deploy/</filename> directory.
</para>
<para>
- Performing this step on a running instance of JBoss AS or JBoss EAP, and JBoss Portal, will trigger a hot-deploy of the portlet:
+ Performing this step on a running instance of JBoss AS or JBoss EAP, and JBoss Portal, triggers a hot-deploy of the portlet:
</para>
<para>
<screen><![CDATA[
@@ -618,7 +618,7 @@
</mediaobject>
</para>
<para>
- To re-deploy the portlet, for example, if you have made changes to any of the application descriptors, touch the <filename>$JBOSS_HOME/server/<replaceable>configuration</replaceable>/deploy/helloworldportlet.war/WEB-INF/web.xml</filename> file. This will only work if you copied the <filename>HelloWorldPortlet/output/lib/exploded/helloworldportlet.war/</filename> directory into the JBoss AS or JBoss EAP <filename>deploy/</filename> directory. On Linux, run the following command to re-deploy the HelloWorldPortlet:
+ To re-deploy the portlet, for example, if you have made changes to any of the application descriptors, touch the <filename>$JBOSS_HOME/server/<replaceable>configuration</replaceable>/deploy/helloworldportlet.war/WEB-INF/web.xml</filename> file. This only works if you copied the <filename>HelloWorldPortlet/output/lib/exploded/helloworldportlet.war/</filename> directory into the JBoss AS or JBoss EAP <filename>deploy/</filename> directory. On Linux, run the following command to re-deploy the HelloWorldPortlet:
</para>
<para>
<screen>
@@ -626,7 +626,7 @@
</screen>
</para>
<para>
- Re-deploying the HelloWorldPortlet will produce output to the JBoss AS or JBoss EAP console, similar to the following:
+ Re-deploying the HelloWorldPortlet produces output to the JBoss AS or JBoss EAP console, similar to the following:
</para>
<para>
<screen><![CDATA[
@@ -749,7 +749,7 @@
</screen></term>
<listitem>
<para>
- Support for these modes must be declared in the <filename>HelloWorldJSPPortlet/WEB-INF/portlet.xml</filename> file. They will be triggered when a user clicks on the respective icons in the portlet window titlebar, or through generated links within the portlet.
+ Support for these modes must be declared in the <filename>HelloWorldJSPPortlet/WEB-INF/portlet.xml</filename> file. They are triggered when a user clicks on the respective icons in the portlet window titlebar, or through generated links within the portlet.
</para>
</listitem>
</varlistentry>
@@ -775,7 +775,7 @@
</screen></term>
<listitem>
<para>
- As in the servlet world, you must declare what content-type the portlet will be responding in. Do this before starting to write content, or the portlet will throw an exception.
+ As in the servlet world, you must declare what content-type the portlet will be responding in. Do this before starting to write content, or the portlet throws an exception.
</para>
</listitem>
</varlistentry>
@@ -955,7 +955,7 @@
If you did not expand the <filename>helloworldjspportlet.war</filename> file, copy the <filename>HelloWorldJSPPortlet/helloworldjspportlet.war</filename> file into the correct JBoss AS or JBoss EAP <filename>deploy/</filename> directory. If you expanded the <filename>helloworldjspportlet.war</filename> file, copy the <filename>HelloWorldJSPPortlet/output/lib/exploded/helloworldjspportlet.war/</filename> directory into the correct JBoss AS or JBoss EAP <filename>deploy/</filename> directory. For example, if you are using JBoss AS, copy the WAR file or the expanded directory into the <filename>$JBOSS_HOME/server/default/deploy/</filename> directory.
</para>
<para>
- Performing this step on a running instance of JBoss AS or JBoss EAP, and JBoss Portal, will trigger a hot-deploy of the portlet:
+ Performing this step on a running instance of JBoss AS or JBoss EAP, and JBoss Portal, triggers a hot-deploy of the portlet:
</para>
<para>
<screen><![CDATA[
@@ -974,7 +974,7 @@
</mediaobject>
</para>
<para>
- To re-deploy the portlet, for example, if you have made changes to any of the application descriptors, touch the <filename>$JBOSS_HOME/server/<replaceable>configuration</replaceable>/deploy/helloworldjspportlet.war/WEB-INF/web.xml</filename> file. This will only work if you copied the <filename>HelloWorldJSPPortlet/output/lib/exploded/helloworldjspportlet.war/</filename> directory into the JBoss AS or JBoss EAP <filename>deploy/</filename> directory. On Linux, run the following command to re-deploy the HelloWorldJSPPortlet:
+ To re-deploy the portlet, for example, if you have made changes to any of the application descriptors, touch the <filename>$JBOSS_HOME/server/<replaceable>configuration</replaceable>/deploy/helloworldjspportlet.war/WEB-INF/web.xml</filename> file. This only works if you copied the <filename>HelloWorldJSPPortlet/output/lib/exploded/helloworldjspportlet.war/</filename> directory into the JBoss AS or JBoss EAP <filename>deploy/</filename> directory. On Linux, run the following command to re-deploy the HelloWorldJSPPortlet:
</para>
<para>
<screen>
@@ -982,7 +982,7 @@
</screen>
</para>
<para>
- Re-deploying the HelloWorldJSPPortlet will produce output to the JBoss AS or JBoss EAP console, similar to the following:
+ Re-deploying the HelloWorldJSPPortlet produces output to the JBoss AS or JBoss EAP console, similar to the following:
</para>
<para>
<screen><![CDATA[
@@ -1092,7 +1092,7 @@
<listitem>
<para>
The <computeroutput><supports></computeroutput> element allows you to declare all of the markup types that your portlet supports in the <literal>render</literal> method. This is accomplished via the
- <computeroutput><mime-type></computeroutput> element, which is required for every portlet. The declared MIME types must match the capability of the portlet. As well, it allows you to pair which modes and window states are supported for each markup type. All portlets must support the <computeroutput>view</computeroutput> portlet mode, so this does not have to be declared. Use the <computeroutput><mime-type></computeroutput> element to define which markup type your portlet supports, which in this example, is <computeroutput>text/html</computeroutput>. This section tells the portal that it will only output text and HTML, and that it only supports the <computeroutput>view</computeroutput> mode.
+ <computeroutput><mime-type></computeroutput> element, which is required for every portlet. The declared MIME types must match the capability of the portlet. As well, it allows you to pair which modes and window states are supported for each markup type. All portlets must support the <computeroutput>view</computeroutput> portlet mode, so this does not have to be declared. Use the <computeroutput><mime-type></computeroutput> element to define which markup type your portlet supports, which in this example, is <computeroutput>text/html</computeroutput>. This section tells the portal that it only outputs text and HTML, and that it only supports the <computeroutput>view</computeroutput> mode.
</para>
</listitem>
</varlistentry>
@@ -1238,7 +1238,7 @@
If you did not expand the <filename>helloworldjsfsunriportlet.war</filename> file, copy the <filename>HelloWorldJSFSunRIPortlet/helloworldjsfsunriportlet.war</filename> file into the correct JBoss AS or JBoss EAP <filename>deploy/</filename> directory. If you expanded the <filename>helloworldjsfsunriportlet.war</filename> file, copy the <filename>HelloWorldJSFSunRIPortlet/output/lib/exploded/helloworldjsfsunriportlet.war/</filename> directory into the correct JBoss AS or JBoss EAP <filename>deploy/</filename> directory. For example, if you are using JBoss AS, copy the WAR file or the expanded directory into the <filename>$JBOSS_HOME/server/default/deploy/</filename> directory.
</para>
<para>
- Performing this step on a running instance of JBoss AS or JBoss EAP, and JBoss Portal, will trigger a hot-deploy of the portlet:
+ Performing this step on a running instance of JBoss AS or JBoss EAP, and JBoss Portal, triggers a hot-deploy of the portlet:
</para>
<para>
<screen><![CDATA[
@@ -1257,7 +1257,7 @@
</mediaobject>
</para>
<para>
- To re-deploy the portlet, for example, if you have made changes to any of the application descriptors, touch the <filename>$JBOSS_HOME/server/<replaceable>configuration</replaceable>/deploy/helloworldjsfsunriportlet.war/WEB-INF/web.xml</filename> file. This will only work if you copied the <filename>HelloWorldJSFSunRIPortlet/output/lib/exploded/helloworldjsfsunriportlet.war/</filename> directory into the JBoss AS or JBoss EAP <filename>deploy/</filename> directory. On Linux, run the following command to re-deploy the HelloWorldJSFSunRIPortlet:
+ To re-deploy the portlet, for example, if you have made changes to any of the application descriptors, touch the <filename>$JBOSS_HOME/server/<replaceable>configuration</replaceable>/deploy/helloworldjsfsunriportlet.war/WEB-INF/web.xml</filename> file. This only works if you copied the <filename>HelloWorldJSFSunRIPortlet/output/lib/exploded/helloworldjsfsunriportlet.war/</filename> directory into the JBoss AS or JBoss EAP <filename>deploy/</filename> directory. On Linux, run the following command to re-deploy the HelloWorldJSFSunRIPortlet:
</para>
<para>
<screen>
@@ -1265,7 +1265,7 @@
</screen>
</para>
<para>
- Re-deploying the HelloWorldJSFSunRIPortlet will produce output to the JBoss AS or JBoss EAP console, similar to the following:
+ Re-deploying the HelloWorldJSFSunRIPortlet produces output to the JBoss AS or JBoss EAP console, similar to the following:
</para>
<para>
<screen><![CDATA[
@@ -1330,7 +1330,7 @@
This section describes how to deploy a JSF portlet in JBoss Portal, using the Apache MyFaces JSF implementation in JBoss AS and JBoss EAP. Before proceeding, download the <ulink url="http://anonsvn.jboss.org/repos/portletswap/portlets/2_6/bundles/HelloWorl...">HelloWorldJSFMyFaces42Portlet</ulink> from <ulink url="http://labs.jboss.com/portletswap/">JBoss PortletSwap</ulink>.
</para>
<para>
- Apache MyFaces can be used globally for the entire server, replacing the Sun JSF RI libraries, but the HelloWorldJSFMyFaces42Portlet uses its own libraries, and will not affect the application server.
+ Apache MyFaces can be used globally for the entire server, replacing the Sun JSF RI libraries, but the HelloWorldJSFMyFaces42Portlet uses its own libraries, but does not affect the application server.
</para>
</sect3>
<sect3>
@@ -1414,7 +1414,7 @@
<listitem>
<para>
The <computeroutput><supports></computeroutput> element allows you to declare all of the markup types that your portlet supports in the <literal>render</literal> method. This is accomplished via the
- <computeroutput><mime-type></computeroutput> element, which is required for every portlet. The declared MIME types must match the capability of the portlet. As well, it allows you to pair which modes and window states are supported for each markup type. All portlets must support the <computeroutput>view</computeroutput> portlet mode, so this does not have to be declared. Use the <computeroutput><mime-type></computeroutput> element to define which markup type your portlet supports, which in this example, is <computeroutput>text/html</computeroutput>. This section tells the portal that it will only output text and HTML, and that it only supports the <computeroutput>view</computeroutput> mode.
+ <computeroutput><mime-type></computeroutput> element, which is required for every portlet. The declared MIME types must match the capability of the portlet. As well, it allows you to pair which modes and window states are supported for each markup type. All portlets must support the <computeroutput>view</computeroutput> portlet mode, so this does not have to be declared. Use the <computeroutput><mime-type></computeroutput> element to define which markup type your portlet supports, which in this example, is <computeroutput>text/html</computeroutput>. This section tells the portal that it only outputs text and HTML, and that it only supports the <computeroutput>view</computeroutput> mode.
</para>
</listitem>
</varlistentry>
@@ -1543,7 +1543,7 @@
If you did not expand the <filename>helloworldjsfmyfacesportlet.war</filename> file, copy the <filename>HelloWorldJSFMyFaces42Portlet/helloworldjsfmyfacesportlet.war</filename> file into the correct JBoss AS or JBoss EAP <filename>deploy/</filename> directory. If you expanded the <filename>helloworldjsfmyfacesportlet.war</filename> file, copy the <filename>HelloWorldJSFMyFaces42Portlet/output/lib/exploded/helloworldjsfmyfacesportlet.war/</filename> directory into the correct JBoss AS or JBoss EAP <filename>deploy/</filename> directory. For example, if you are using JBoss AS, copy the WAR file or the expanded directory into the <filename>$JBOSS_HOME/server/default/deploy/</filename> directory.
</para>
<para>
- Performing this step on a running instance of JBoss AS or JBoss EAP, and JBoss Portal, will trigger a hot-deploy of the portlet.
+ Performing this step on a running instance of JBoss AS or JBoss EAP, and JBoss Portal, triggers a hot-deploy of the portlet.
</para><para>
To see the HelloWorldJSFMyFaces42Portlet, navigate to <ulink url="http://localhost:8080/portal/"></ulink>, or, if the default JBoss Portal page is already open, refresh the page. The HelloWorldJSFMyFaces42Portlet is added to the bottom of the default JBoss Portal page:
</para>
@@ -1555,7 +1555,7 @@
</mediaobject>
</para>
<para>
- To re-deploy the portlet, for example, if you have made changes to any of the application descriptors, touch the <filename>$JBOSS_HOME/server/<replaceable>configuration</replaceable>/deploy/helloworldjsfmyfacesportlet.war/WEB-INF/web.xml</filename> file. This will only work if you copied the <filename>HelloWorldJSFMyFaces42Portlet/output/lib/exploded/helloworldjsfmyfacesportlet.war/</filename> directory into the JBoss AS or JBoss EAP <filename>deploy/</filename> directory. On Linux, run the following command to re-deploy the HelloWorldJSFMyFaces42Portlet:
+ To re-deploy the portlet, for example, if you have made changes to any of the application descriptors, touch the <filename>$JBOSS_HOME/server/<replaceable>configuration</replaceable>/deploy/helloworldjsfmyfacesportlet.war/WEB-INF/web.xml</filename> file. This only works if you copied the <filename>HelloWorldJSFMyFaces42Portlet/output/lib/exploded/helloworldjsfmyfacesportlet.war/</filename> directory into the JBoss AS or JBoss EAP <filename>deploy/</filename> directory. On Linux, run the following command to re-deploy the HelloWorldJSFMyFaces42Portlet:
</para>
<para>
<screen>
Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml
===================================================================
--- docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml 2008-03-31 00:55:17 UTC (rev 10419)
+++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml 2008-03-31 02:58:46 UTC (rev 10420)
@@ -24,7 +24,7 @@
</screen>
</para>
<para>
- If you do not use the DTD declaration, the previous mechanism for XML validation is used. The DTD is more strict, specifically with the order of XML elements. The following is an example from a <filename>*-object.xml</filename> descriptor, which is valid if you are not using the DTD, but will be rejected if you are:
+ If you do not use the DTD declaration, the previous mechanism for XML validation is used. The DTD is more strict, specifically with the order of XML elements. The following is an example from a <filename>*-object.xml</filename> descriptor, which is valid if you are not using the DTD, but is rejected if you are:
</para>
<para>
<screen><![CDATA[
@@ -103,7 +103,7 @@
</para>
<para>
The <computeroutput><trans-attribute></computeroutput> element specifies the behavior of the portlet when it is invoked at runtime with respect to the transactional context. Depending on how the portlet is
- invoked, a transaction may or may not exist before the portlet is invoked. The portal transaction is usually present in the local context. The default value is <computeroutput>NotSupported</computeroutput>, which means that the portal transaction will be suspended for the duration of the portlet's invocation. Accepted values are <computeroutput>Required</computeroutput>, <computeroutput>Mandatory</computeroutput>, <computeroutput>Never</computeroutput>, <computeroutput>Supports</computeroutput>, <computeroutput>NotSupported</computeroutput>, and <computeroutput>RequiresNew</computeroutput>.
+ invoked, a transaction may or may not exist before the portlet is invoked. The portal transaction is usually present in the local context. The default value is <computeroutput>NotSupported</computeroutput>, which means that the portal transaction is suspended for the duration of the portlet's invocation. Accepted values are <computeroutput>Required</computeroutput>, <computeroutput>Mandatory</computeroutput>, <computeroutput>Never</computeroutput>, <computeroutput>Supports</computeroutput>, <computeroutput>NotSupported</computeroutput>, and <computeroutput>RequiresNew</computeroutput>.
</para>
<para>
The following is an example section from a <filename>WEB-INF/portlet.xml</filename> file, which uses the <computeroutput><portlet-name></computeroutput>, <computeroutput><remotable></computeroutput>, and <computeroutput><trans-attribute></computeroutput> elements:
@@ -203,7 +203,7 @@
</screen>
</para>
<para>
- The default value is <computeroutput>NotSupported</computeroutput>, which means that the portal transaction will be suspended for the duration of the portlet's invocation. Accepted values are <computeroutput>Required</computeroutput>, <computeroutput>Mandatory</computeroutput>, <computeroutput>Never</computeroutput>, <computeroutput>Supports</computeroutput>, <computeroutput>NotSupported</computeroutput>, and <computeroutput>RequiresNew</computeroutput>.
+ The default value is <computeroutput>NotSupported</computeroutput>, which means that the portal transaction is suspended for the duration of the portlet's invocation. Accepted values are <computeroutput>Required</computeroutput>, <computeroutput>Mandatory</computeroutput>, <computeroutput>Never</computeroutput>, <computeroutput>Supports</computeroutput>, <computeroutput>NotSupported</computeroutput>, and <computeroutput>RequiresNew</computeroutput>.
</para>
</listitem>
</varlistentry>
@@ -327,7 +327,7 @@
</screen>
</para>
<para>
- The <computeroutput><if-exists></computeroutput> element is used to define the action to take if an instance with the same name already exists. Accepted values are <computeroutput>overwrite</computeroutput> and <computeroutput>keep</computeroutput>. The <computeroutput>overwrite</computeroutput> option will destroy the existing object and create a new one based on the content of the deployment. The <computeroutput>keep</computeroutput> option will maintain the existing object deployment, or create a new one if it does not exist.
+ The <computeroutput><if-exists></computeroutput> element is used to define the action to take if an instance with the same name already exists. Accepted values are <computeroutput>overwrite</computeroutput> and <computeroutput>keep</computeroutput>. The <computeroutput>overwrite</computeroutput> option destroys the existing object and create a new one based on the content of the deployment. The <computeroutput>keep</computeroutput> option maintains the existing object deployment, or creates a new one if it does not exist.
</para>
</listitem>
</varlistentry>
@@ -568,7 +568,7 @@
</screen>
</para>
<para>
- The <computeroutput><parent-ref></computeroutput> element contains a reference to the parent object. The naming convention for naming objects is to concatenate the names of the path to the object, and separate the names using a period. If the path is empty, the empty string must be used. The <computeroutput><parent-ref></computeroutput> element tells the portal where the portlet will appear. The syntax for the <computeroutput><parent-ref></computeroutput> element is <computeroutput><replaceable>portal-instance</replaceable>.<replaceable>portal-page</replaceable></computeroutput>.
+ The <computeroutput><parent-ref></computeroutput> element contains a reference to the parent object. The naming convention for naming objects is to concatenate the names of the path to the object, and separate the names using a period. If the path is empty, the empty string must be used. The <computeroutput><parent-ref></computeroutput> element tells the portal where the portlet appears. The syntax for the <computeroutput><parent-ref></computeroutput> element is <computeroutput><replaceable>portal-instance</replaceable>.<replaceable>portal-page</replaceable></computeroutput>.
</para>
<para>
The following is an example of the root having an empty path:
@@ -579,7 +579,7 @@
</screen>
</para>
<para>
- The following specifies that the portlet will appear in the portal instance named <computeroutput>default</computeroutput>:
+ The following specifies that the portlet appears in the portal instance named <computeroutput>default</computeroutput>:
</para>
<para>
<screen>
@@ -587,7 +587,7 @@
</screen>
</para>
<para>
- The following specifies that the portlet will appear in the portal instance named <computeroutput>default</computeroutput>, and on the page named <computeroutput>default</computeroutput>:
+ The following specifies that the portlet appear in the portal instance named <computeroutput>default</computeroutput>, and on the page named <computeroutput>default</computeroutput>:
</para>
<para>
<screen>
@@ -600,7 +600,7 @@
</screen>
</para>
<para>
- The <computeroutput><if-exists></computeroutput> element is used to define the action to take if an instance with the same name already exists. Accepted values are <computeroutput>overwrite</computeroutput> and <computeroutput>keep</computeroutput>. The <computeroutput>overwrite</computeroutput> option will destroy the existing object and create a new one based on the content of the deployment. The <computeroutput>keep</computeroutput> option will maintain the existing object deployment, or create a new one if it does not exist.
+ The <computeroutput><if-exists></computeroutput> element is used to define the action to take if an instance with the same name already exists. Accepted values are <computeroutput>overwrite</computeroutput> and <computeroutput>keep</computeroutput>. The <computeroutput>overwrite</computeroutput> option destroys the existing object, and creates a new one based on the content of the deployment. The <computeroutput>keep</computeroutput> option matains the existing object deployment, or creates a new one if it does not exist.
</para>
</listitem>
</varlistentry>
@@ -665,7 +665,7 @@
</screen></term>
<listitem>
<para>
- The portlet mode value. If there are no declarations of modes or window states, the default values will be <computeroutput>view</computeroutput>, <computeroutput>edit</computeroutput>, <computeroutput>help</computeroutput>, and <computeroutput>normal</computeroutput>, <computeroutput>minimized</computeroutput>, <computeroutput>maximized</computeroutput>, respectively.
+ The portlet mode value. If there are no declarations of modes or window states, the default values are <computeroutput>view</computeroutput>, <computeroutput>edit</computeroutput>, <computeroutput>help</computeroutput>, and <computeroutput>normal</computeroutput>, <computeroutput>minimized</computeroutput>, <computeroutput>maximized</computeroutput>, respectively.
</para>
</listitem>
</varlistentry>
@@ -751,7 +751,7 @@
</screen>
</para>
<para>
- The region the window belongs to. The <computeroutput><region></computeroutput> element specifies where the window will appear on the page.
+ The region the window belongs to. The <computeroutput><region></computeroutput> element specifies where the window appears on the page.
</para>
<para>
<screen><![CDATA[
@@ -923,7 +923,7 @@
</screen>
</para>
<para>
- The <computeroutput><role-name></computeroutput> element is used to define a role that the security constraint will apply to. The following example only allows users that are part of the <computeroutput>EXAMPLEROLE</computeroutput> role to access the instance:
+ The <computeroutput><role-name></computeroutput> element defines a role that the security constraint applies to. The following example only allows users that are part of the <computeroutput>EXAMPLEROLE</computeroutput> role to access the instance:
</para>
<para>
<screen><![CDATA[
@@ -1003,7 +1003,7 @@
<listitem>
<para>
<programlisting><![CDATA[<deployments>...</deployments>]]></programlisting>
- The <computeroutput><deployments></computeroutput> element encapsulates the entire document, and is a container for the <computeroutput><deployment></computeroutput> element. Multiple deployments can be specified within the <computeroutput><deployments></computeroutput> tag.
+ The <computeroutput><deployments></computeroutput> element encapsulates the entire document, and is a container for <computeroutput><deployment></computeroutput> elements. Multiple deployments can be specified within the <computeroutput><deployments></computeroutput> element.
</para>
</listitem>
<listitem>
@@ -1011,7 +1011,7 @@
<programlisting><![CDATA[<deployment>...</deployment>]]></programlisting>
</para>
<para>
- The <computeroutput><deployment></computeroutput> element is used to specify object deployments, such as portals, pages, windows, and so on.
+ The <computeroutput><deployment></computeroutput> element specifies object deployments, such as portals, pages, windows, and so on.
</para>
</listitem>
<listitem>
@@ -1019,7 +1019,7 @@
<programlisting><![CDATA[<if-exists>...</if-exists>]]></programlisting>
</para>
<para>
- The <computeroutput><if-exists></computeroutput> element is used to define the action to take if an instance with the same name already exists. Accepted values are <computeroutput>overwrite</computeroutput> and <computeroutput>keep</computeroutput>. The <computeroutput>overwrite</computeroutput> option will destroy the existing object and create a new one based on the content of the deployment. The <computeroutput>keep</computeroutput> option will maintain the existing object deployment, or create a new one if it does not exist.
+ The <computeroutput><if-exists></computeroutput> element defines the action to take if an instance with the same name already exists. Accepted values are <computeroutput>overwrite</computeroutput> and <computeroutput>keep</computeroutput>. The <computeroutput>overwrite</computeroutput> option destroys the existing object, and creates a new one based on the content of the deployment. The <computeroutput>keep</computeroutput> option maintains the existing object deployment, or creates a new one if it does not exist.
</para>
</listitem>
<listitem>
@@ -1027,10 +1027,10 @@
<programlisting><![CDATA[<parent-ref>...</parent-ref>]]></programlisting>
</para>
<para>
- The <computeroutput><parent-ref></computeroutput> element contains a reference to the parent object. The naming convention for naming objects is to concatenate the names of the path to the object, and separate the names using a period. If the path is empty, the empty string must be used. The <computeroutput><parent-ref></computeroutput> element tells the portal where the portlet will appear. The syntax for the <computeroutput><parent-ref></computeroutput> element is <computeroutput><replaceable>portal-instance</replaceable>.<replaceable>portal-page</replaceable></computeroutput>.
+ The <computeroutput><parent-ref></computeroutput> element contains a reference to the parent object. The naming convention for naming objects is to concatenate the names of the path to the object, and separate the names using a period. If the path is empty, the empty string must be used. The <computeroutput><parent-ref></computeroutput> element tells the portal where the portlet appears. The syntax for the <computeroutput><parent-ref></computeroutput> element is <computeroutput><replaceable>portal-instance</replaceable>.<replaceable>portal-page</replaceable></computeroutput>.
</para>
<para>
- In the example above, a window is defined, and assigned to <computeroutput>default.default</computeroutput>. This means the window will appear on the <computeroutput>default</computeroutput> page, in the <computeroutput>default</computeroutput> portal.
+ In the example above, a window is defined, and assigned to <computeroutput>default.default</computeroutput>. This means the window appears on the <computeroutput>default</computeroutput> page, in the <computeroutput>default</computeroutput> portal.
</para>
</listitem>
<listitem>
@@ -1038,7 +1038,7 @@
<programlisting><![CDATA[<window>...</window>]]></programlisting>
</para>
<para>
- The <computeroutput><window></computeroutput> element defines a portlet window. The <computeroutput><window></computeroutput> element requires an <computeroutput><instance-ref></computeroutput> element, which is used to assign a portal instance to a window. As well, use the <computeroutput><region></computeroutput> and <computeroutput><height></computeroutput> elements to define where the window will appear within the portlet.
+ The <computeroutput><window></computeroutput> element defines a portlet window. The <computeroutput><window></computeroutput> element requires an <computeroutput><instance-ref></computeroutput> element, which is used to assign a portal instance to a window. As well, use the <computeroutput><region></computeroutput> and <computeroutput><height></computeroutput> elements to define where the window appears within the portlet.
</para>
</listitem>
<listitem>
16 years, 1 month