[gatein-commits] gatein SVN: r4831 - in epp/docs/branches/EPP_5_1_Branch: Reference_Guide/en-US and 9 other directories.

Author: smumford Date: 2010-10-26 02:37:47 -0400 (Tue, 26 Oct 2010) New Revision: 4831 Added: epp/docs/branches/EPP_5_1_Branch/Site_Publisher_User_Guide/en-US/User_Guide.ent epp/docs/branches/EPP_5_1_Branch/Site_Publisher_User_Guide/en-US/User_Guide.xml Removed: epp/docs/branches/EPP_5_1_Branch/Site_Publisher_User_Guide/en-US/Site_Publisher_User_Guide.ent epp/docs/branches/EPP_5_1_Branch/Site_Publisher_User_Guide/en-US/Site_Publisher_User_Guide.xml Modified: epp/docs/branches/EPP_5_1_Branch/Installation_Guide/en-US/Book_Info.xml epp/docs/branches/EPP_5_1_Branch/Installation_Guide/en-US/Revision_History.xml epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/Book_Info.xml epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/Revision_History.xml epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/extras/PortalDevelopment_InternationalizationConfiguration/default148.java epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/extras/PortalDevelopment_RTLFramework/default176.java epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/extras/PortalDevelopment_Skinning/default190.java epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortalDevelopment/DefaultPortalNavigationConfiguration.xml epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortalDevelopment/InternationalizationConfiguration.xml epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortalDevelopment/JavascriptInterApplicationCommunication.xml epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortalDevelopment/RTLFramework.xml epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortalDevelopment/Skinning.xml epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortletDevelopment/PortletBridge/configuration.xml epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortletDevelopment/PortletBridge/gettingstarted.xml epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortletDevelopment/PortletBridge/portlet_development.xml epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortletDevelopment/Standard.xml epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Book_Info.xml epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Release_Notes.xml epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Revision_History.xml epp/docs/branches/EPP_5_1_Branch/Site_Publisher_User_Guide/en-US/Book_Info.xml epp/docs/branches/EPP_5_1_Branch/User_Guide/en-US/Book_Info.xml epp/docs/branches/EPP_5_1_Branch/User_Guide/en-US/Revision_History.xml Log: Minor changes and version updates Modified: epp/docs/branches/EPP_5_1_Branch/Installation_Guide/en-US/Book_Info.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Installation_Guide/en-US/Book_Info.xml 2010-10-26 04:48:15 UTC (rev 4830) +++ epp/docs/branches/EPP_5_1_Branch/Installation_Guide/en-US/Book_Info.xml 2010-10-26 06:37:47 UTC (rev 4831) @@ -11,8 +11,8 @@ <subtitle>An Installation Guide for &PRODUCT;</subtitle> <productname>JBoss Enterprise Portal Platform</productname> <productnumber>5</productnumber> - <edition>1.6</edition> - <pubsnumber>0</pubsnumber> + <edition>1.7</edition> + <pubsnumber>1</pubsnumber> <abstract> <para> This book provides information about obtaining, installing and Modified: epp/docs/branches/EPP_5_1_Branch/Installation_Guide/en-US/Revision_History.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Installation_Guide/en-US/Revision_History.xml 2010-10-26 04:48:15 UTC (rev 4830) +++ epp/docs/branches/EPP_5_1_Branch/Installation_Guide/en-US/Revision_History.xml 2010-10-26 06:37:47 UTC (rev 4831) @@ -9,7 +9,21 @@ <simpara> <revhistory> <revision> - <revnumber>1.6</revnumber> + <revnumber>1-1.7</revnumber> + <date>Tue Oct 26 2010</date> + <author> + <firstname>Scott</firstname> + <surname>Mumford</surname> + <email&gt;smumford(a)redhat.com&lt;/email&gt; + </author> + <revdescription> + <simplelist> + <member>Rebuilt for new Publican version features.</member> + </simplelist> + </revdescription> + </revision> + <revision> + <revnumber>1-1.6</revnumber> <date>Thu Sep 30 2010</date> <author> <firstname>Scott</firstname> @@ -23,7 +37,7 @@ </revdescription> </revision> <revision> - <revnumber>1.3</revnumber> + <revnumber>1-1.3</revnumber> <date>Tue Apr 28 2010</date> <author> <firstname>Luc</firstname> @@ -37,7 +51,7 @@ </revdescription> </revision> <revision> - <revnumber>1.2</revnumber> + <revnumber>1-1.2</revnumber> <date>Tue Apr 13 2010</date> <author> <firstname>Ben</firstname> @@ -52,7 +66,7 @@ </revision> <revision> - <revnumber>1.1</revnumber> + <revnumber>1-1.1</revnumber> <date>Tue Nov 24 2009</date> <author> <firstname>Scott</firstname> Modified: epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/Book_Info.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/Book_Info.xml 2010-10-26 04:48:15 UTC (rev 4830) +++ epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/Book_Info.xml 2010-10-26 06:37:47 UTC (rev 4831) @@ -9,7 +9,7 @@ <productname>JBoss Enterprise Portal Platform</productname> <productnumber>5</productnumber> <edition>1</edition> - <pubsnumber>1.11</pubsnumber> + <pubsnumber>1.12</pubsnumber> <abstract> <para> This Reference Guide is a high-level usage document. It deals with more advanced topics than the Installation and User Guides, adding new content or taking concepts discussed in the earlier documents further. It aims to provide supporting documentation for advanced users of the &PRODUCT; product. Its primary focus is on advanced use of the product and it assumes an intermediate or advanced knowledge of the technology and terms. Modified: epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/Revision_History.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/Revision_History.xml 2010-10-26 04:48:15 UTC (rev 4830) +++ epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/Revision_History.xml 2010-10-26 06:37:47 UTC (rev 4831) @@ -7,8 +7,22 @@ <title>Revision History</title> <simpara> <revhistory> + <revision> + <revnumber>1-1.12</revnumber> + <date>Tue Oct 26 2010</date> + <author> + <firstname>Scott</firstname> + <surname>Mumford</surname> + <email&gt;smumford(a)redhat.com&lt;/email&gt; + </author> + <revdescription> + <simplelist> + <member>Rebuilt to utilize new Publican branding (includes some minor typographical and grammatical error corrections).</member> + </simplelist> + </revdescription> + </revision> <revision> - <revnumber>1.11</revnumber> + <revnumber>1-1.11</revnumber> <date>Thu Sep 30 2010</date> <author> <firstname>Scott</firstname> @@ -22,7 +36,7 @@ </revdescription> </revision> <revision> - <revnumber>1.10</revnumber> + <revnumber>1-1.10</revnumber> <date>Thu Sep 23 2010</date> <author> <firstname>Scott</firstname> @@ -36,7 +50,7 @@ </revdescription> </revision> <revision> - <revnumber>1.9</revnumber> + <revnumber>1-1.9</revnumber> <date>Wed Sep 15 2010</date> <author> <firstname>Scott</firstname> @@ -50,7 +64,7 @@ </revdescription> </revision> <revision> - <revnumber>1.8</revnumber> + <revnumber>1-1.8</revnumber> <date>Fri Aug 27 2010</date> <author> <firstname>Scott</firstname> @@ -64,7 +78,7 @@ </revdescription> </revision> <revision> - <revnumber>1.7</revnumber> + <revnumber>1-1.7</revnumber> <date>Mon Aug 9 2010</date> <author> <firstname>Scott</firstname> @@ -78,7 +92,7 @@ </revdescription> </revision> <revision> - <revnumber>1.6</revnumber> + <revnumber>1-1.6</revnumber> <date>Thu Aug 5 2010</date> <author> <firstname>Scott</firstname> @@ -92,7 +106,7 @@ </revdescription> </revision> <revision> - <revnumber>1.5</revnumber> + <revnumber>1-1.5</revnumber> <date>Thu Jul 29 2010</date> <author> <firstname>Scott</firstname> @@ -106,7 +120,7 @@ </revdescription> </revision> <revision> - <revnumber>1.1</revnumber> + <revnumber>1-1.1</revnumber> <date>Sat Mar 20 2010</date> <author> <firstname>Scott</firstname> @@ -120,7 +134,7 @@ </revdescription> </revision> <revision> - <revnumber>1</revnumber> + <revnumber>1-1.1</revnumber> <date>Mon Feb 15 2010</date> <author> <firstname>Scott</firstname> @@ -134,7 +148,7 @@ </revdescription> </revision> <revision> - <revnumber>0</revnumber> + <revnumber>1-1.0</revnumber> <date>Wed Nov 11 2009</date> <author> <firstname>Scott</firstname> Modified: epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/extras/PortalDevelopment_InternationalizationConfiguration/default148.java =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/extras/PortalDevelopment_InternationalizationConfiguration/default148.java 2010-10-26 04:48:15 UTC (rev 4830) +++ epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/extras/PortalDevelopment_InternationalizationConfiguration/default148.java 2010-10-26 06:37:47 UTC (rev 4831) @@ -1 +1 @@ -javax.portlet.title=Portlet Navigation +javax.portlet.title=Portlet de Navegaci\u00f3n \ No newline at end of file Modified: epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/extras/PortalDevelopment_RTLFramework/default176.java =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/extras/PortalDevelopment_RTLFramework/default176.java 2010-10-26 04:48:15 UTC (rev 4830) +++ epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/extras/PortalDevelopment_RTLFramework/default176.java 2010-10-26 06:37:47 UTC (rev 4831) @@ -1,4 +1,4 @@ color: white; line-height: 24px; padding: 0px 5px 0px 0px; /* orientation=lt */ -padding: 0px 0px 0px 5px; /* >orientation=rt */ +padding: 0px 0px 0px 5px; /* orientation=rt */ Modified: epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/extras/PortalDevelopment_Skinning/default190.java =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/extras/PortalDevelopment_Skinning/default190.java 2010-10-26 04:48:15 UTC (rev 4830) +++ epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/extras/PortalDevelopment_Skinning/default190.java 2010-10-26 06:37:47 UTC (rev 4831) @@ -1,47 +1,47 @@ -/*---- MyTheme ----*/ -.MyTheme .WindowBarCenter .WindowPortletInfo { +/*---- MyThemeRed ----*/ +.MyThemeRed .WindowBarCenter .WindowPortletInfo { margin-right: 80px; /* orientation=lt */ margin-left: 80px; /* orientation=rt */ } -.MyTheme .WindowBarCenter .ControlIcon { +.MyThemeRed .WindowBarCenter .ControlIcon { float: right;/* orientation=lt */ float: left;/* orientation=rt */ width: 24px; height: 17px; cursor: pointer; - background-image: url('background/MyTheme.png'); + background-image: url('background/MyThemeRed.png'); } -.MyTheme .ArrowDownIcon { +.MyThemeRed .ArrowDownIcon { background-position: center 20px; } -.MyTheme .OverArrowDownIcon { +.MyThemeRed .OverArrowDownIcon { background-position: center 116px; } -.MyTheme .MinimizedIcon { +.MyThemeRed .MinimizedIcon { background-position: center 44px; } -.MyTheme .OverMinimizedIcon { +.MyThemeRed .OverMinimizedIcon { background-position: center 140px; } -.MyTheme .MaximizedIcon { +.MyThemeRed .MaximizedIcon { background-position: center 68px; } -.MyTheme .OverMaximizedIcon { +.MyThemeRed .OverMaximizedIcon { background-position: center 164px; } -.MyTheme .RestoreIcon { +.MyThemeRed .RestoreIcon { background-position: center 92px; } -.MyTheme .OverRestoreIcon { +.MyThemeRed .OverRestoreIcon { background-position: center 188px; } -.MyTheme .NormalIcon { +.MyThemeRed .NormalIcon { background-position: center 92px; } -.MyTheme .OverNormalIcon { +.MyThemeRed .OverNormalIcon { background-position: center 188px; } -.UIPageDesktop .MyTheme .ResizeArea { +.UIPageDesktop .MyThemeRed .ResizeArea { float: right;/* orientation=lt */ float: left;/* orientation=rt */ width: 18px; height: 18px; @@ -49,7 +49,7 @@ background: url('background/ResizeArea18x18.gif') no-repeat left top; /* orientation=lt */ background: url('background/ResizeArea18x18-rt.gif') no-repeat right top; /* orientation=rt */ } -.MyTheme .Information { +.MyThemeRed .Information { height: 18px; line-height: 18px; vertical-align: middle; font-size: 10px; padding-left: 5px;/* orientation=lt */ @@ -57,7 +57,7 @@ margin-right: 18px;/* orientation=lt */ margin-left: 18px;/* orientation=rt */ } -.MyTheme .WindowBarCenter .WindowPortletIcon { +.MyThemeRed .WindowBarCenter .WindowPortletIcon { background-position: left top; /* orientation=lt */ background-position: right top; /* orientation=rt */ padding-left: 20px; /* orientation=lt */ @@ -65,62 +65,62 @@ height: 16px; line-height: 16px; } -.MyTheme .WindowBarCenter .PortletName { +.MyThemeRed .WindowBarCenter .PortletName { font-weight: bold; color: #333333; overflow: hidden; white-space: nowrap; width: 100%; } -.MyTheme .WindowBarLeft { +.MyThemeRed .WindowBarLeft { padding-left: 12px; - background-image: url('background/MyTheme.png'); + background-image: url('background/MyThemeRed.png'); background-repeat: no-repeat; background-position: left -148px; } -.MyTheme .WindowBarRight { +.MyThemeRed .WindowBarRight { padding-right: 11px; - background-image: url('background/MyTheme.png'); + background-image: url('background/MyThemeRed.png'); background-repeat: no-repeat; background-position: right -119px; } -.MyTheme .WindowBarCenter { - background-image: url('background/MyTheme.png'); +.MyThemeRed .WindowBarCenter { + background-image: url('background/MyThemeRed.png'); background-repeat: repeat-x; background-position: left -90px; } -.MyTheme .WindowBarCenter .FixHeight { +.MyThemeRed .WindowBarCenter .FixHeight { height: 21px; padding-top: 8px; } -.MyTheme .MiddleDecoratorLeft { +.MyThemeRed .MiddleDecoratorLeft { padding-left: 12px; - background: url('background/MyTheme.png') repeat-y left; + background: url('background/MyThemeRed.png') repeat-y left; } -.MyTheme .MiddleDecoratorRight { +.MyThemeRed .MiddleDecoratorRight { padding-right: 11px; - background: url('background/MyTheme.png') repeat-y right; + background: url('background/MyThemeRed.png') repeat-y right; } -.MyTheme .MiddleDecoratorCenter { +.MyThemeRed .MiddleDecoratorCenter { background: #ffffff; } -.MyTheme .BottomDecoratorLeft { - MyTheme: 12px; - background-image: url('background/MyTheme.png'); +.MyThemeRed .BottomDecoratorLeft { + MyThemeRed: 12px; + background-image: url('background/MyThemeRed.png'); background-repeat: no-repeat; background-position: left -60px; } -.MyTheme .BottomDecoratorRight { +.MyThemeRed .BottomDecoratorRight { padding-right: 11px; - background-image: url('background/MyTheme.png'); + background-image: url('background/MyThemeRed.png'); background-repeat: no-repeat; background-position: right -30px; } -.MyTheme .BottomDecoratorCenter { - background-image: url('background/MyTheme.png'); +.MyThemeRed .BottomDecoratorCenter { + background-image: url('background/MyThemeRed.png'); background-repeat: repeat-x; background-position: left top; } -.MyTheme .BottomDecoratorCenter .FixHeight { +.MyThemeRed .BottomDecoratorCenter .FixHeight { height: 30px; } Modified: epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortalDevelopment/DefaultPortalNavigationConfiguration.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortalDevelopment/DefaultPortalNavigationConfiguration.xml 2010-10-26 04:48:15 UTC (rev 4830) +++ epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortalDevelopment/DefaultPortalNavigationConfiguration.xml 2010-10-26 06:37:47 UTC (rev 4831) @@ -62,7 +62,8 @@ It is also possible to apply a nested container that can also contain portlets. Row, column or tab containers are then responsible for the layout of their child portlets. </para> <para> - Each application references a portlet using its application name (usually the name of the WAR file) and a portlet reference (The name of the portlet as defined in portlet.xml) + Each application references a portlet using its application name (usually the name of the WAR file) +and a portlet reference (the name of the portlet as defined in portlet.xml). </para> <para> Use the <literal>page-body</literal> tag to define where &PRODUCT; should render the current page. Modified: epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortalDevelopment/InternationalizationConfiguration.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortalDevelopment/InternationalizationConfiguration.xml 2010-10-26 04:48:15 UTC (rev 4830) +++ epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortalDevelopment/InternationalizationConfiguration.xml 2010-10-26 06:37:47 UTC (rev 4831) @@ -31,7 +31,7 @@ <programlisting language="Java" role="Java"><xi:include href="../../extras/PortalDevelopment_InternationalizationConfiguration/default147.java" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> <para> - Inside those file are typical <literal>key=value</literal> Java EE properties. For example; in the <literal>French</literal> file: + Inside those file are typical <literal>key=value</literal> Java EE properties. For example; in the <literal>Spanish</literal> file: </para> <programlisting language="Java" role="Java"><xi:include href="../../extras/PortalDevelopment_InternationalizationConfiguration/default148.java" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> @@ -95,7 +95,7 @@ </callout> <callout arearefs="area-Reference_Guide-i18n.locales.configuration.input-encoding"> <para> - <emphasis>input-encoding</emphasis>: In the java implementation, the encoding parameters will be used for the request response stream. The input-encoding parameter will be used for request <literal>setCharacterEncoding(..)</literal>. + <emphasis>input-encoding</emphasis>: In the Java implementation, the encoding parameters will be used for the request response stream. The input-encoding parameter will be used for request <literal>setCharacterEncoding(..)</literal>. </para> </callout> <callout arearefs="area-Reference_Guide-i18n.locales.configuration.description"> @@ -204,7 +204,7 @@ <section id="sect-Reference_Guide-Portlets-Standard_Portlet_Resource_Keys"> <title>Standard Portlet Resource Keys</title> <para> - The portlet specifications defines three standard keys: <emphasis>Title</emphasis>, <emphasis>Short Title</emphasis> and <emphasis>Keywords</emphasis>. Keywords is formatted as a comma-separated list of tags. + The portlet specification defines three standard keys: <emphasis>Title</emphasis>, <emphasis>Short Title</emphasis> and <emphasis>Keywords</emphasis>. Keywords is formatted as a comma-separated list of tags. </para> <programlisting language="Java" role="Java"><xi:include href="../../extras/PortalDevelopment_InternationalizationConfiguration/default154.java" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> Modified: epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortalDevelopment/JavascriptInterApplicationCommunication.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortalDevelopment/JavascriptInterApplicationCommunication.xml 2010-10-26 04:48:15 UTC (rev 4830) +++ epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortalDevelopment/JavascriptInterApplicationCommunication.xml 2010-10-26 06:37:47 UTC (rev 4831) @@ -31,7 +31,7 @@ </listitem> </itemizedlist> <para> - A subscription to a topic will receive any subtopic messages. For example; An application subscribed to &#34;<literal>/eXo/application</literal>&#34; will receive messages sent on the &#34;<literal>/eXo/application/map</literal>&#34; topic. A message sent on &#34;<literal>/eXo</literal>&#34;, however, would not be received. + A subscription to a topic will receive any subtopic messages. For example, an application subscribed to &#34;<literal>/eXo/application</literal>&#34; will receive messages sent on the &#34;<literal>/eXo/application/map</literal>&#34; topic. A message sent on &#34;<literal>/eXo</literal>&#34;, however, would not be received. </para> <variablelist id="vari-Reference_Guide-Overview-Subscription_Topics"> <title>Subscription Topics</title> Modified: epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortalDevelopment/RTLFramework.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortalDevelopment/RTLFramework.xml 2010-10-26 04:48:15 UTC (rev 4830) +++ epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortalDevelopment/RTLFramework.xml 2010-10-26 06:37:47 UTC (rev 4831) @@ -10,14 +10,7 @@ </para> <programlisting language="Java" role="Java"><xi:include href="../../extras/PortalDevelopment_RTLFramework/default172.java" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="Java" role="JAVA"><![CDATA[ LT, // Western Europe -RT, // Middle East (Arabic, Hebrew) -TL, // Japanese, Chinese, Korean -TR; // Mongolian -public boolean isLT() { ... } -public boolean isRT() { ... } -public boolean isTL() { ... } -public boolean isTR() { ... }]]></programlisting> --> + <para> The object defining the orientation for the current request is the <literal>UIPortalApplication</literal>. However it should be accessed at runtime using the <literal>RequestContext</literal> that delegates to the <literal>UIPortalApplication</literal>. </para> @@ -25,7 +18,7 @@ In the case of a <literal>PortalRequestContext</literal> it is a direct delegate as the <literal>PortalRequestContext</literal> has a reference to the current <literal>UIPortalApplication</literal>. </para> <para> - In the case of a different context such as the <literal>PortletRequestContext</literal>, it delegates to the parent context given the fact that the root <literal>RequestContext</literal> is always a <literal>PortalRequestContext</literal>. + In the case of a different context, it delegates to the parent context given the fact that the root <literal>RequestContext</literal> is always a <literal>PortalRequestContext</literal>. </para> <section id="sect-Reference_Guide-Right_To_Left_RTL_Framework-Groovy_templates"> <title>Groovy templates</title> @@ -72,7 +65,10 @@ <section id="sect-Reference_Guide-Right_To_Left_RTL_Framework-Stylesheet"> <title>Stylesheet</title> <para> - The skin service handles stylesheet rewriting to accommodate the orientation. It works by appending -lt or -rt to the stylesheet name. + The skin service handles stylesheet rewriting to accommodate the orientation. + </para> + <para> + It works by appending -lt or -rt to the stylesheet name. </para> <para> For instance: <filename>/web/skin/portal/webui/component/UIFooterPortlet/DefaultStylesheet-rt.css</filename> will return the same stylesheet as <filename>/web/skin/portal/webui/component/UIFooterPortlet/DefaultStylesheet.css</filename> but processed for the RT orientation. The <parameter>-lt</parameter> suffix is optional. @@ -80,77 +76,45 @@ <para> Stylesheet authors can annotate their stylesheet to create content that depends on the orientation. </para> - <formalpara id="form-Reference_Guide-Stylesheet-Example_1"> - <title>Example 1</title> - <para> - In the example we need to use the orientation to modify the float attribute that will make the horizontal tabs either float on left or on right: - </para> - </formalpara> - + <para> + In the example below we need to use the orientation to modify the float attribute that will make the horizontal tabs either float on left or on right: + </para> + <example> + <title>Example 1</title> <programlisting language="Java" role="Java"><xi:include href="../../extras/PortalDevelopment_RTLFramework/default173.java" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting> -float: left; /* orientation=lt */ -float: right; /* orientation=rt */ -font-weight: bold; -text-align: center; -white-space: nowrap; -</programlisting> --> + </example> <para> The LT produced output will be: </para> <programlisting language="Java" role="Java"><xi:include href="../../extras/PortalDevelopment_RTLFramework/default174.java" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting> -float: left; /* orientation=lt */ -font-weight: bold; -text-align: center; -white-space: nowrap; -</programlisting> --> + <para> The RT produced output will be: </para> <programlisting language="Java" role="Java"><xi:include href="../../extras/PortalDevelopment_RTLFramework/default175.java" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting> -float: right; /* orientation=rt */ -font-weight: bold; -text-align: center; -white-space: nowrap; -</programlisting> --> - <formalpara id="form-Reference_Guide-Stylesheet-Example_2"> - <title>Example 2</title> - <para> - In this example we need to modify the padding according to the orientation: - </para> - </formalpara> - + + <para> + In this example we need to modify the padding according to the orientation: + </para> + <example> + <title>Example 2</title> <programlisting language="Java" role="Java"><xi:include href="../../extras/PortalDevelopment_RTLFramework/default176.java" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting> -color: white; -line-height: 24px; -padding: 0px 5px 0px 0px; /* orientation=lt */ -padding: 0px 0px 0px 5px; /* &gt;orientation=rt */ -</programlisting> --> + </example> + <para> The LT produced output will be: </para> <programlisting language="Java" role="Java"><xi:include href="../../extras/PortalDevelopment_RTLFramework/default177.java" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting> -color: white; -line-height: 24px; -padding: 0px 5px 0px 0px; /* orientation=lt */ -</programlisting> --> + <para> The RT produced output will be: </para> <programlisting language="Java" role="Java"><xi:include href="../../extras/PortalDevelopment_RTLFramework/default178.java" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting> -color: white; -line-height: 24px; -padding: 0px 0px 0px 5px; /* orientation=rt */ -</programlisting> --> + </section> Modified: epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortalDevelopment/Skinning.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortalDevelopment/Skinning.xml 2010-10-26 04:48:15 UTC (rev 4830) +++ epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortalDevelopment/Skinning.xml 2010-10-26 06:37:47 UTC (rev 4831) @@ -273,7 +273,7 @@ <section id="sect-Reference_Guide-Creating_New_Skins-Creating_a_New_Portal_Skin"> <title>Creating a New Portal Skin</title> <para> - A new portal skins will need to be added to the portal through the skin service. Therefore, the web application which contains the skins will need to be properly configured for the skin service to discover them. This means properly configuring the <literal>ResourceRequestFilter</literal> and <filename>gatein-resources.xml</filename>. + New portal skins will need to be added to the portal through the skin service. Therefore, the web application which contains the skins will need to be properly configured for the skin service to discover them. This means properly configuring the <literal>ResourceRequestFilter</literal> and <filename>gatein-resources.xml</filename>. </para> <section id="sect-Reference_Guide-Creating_a_New_Portal_Skin-Portal_Skin_Configuration"> <title>Portal Skin Configuration</title> @@ -347,10 +347,10 @@ <section id="sect-Reference_Guide-Creating_a_New_Window_Style-Window_Style_Configuration"> <title>Window Style Configuration</title> <para> - Window Styles are defined within a <filename>gatein-resources.xml</filename> file which is used by the skin service to deploy the window style into the portal. Window styles can belong in with a window style category, this category and the window styles will need to be specified in resources file. + Window Styles are defined within a <filename>gatein-resources.xml</filename> file which is used by the skin service to deploy the window style into the portal. Window styles can belong in a window style category. This category and the window styles will need to be specified in resources file. </para> <para> - The following <filename>gatein-resource.xml</filename> fragment will add <literal>MyThemeBlue</literal> and <literal>MyThemeRed</literal> to the <literal>MyTheme</literal> category. + The following <filename>gatein-resources.xml</filename> fragment will add <literal>MyThemeBlue</literal> and <literal>MyThemeRed</literal> to the <literal>MyTheme</literal> category. </para> <programlisting language="XML" role="XML"><xi:include href="../../extras/PortalDevelopment_Skinning/default189.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> @@ -390,7 +390,7 @@ <section id="sect-Reference_Guide-Creating_a_New_Window_Style-How_to_Set_the_Default_Window_Style"> <title>How to Set the Default Window Style</title> <para> - To set the default window style to be used for a portal, you must specify the CSS classes for a theme called <literal>DefaultTheme</literal>. + To set the default window style to be used for a portal you will need to specify the CSS classes for a theme called <literal>DefaultTheme</literal>. </para> <note> <title>DefaultTheme</title> @@ -412,10 +412,10 @@ The link ID will be of the form <parameter>{portletAppName}{PortletName}</parameter>. </para> <para> - For example: <literal>ContentPortlet</literal> in <literal>content.war</literal>, will give <parameter>id=&#34;content<literal>ContentPortlet&#34;</literal></parameter> + For example: <literal>ContentPortlet</literal> in <literal>content.war</literal>, will give <parameter>id=&#34;content<literal>ContentPortlet&#34;</literal></parameter>. </para> <para> - To define a new CSS file to include whenever a portlet is available on a portal page, the following fragment needs to be added in gatein-resources.xml + To define a new CSS file to include whenever a portlet is available on a portal page, the following fragment needs to be added in <filename>gatein-resources.xml</filename>. </para> <programlisting language="XML" role="XML"><xi:include href="../../extras/PortalDevelopment_Skinning/default191.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> @@ -431,12 +431,12 @@ <section id="sect-Reference_Guide-How_to_Create_New_Portlet_Skins-Change_Portlet_Icons"> <title>Change Portlet Icons</title> <para> - Each portlet can be represented by an unique icon in the portlet registry or page editor. This icon can be changed by adding an image to the directory of the portlet <literal>webapplication</literal>: + Each portlet can be registered by a unique icon in the portlet registry or page editor. This icon can be changed by adding an image to the directory of the portlet web application: </para> <itemizedlist> <listitem> <para> - <filename>skin/DefaultSkin/skinIcons/<replaceable>icon_size</replaceable>/<replaceable>icon_name.png</replaceable></filename>. + <filename>skin/DefaultSkin/portletIcons/<replaceable>portlet_name</replaceable>.png </filename>. </para> </listitem> </itemizedlist> Modified: epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortletDevelopment/PortletBridge/configuration.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortletDevelopment/PortletBridge/configuration.xml 2010-10-26 04:48:15 UTC (rev 4830) +++ epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortletDevelopment/PortletBridge/configuration.xml 2010-10-26 06:37:47 UTC (rev 4831) @@ -20,25 +20,7 @@ </para> <programlisting language="XML" role="XML"><xi:include href="../../../extras/PortletBridge_Configuration/default197.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[ -<portlet> -<portlet-name>yourPortletName</portlet-name> -<portlet-class> -javax.portlet.faces.GenericFacesPortlet -</portlet-class> -<init-param> -<name>javax.portlet.faces.defaultViewId.view</name> -<value>/welcome.xhtml</value> -</init-param> -<init-param> -<name>javax.portlet.faces.defaultViewId.edit</name> -<value>/jsf/edit.xhtml</value> -</init-param> -<init-param> -<name>javax.portlet.faces.defaultViewId.help</name> -<value>/jsf/help.xhtml</value> -</init-param> -]]></programlisting> --> + <para> When <parameter>preserveActionParams</parameter> is set to <parameter>TRUE</parameter>, the bridge must maintain any request parameters assigned during the portlet&#39;s action request. </para> @@ -47,12 +29,7 @@ </para> <programlisting language="XML" role="XML"><xi:include href="../../../extras/PortletBridge_Configuration/default198.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[ -<init-param> -<name>javax.portlet.faces.preserveActionParams</name> -<value>true</value> -</init-param> -]]></programlisting> --> + </section> @@ -63,19 +40,9 @@ </para> <programlisting language="XML" role="XML"><xi:include href="../../../extras/PortletBridge_Configuration/default199.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[ -<faces-config> -<application> -<view-handler> -org.jboss.portletbridge.application.PortletViewHandler -</view-handler> -<state-manager>org.jboss.portletbridge.application.PortletStateManager</state-manager> -</application> -... -]]></programlisting> --> + </section> - <section id="sect-Reference_Guide-Core_Setup_and_Configuration-Facelets_Configuration"> <title>Facelets Configuration</title> <para> @@ -85,29 +52,9 @@ <title>web.xml</title> <programlisting language="XML" role="XML"><xi:include href="../../../extras/PortletBridge_Configuration/default200.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[ -<web-app xmlns="http://java.sun.com/xml/ns/j2ee" -xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" -xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd" -version="2.4"> -... -<!- This is optional parameters for a facelets based application -> -<context-param> -<param-name>org.ajax4jsf.VIEW_HANDLERS</param-name> -<param-value>org.jboss.portletbridge.application.FaceletPortletViewHandler</param-value> -</context-param> -]]></programlisting> --> + <programlisting language="XML" role="XML"><xi:include href="../../../extras/PortletBridge_Configuration/default201.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[ -<context-param> -<param-name>javax.portlet.faces.RENDER_POLICY</param-name> -<param-value> -ALWAYS_DELEGATE -</param-value> -</context-param> -... -</web-app> -]]></programlisting> --> + <variablelist id="vari-Reference_Guide-web.xml-RenderPolicy_Options"> <title>RenderPolicy Options</title> <varlistentry> @@ -149,20 +96,7 @@ <title>web.xml</title> <programlisting language="XML" role="XML"><xi:include href="../../../extras/PortletBridge_Configuration/default202.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[ -<web-app xmlns="http://java.sun.com/xml/ns/j2ee" -xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" -xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd" -version="2.4"> -<context-param> -<param-name>javax.portlet.faces.renderPolicy</param-name> -<param-value> -NEVER_DELEGATE -</param-value> -</context-param> -... -</web-app> -]]></programlisting> --> + </section> </section> @@ -175,12 +109,7 @@ </para> <programlisting language="XML" role="XML"><xi:include href="../../../extras/PortletBridge_Configuration/default203.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[ -<context-param> -<param-name>javax.portlet.faces.BridgeImplClass</param-name> -<param-value>org.apache.myfaces.portlet.faces.bridge.BridgeImpl</param-value> -</context-param> -]]></programlisting> --> + </section> </section> @@ -202,16 +131,7 @@ </para> <programlisting language="XML" role="XML"><xi:include href="../../../extras/PortletBridge_Configuration/default204.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[ -<context-param> -<param-name>org.richfaces.LoadStyleStrategy</param-name> -<param-value>ALL</param-value> -</context-param> -<context-param> -<param-name>org.richfaces.LoadScriptStrategy</param-name> -<param-value>ALL</param-value> -</context-param> -]]></programlisting> --> + <note> <para> If you use the &#34;<parameter>NONE</parameter>&#34; strategy, you must include the following scripts in your portlet or portal page header. If you are using <application>JBoss Portal</application>, you can add this to the <filename>jboss-portlet.xml</filename> file. @@ -222,36 +142,13 @@ </para> <programlisting language="XML" role="XML"><xi:include href="../../../extras/PortletBridge_Configuration/default205.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[ -<script src="/faces/rfRes/org/ajax4jsf/framework.pack.js" type="text/javascript"></script> -<script src="/faces/rfRes/org/richfaces/ui.pack.js" type="text/javascript"></script> -<link rel="stylesheet" type="text/css" href="/faces/rfRes/org/richfaces/skin.xcss"/> -]]></programlisting> --> + <para> <application>Seam</application> automatically configures your Ajax4JSF Filter, so if you are running a <application>Seam</application> portlet, you do not need the following Filter configuration (however, you do need the <literal>RESOURCE_URI_PREFIX</literal> no matter what). </para> <programlisting language="XML" role="XML"><xi:include href="../../../extras/PortletBridge_Configuration/default206.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[ -<context-param> -<param-name>org.ajax4jsf.RESOURCE_URI_PREFIX</param-name> -<param-value>rfRes</param-value> -</context-param> -<filter> -<display-name>Ajax4jsf Filter</display-name> -<filter-name>ajax4jsf</filter-name> -<filter-class>org.ajax4jsf.Filter</filter-class> -</filter> -<filter-mapping> -<filter-name>ajax4jsf</filter-name> -<servlet-name>FacesServlet</servlet-name> -<dispatcher>FORWARD</dispatcher> -<dispatcher>REQUEST</dispatcher> -<dispatcher>INCLUDE</dispatcher> -</filter-mapping> -... -</web-app> -]]></programlisting> --> + </section> @@ -284,25 +181,13 @@ </para> <programlisting language="XML" role="XML"><xi:include href="../../../extras/PortletBridge_Configuration/default207.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[ -<context-param> -<param-name>org.jboss.portletbridge.ExceptionHandler</param-name> -<param-value> -org.jboss.portletbridge.SeamExceptionHandlerImpl -</param-value> -</context-param> -]]></programlisting> --> + <para> If you are using this bridge version from <literal>2.0.0.BETA</literal> through <literal>2.0.0.CR1</literal>, you must define the following <filename>web.xml</filename> parameter to use the JBoss Portlet Bridge provided Seam Phase Listener. This is done by the bridge automatically (if needed) in <literal>2.0.0.FINAL</literal>. </para> <programlisting language="XML" role="XML"><xi:include href="../../../extras/PortletBridge_Configuration/default208.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[ -<context-param> -<param-name>javax.faces.LIFECYCLE_ID</param-name> -<param-value>SEAM_PORTLET</param-value> -</context-param> -]]></programlisting> --> + </section> </section> @@ -318,13 +203,7 @@ </note> <programlisting language="XML" role="XML"><xi:include href="../../../extras/PortletBridge_Configuration/default209.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[ -<portlet-app xmlns="http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd" -version="2.0" -xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" -xsi:schemaLocation="http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd -http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd"> -]]></programlisting> --> + <section id="sect-Reference_Guide-Portlet_2.0_Coordination-Sending_and_Receiving_Events"> <title>Sending and Receiving Events</title> <section id="sect-Reference_Guide-Sending_and_Receiving_Events-Configuration"> @@ -341,39 +220,19 @@ </para> <programlisting language="XML" role="XML"><xi:include href="../../../extras/PortletBridge_Configuration/default210.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[ <init-param> -<name>javax.portlet.faces.autoDispatchEvents</name> -<value>true</value> -</init-param> -<init-param> -<name>javax.portlet.faces.bridgeEventHandler</name> -<value>org.foo.eventhandler</value> -</init-param> -]]></programlisting> --> + <para> While future versions on the 2.0 bridge will automate the dispatching and consuming of events, at the moments you must dispatch the event in the JSF or Seam backing bean. </para> <programlisting language="Java" role="Java"><xi:include href="../../../extras/PortletBridge_Configuration/default211.java" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[ if (response instanceof StateAwareResponse) { -StateAwareResponse stateResponse = (StateAwareResponse) response; -stateResponse.setEvent(Foo.QNAME, new Bar()); -} -]]></programlisting> --> + <para> You must also create the event handler class by implementing the <literal>BridgeEventHandler</literal> interface to process the event payload. </para> <programlisting language="Java" role="Java"><xi:include href="../../../extras/PortletBridge_Configuration/BookingEventHandler.java" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[ -public class BookingEventHandler implements BridgeEventHandler -{ -public EventNavigationResult handleEvent(FacesContext context, Event event) -{ -//process event payload here -} -} -]]></programlisting> --> + </section> </section> @@ -397,68 +256,29 @@ </para> <programlisting language="XML" role="XML"><xi:include href="../../../extras/PortletBridge_Configuration/default212.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[ -<init-param> -<name>javax.portlet.faces.bridgePublicRenderParameterHandler</name> -<value>org.foo.PRPHandler</value> -</init-param> -... -<supported-public-render-parameter>myCoolPRP</supported-public-render-parameter> -]]></programlisting> --> + <para> Create a managed bean and <literal>public-parameter-mappings</literal> in your <filename>faces-config.xml</filename>. This should be a basic bean that you can bind the passed parameter to a string with <emphasis>getter</emphasis> and <emphasis>setter</emphasis>. </para> <programlisting language="XML" role="XML"><xi:include href="../../../extras/PortletBridge_Configuration/default213.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[ -<managed-bean> -<managed-bean-name>bookingPRP</managed-bean-name> -<managed-bean-class>your.class.Name</managed-bean-class> -<managed-bean-scope>session</managed-bean-scope> -</managed-bean> -<application> -<application-extension> -<bridge:public-parameter-mappings> -<bridge:public-parameter-mapping> -<parameter>"the name of your portlet":hotelName</parameter> -<model-el>#{bookingPRP.hotelName}</model-el> -</bridge:public-parameter-mapping> -</bridge:public-parameter-mappings> -</application-extension> -</application> -]]></programlisting> --> + <para> You must set the parameter in the JSF or Seam backing bean, if you are providing one from your portlet. </para> <programlisting language="Java" role="Java"><xi:include href="../../../extras/PortletBridge_Configuration/default214.java" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[ -if (response instanceof StateAwareResponse) { -StateAwareResponse stateResponse = (StateAwareResponse) response; -stateResponse.setRenderParameter("hotelName",selectedHotel.getName()); -} -]]></programlisting> --> + <para> Then you must also implement the <literal>BridgePublicRenderParameterHandler</literal> interface to process any updates from the received parameter. </para> <programlisting language="Java" role="Java"><xi:include href="../../../extras/PortletBridge_Configuration/default215.java" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[ -public void processUpdates(FacesContext context) -{ -ELContext elContext = context.getELContext(); -BookingPRPBean bean = (BookingPRPBean) elContext.getELResolver().getValue(elContext, null, "bookingPRP"); -if(null != bean){ -//Do something with bean.getHotelName()); -} else { -} -} -]]></programlisting> --> + </section> </section> - <section id="sect-Reference_Guide-Portlet_2.0_Coordination-Serving_Your_JSF_Resources_in_a_Portlet"> <title>Serving Your JSF Resources in a Portlet</title> <section id="sect-Reference_Guide-Serving_Your_JSF_Resources_in_a_Portlet-Configuration"> @@ -474,21 +294,13 @@ </para> <programlisting language="Java" role="Java"><xi:include href="../../../extras/PortletBridge_Configuration/default216.java" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"> -#{resource['/img/the-path-to-my-image.png']} -</programlisting> --> + <para> Just copy the <literal>ResourceBean.java</literal> code above, and add an entry to your <filename>faces-config.xml</filename> for the bean: </para> <programlisting language="XML" role="XML"><xi:include href="../../../extras/PortletBridge_Configuration/default217.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[ -<managed-bean> -<managed-bean-name>resource</managed-bean-name> -<managed-bean-class>org.richfaces.demo.common.ResourceBean</managed-bean-class> -<managed-bean-scope>application</managed-bean-scope> -</managed-bean> -]]></programlisting> --> + </section> </section> Modified: epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortletDevelopment/PortletBridge/gettingstarted.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortletDevelopment/PortletBridge/gettingstarted.xml 2010-10-26 04:48:15 UTC (rev 4830) +++ epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortletDevelopment/PortletBridge/gettingstarted.xml 2010-10-26 06:37:47 UTC (rev 4831) @@ -87,9 +87,7 @@ </para> <programlisting language="XML" role="XML"><xi:include href="../../../extras/PortletBridge_GettingStarted/default218.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[ -<security:portal-identity authenticate-method="#{authenticator.authenticate}"/> -]]></programlisting> --> + </section> @@ -100,12 +98,7 @@ </para> <programlisting language="XML" role="XML"><xi:include href="../../../extras/PortletBridge_GettingStarted/default219.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[ -<context-param> -<param-name>org.jboss.portletbridge.WRAP_SCRIPTS</param-name> -<param-value>true</param-value> -</context-param> -]]></programlisting> --> + </section> </section> @@ -151,14 +144,7 @@ <entry align="left" nameend="c5" namest="c2"> <programlisting language="Java" role="Java"><xi:include href="../../../extras/PortletBridge_GettingStarted/default220.java" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting>mvn archetype:generate --DarchetypeGroupId=org.jboss.portletbridge.archetypes --DarchetypeArtifactId=1.2-basic --DarchetypeVersion=2.0.0.FINAL --DgroupId=org.whatever.project --DartifactId=myprojectname --DarchetypeRepository=https://repository.jboss.org/nexus/content/groups/public/ -</programlisting> --> + </entry> </row> <row class="table-even" style="background-color:#D6DEE0;border:1px solid #E1E9EB;color:#334558;"> @@ -168,14 +154,7 @@ <entry align="left" nameend="c5" namest="c2"> <programlisting language="Java" role="Java"><xi:include href="../../../extras/PortletBridge_GettingStarted/default221.java" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting>mvn archetype:generate --DarchetypeGroupId=org.jboss.portletbridge.archetypes --DarchetypeArtifactId=richfaces-basic --DarchetypeVersion=2.0.0.FINAL --DgroupId=org.whatever.project --DartifactId=myprojectname --DarchetypeRepository=https://repository.jboss.org/nexus/content/groups/public/ -</programlisting> --> + </entry> </row> <row class="table-odd" style="background-color:#D6DEE0;border:1px solid #E1E9EB;color:#334558;"> @@ -185,14 +164,7 @@ <entry align="left" nameend="c5" namest="c2"> <programlisting language="Java" role="Java"><xi:include href="../../../extras/PortletBridge_GettingStarted/default222.java" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting>mvn archetype:generate --DarchetypeGroupId=org.jboss.portletbridge.archetypes --DarchetypeArtifactId=seam-basic --DarchetypeVersion=2.0.0.FINAL --DgroupId=org.whatever.project --DartifactId=seamproject --DarchetypeRepository=https://repository.jboss.org/nexus/content/groups/public/ -</programlisting> --> + </entry> </row> </tbody> Modified: epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortletDevelopment/PortletBridge/portlet_development.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortletDevelopment/PortletBridge/portlet_development.xml 2010-10-26 04:48:15 UTC (rev 4830) +++ epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortletDevelopment/PortletBridge/portlet_development.xml 2010-10-26 06:37:47 UTC (rev 4831) @@ -18,16 +18,6 @@ </para> <programlisting language="XML" role="XML"><xi:include href="../../../extras/PortletBridge_Portlet_Development/default223.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[ -<application> -<application-extension> -<bridge:excluded-attributes> -<bridge:excluded-attribute>foo.bar</bridge:excluded-attribute> -<bridge:excluded-attribute>foo.baz.*</bridge:excluded-attribute> -</bridge:excluded-attributes> -</application-extension> -</application> -]]></programlisting> --> </section> @@ -44,15 +34,6 @@ </para> <programlisting language="XML" role="XML"><xi:include href="../../../extras/PortletBridge_Portlet_Development/default224.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[ -<navigation-rule> -<from-view-id>/register.jspx</from-view-id> -<navigation-case> -<from-outcome>edit</from-outcome> -<to-view-id>/edit.jspx?javax.portlet.faces.PortletMode=edit</to-view-id> -</navigation-case> -</navigation-rule> -]]></programlisting> --> </section> @@ -72,15 +53,7 @@ </para> <programlisting language="XML" role="XML"><xi:include href="../../../extras/PortletBridge_Portlet_Development/default225.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[ -<navigation-rule> -<from-view-id>/edit.jspx*</from-view-id> -<navigation-case> -<from-outcome>view</from-outcome> -<to-view-id>#{sessionScope['javax.portlet.faces.viewIdHistory.view']}</to-view-id> -</navigation-case> -</navigation-rule> -]]></programlisting> --> + <section id="sect-Reference_Guide-Navigating_to_a_modes_last_viewId-Note_to_Portlet_Developers"> <title>Note to Portlet Developers</title> <para> @@ -123,12 +96,7 @@ </para> <programlisting language="XML" role="XML"><xi:include href="../../../extras/PortletBridge_Portlet_Development/default230.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[ -<init-param> -<name>javax.portlet.faces.extension.resetModeViewId</name> -<value>true</value> -</init-param> -]]></programlisting> --> + </section> Modified: epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortletDevelopment/Standard.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortletDevelopment/Standard.xml 2010-10-26 04:48:15 UTC (rev 4830) +++ epp/docs/branches/EPP_5_1_Branch/Reference_Guide/en-US/modules/PortletDevelopment/Standard.xml 2010-10-26 06:37:47 UTC (rev 4831) @@ -128,7 +128,7 @@ This section describes how to deploy a portlet in &PRODUCT;. </para> <para> - An example portlet called <filename>SimplestHelloWorld</filename> is available in the <filename>/jboss-epp-5.0-src/portal/examples/portlets/</filename> directory of the &PRODUCT; sources package or the <filename>jboss-epp-5.0-docs/epp-doc/examples/portlets</filename> directory of the documentation package.. + An example portlet called <filename>SimplestHelloWorld</filename> is available in the <filename>/jboss-epp-5.0-src/portal/examples/portlets/</filename> directory of the &PRODUCT; sources package or the <filename>jboss-epp-5.0-docs/epp-doc/examples/portlets</filename> directory of the documentation package. </para> <section id="sect-Reference_Guide-Deploying_your_first_Portlet-Compiling"> <title>Compiling</title> @@ -142,8 +142,7 @@ </para> <programlisting language="Java" role="Java"><xi:include href="../../extras/PortletDevelopment_Standard/default243.java" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting>mvn package -</programlisting> --> + </step> <step> <para> @@ -198,18 +197,7 @@ </areaspec> <programlisting language="Java" role="Java"><xi:include href="../../extras/PortletDevelopment_Standard/default244.java" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting>|- SimplestHelloWorld-0.0.1.war -| `- WEB-INF -| |- classes -| | `- org -| | `- jboss -| | `- portal -| | `- portlet -| | `- samples -| | `- SimplestHelloWorldPortlet.class -| |- portlet.xml -| `- web.xml -</programlisting> --> + <calloutlist> <callout arearefs="area-Reference_Guide-Deploying_your_first_Portlet-Package_Structure.javaclass"> <para> @@ -246,22 +234,7 @@ </areaspec> <programlisting language="Java" role="Java"><xi:include href="../../extras/PortletDevelopment_Standard/SimplestHelloWorldPortlet.java" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="Java" role="JAVA"><![CDATA[package org.jboss.portal.portlet.samples; -import java.io.IOException; -import java.io.PrintWriter; -import javax.portlet.GenericPortlet; -import javax.portlet.RenderRequest; -import javax.portlet.RenderResponse; -public class SimplestHelloWorldPortlet extends GenericPortlet -{ -public void doView(RenderRequest request, RenderResponse response) throws IOException -{ -PrintWriter writer = response.getWriter(); -writer.write("Hello World !"); -writer.close(); -} -} -]]></programlisting> --> + <calloutlist> <callout arearefs="area-Reference_Guide-Deploying_your_first_Portlet-Portlet_Class.extends"> <para> @@ -276,7 +249,7 @@ </callout> <callout arearefs="area-Reference_Guide-Deploying_your_first_Portlet-Portlet_Class.doview"> <para> - If only the <literal>view</literal> mode is required, then only the <literal>doView</literal> method needs to be implemented. The <literal>GenericPortlet</literal><literal>render</literal> implementation calls our implementation when the <literal>view</literal> mode is requested. + If only the <literal>view</literal> mode is required, then only the <literal>doView</literal> method needs to be implemented. The <literal>GenericPortlet</literal> render implementation calls our implementation when the <literal>view</literal> mode is requested. </para> </callout> <callout arearefs="area-Reference_Guide-Deploying_your_first_Portlet-Portlet_Class.writer"> @@ -325,23 +298,7 @@ </areaspec> <programlisting language="XML" role="XML"><xi:include href="../../extras/PortletDevelopment_Standard/default245.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[<portlet-app xmlns="http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd" -xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" -xsi:schemaLocation="http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd" -version="2.0"> -<portlet> -<portlet-name>SimplestHelloWorldPortlet</portlet-name> -<portlet-class> -org.jboss.portal.portlet.samples.SimplestHelloWorldPortlet -</portlet-class> -<supports> -<mime-type>text/html</mime-type> -</supports> -<portlet-info> -<title>Simplest Hello World Portlet</title> -</portlet-info> -</portlet> -</portlet-app>]]></programlisting> --> + <calloutlist> <callout arearefs="area-Reference_Guide-Deploying_your_first_Portlet-Application_Descriptors.portletname"> <para> @@ -422,8 +379,7 @@ </para> <programlisting language="XML" role="XML"><xi:include href="../../extras/PortletDevelopment_Standard/default246.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting><command>mvn package</command> -</programlisting> --> + <para> in the <filename>jsphellouser</filename> directory. </para> @@ -469,25 +425,7 @@ </para> <programlisting language="Java" role="Java"><xi:include href="../../extras/PortletDevelopment_Standard/default247.java" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting>gatein-jsp-hellouser->1.0.0-GA-SNAPSHOT.war -|- META-INF -| |- MANIFEST.MF -|- WEB-INF -| |- classes -| | `- org -| | `- jboss -| | `- portal -| | `- portlet -| | `- samples -| | `- JSPHelloUserPortlet.class -| |- portlet.xml -| `- web.xml -`- jsp -|- edit.jsp -|- hello.jsp -|- help.jsp -`- welcome.jsp -</programlisting> --> + </section> @@ -505,36 +443,7 @@ </areaspec> <programlisting language="Java" role="Java"><xi:include href="../../extras/PortletDevelopment_Standard/JSPHelloUserPortlet.java" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="Java" role="JAVA"><![CDATA[package org.jboss.portal.portlet.portlets; -import java.io.IOException; -import javax.portlet.ActionRequest; -import javax.portlet.ActionResponse; -import javax.portlet.GenericPortlet; -import javax.portlet.PortletException; -import javax.portlet.PortletRequestDispatcher; -import javax.portlet.RenderRequest; -import javax.portlet.RenderResponse; -import javax.portlet.UnavailableException; -public class JSPHelloUserPortlet extends GenericPortlet -{ -public void doView(RenderRequest request, RenderResponse response) -throws PortletException, IOException -{ -String sYourName = (String) request.getParameter("yourname"); -if (sYourName != null) -{ -request.setAttribute("yourname", sYourName); -PortletRequestDispatcher prd = -getPortletContext().getRequestDispatcher("/jsp/hello.jsp"); -prd.include(request, response); -} -else -{ -PortletRequestDispatcher prd = getPortletContext().getRequestDispatcher("/jsp/welcome.jsp"); -prd.include(request, response); -} -} -...]]></programlisting> --> + <calloutlist> <callout arearefs="area-Reference_Guide-JavaServer_Pages_Portlet_Example-Portlet_Class.doView"> <para> @@ -570,22 +479,7 @@ </para> <programlisting language="Java" role="Java"><xi:include href="../../extras/PortletDevelopment_Standard/default248.java" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="Java" role="JAVA"><![CDATA[... -protected void doHelp(RenderRequest rRequest, RenderResponse rResponse) throws PortletException, IOException, -UnavailableException -{ -rResponse.setContentType("text/html"); -PortletRequestDispatcher prd = getPortletContext().getRequestDispatcher("/jsp/help.jsp"); -prd.include(rRequest, rResponse); -} -protected void doEdit(RenderRequest rRequest, RenderResponse rResponse) throws PortletException, IOException, -UnavailableException -{ -rResponse.setContentType("text/html"); -PortletRequestDispatcher prd = getPortletContext().getRequestDispatcher("/jsp/edit.jsp"); -prd.include(rRequest, rResponse); -} -...]]></programlisting> --> + <para> Portlet calls happen in one or two phases. One when the portlet is rendered and two when the portlet is actioned <emphasis>then</emphasis> rendered. </para> @@ -603,14 +497,7 @@ </areaspec> <programlisting language="Java" role="Java"><xi:include href="../../extras/PortletDevelopment_Standard/default249.java" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="Java" role="JAVA"><![CDATA[... -public void processAction(ActionRequest aRequest, ActionResponse aResponse) throws PortletException, IOException, -UnavailableException -{ -String sYourname = (String) aRequest.getParameter("yourname"); -aResponse.setRenderParameter("yourname", sYourname); -} -...]]></programlisting> --> + <calloutlist> <callout arearefs="area-Reference_Guide-JavaServer_Pages_Portlet_Example-Portlet_Class.processAction"> <para> @@ -624,7 +511,7 @@ </callout> <callout arearefs="area-Reference_Guide-JavaServer_Pages_Portlet_Example-Portlet_Class.setRenderParameter"> <para> - The value of <literal>yourname</literal> is kept to make it available in the rendering phase. The previous line simply copies an action parameters to a render parameter for this example. + The value of <literal>yourname</literal> is kept to make it available in the rendering phase. The previous line simply copies an action parameter to a render parameter for this example. </para> </callout> </calloutlist> @@ -639,13 +526,9 @@ </para> <programlisting language="XML" role="XML"><xi:include href="../../extras/PortletDevelopment_Standard/default250.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="HTML" role="HTML"><![CDATA[<div class="portlet-section-header">Help mode</div> -<div class="portlet-section-body">This is the help mode, a convenient place to give the user some help information.</div>]]> -</programlisting> --> + <programlisting language="XML" role="XML"><xi:include href="../../extras/PortletDevelopment_Standard/default251.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="HTML" role="HTML"><![CDATA[<div class="portlet-section-header">Edit mode</div> -<div class="portlet-section-body">This is the edit mode, a convenient place to let the user change his portlet preferences.</div>]]> -</programlisting> --> + <para> The landing page contains the links and form to call our portlet: </para> @@ -660,32 +543,7 @@ </areaspec> <programlisting language="XML" role="XML"><xi:include href="../../extras/PortletDevelopment_Standard/default252.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[<%@ taglib uri="http://java.sun.com/portlet" prefix="portlet" %> -<div class="portlet-section-header">Welcome !</div> -<br/> -<div class="portlet-font">Welcome on the JSP Hello User portlet, -my name is GateIn Portal. What's yours ?</div> -<br/> -<div class="portlet-font">Method 1: We simply pass the parameter to the render phase:<br/> -<a href="<portlet:renderURL><portlet:param name="yourname" value="John Doe"/> -</portlet:renderURL>">John Doe</a></div> -<br/> -<div class="portlet-font">Method 2: We pass the parameter to the render phase, using valid XML: -Please check the source code to see the difference with Method 1. -<portlet:renderURL var="myRenderURL"> -<portlet:param name="yourname" value='John Doe'/> -</portlet:renderURL> -<br/> -<a href="<%= myRenderURL %>">John Doe</a></div> -<br/> -<div class="portlet-font">Method 3: We use a form:<br/> -<portlet:actionURL var="myActionURL"/> -<form action="<%= myActionURL %>" method="POST"> -<span class="portlet-form-field-label">Name:</span> -<input class="portlet-form-input-field" type="text" name="yourname"/> -<input class="portlet-form-button" type="Submit"/> -</form> -</div>]]></programlisting> --> + <calloutlist> <callout arearefs="area-Reference_Guide-JavaServer_Pages_Portlet_Example-JSP_files_and_the_Portlet_Tag_Library.taglib"> <para> @@ -747,20 +605,12 @@ </para> <programlisting language="XML" role="XML"><xi:include href="../../extras/PortletDevelopment_Standard/default253.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[<faces-config> -... -<application> -<view-handler>org.jboss.portletbridge.application.PortletViewHandler</view-handler> -<state-manager>org.jboss.portletbridge.application.PortletStateManager</state-manager> -</application> -... -</faces-config>]]> -</programlisting> --> + <para> The portlet bridge libraries must be available and are usually bundled with the <literal>WEB-INF/lib</literal> directory of the web archive. </para> <para> - The other difference when compared to a regular portlet application are in the portlet descriptor. All the relevant details about this can be found in the JSR-301 specification that the JBoss Portlet Bridge implements. + The other differences when compared to a regular portlet application are in the portlet descriptor. All the relevant details about this can be found in the JSR-301 specification that the JBoss Portlet Bridge implements. </para> <programlistingco> <areaspec> @@ -771,37 +621,7 @@ </areaspec> <programlisting language="XML" role="XML"><xi:include href="../../extras/PortletDevelopment_Standard/default254.xml" parse="text" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting> - <!-- <programlisting language="XML" role="XML"><![CDATA[<?xml version="1.0" encoding="UTF-8"?> -<portlet-app xmlns="http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd" -xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" -xsi:schemaLocation="http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd" -version="2.0"> -<portlet> -<portlet-name>JSFHelloUserPortlet</portlet-name> -<portlet-class>javax.portlet.faces.GenericFacesPortlet</portlet-class> -<supports> -<mime-type>text/html</mime-type> -<portlet-mode>view</portlet-mode> -<portlet-mode>edit</portlet-mode> -<portlet-mode>help</portlet-mode> -</supports> -<portlet-info> -<title>JSF Hello User Portlet</title> -</portlet-info> -<init-param> -<name>javax.portlet.faces.defaultViewId.view</name> -<value>/jsf/welcome.jsp</value> -</init-param> -<init-param> -<name>javax.portlet.faces.defaultViewId.edit</name> -<value>/jsf/edit.jsp</value> -</init-param> -<init-param> -<name>javax.portlet.faces.defaultViewId.help</name> -<value>/jsf/help.jsp</value> -</init-param> -</portlet> -</portlet-app>]]></programlisting> --> + <calloutlist> <callout arearefs="area-Reference_Guide-JavaServer_Pages_Portlet_Example-JSF_example_using_the_JBoss_Portlet_Bridge.portlet"> <para> Modified: epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Book_Info.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Book_Info.xml 2010-10-26 04:48:15 UTC (rev 4830) +++ epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Book_Info.xml 2010-10-26 06:37:47 UTC (rev 4831) @@ -5,7 +5,7 @@ <title>Release Notes</title> <subtitle>For use with JBoss Enterprise Portal Platform 5.1.?</subtitle> <edition>1</edition> - <pubsnumber>1.0</pubsnumber> + <pubsnumber>1.1</pubsnumber> <productname>JBoss Enterprise Portal Platform</productname> <productnumber>5</productnumber> <abstract> Modified: epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Release_Notes.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Release_Notes.xml 2010-10-26 04:48:15 UTC (rev 4830) +++ epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Release_Notes.xml 2010-10-26 06:37:47 UTC (rev 4831) @@ -186,173 +186,17 @@ </para> <variablelist> <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-452"></ulink>... + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-XYZ"></ulink>... <listitem> <para> - &PRODUCT;'s <literal>request.getLocale()</literal> was only reflecting a user's browser language preference, regardless of what language was set in the portal itself. + </para> - <para> - A fix was installed to address this issue and return values that are aligned with the rest of the portal. - </para> - <para> - As a result, portlets use the preferred locale of the portal user and not the locale from the http servlet request. - </para> <para> Refer to the source commit logs in the above JIRA for specific code changes in this fix. </para> </listitem> </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-403"></ulink>... - <listitem> - <para> - The language fix implemented for <ulink type="http" url="https://jira.jboss.org/browse/JBEPP-452"></ulink> also corrected an issue wherein a failed login attempt would present the login form in an incorrect language (that is; not the language set for the portal). - </para> - <para> - Refer to the source commit logs in the above JIRA for specific code changes in this fix. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-383"></ulink>... - <listitem> - <para> - The language fix also corrected an issue which caused language settings for languages with country variants (such as Chinese - China and Chinese - Taiwan) were not stored between logins. - </para> - <para> - Refer to the source commit logs in the above JIRA for specific code changes in this fix. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-393"></ulink>... - <listitem> - <para> - The Shindig Gadget Server was reporting malformed security tokens after a gadget was added to a portal. The error was originating from the <literal>org.apache.shindig.gadgets.servlet.RpcServlet</literal>'s <literal>doPost</literal> processing method. This method of reading POST requests from the servlet's input stream was being corrupted if the <literal>InputStream</literal> had already been read (in the recorded case, by <literal>RequestDumperValve</literal>). - </para> - <para> - This error was resolved with a patch to Apache Shindig which allows a reset of the input stream before the <literal>doPost</literal> method is invoked. - </para> - <para> - Refer to the source commit logs in the above JIRA for specific code changes in this fix. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-390"></ulink>... - <listitem> - <para> - A bug in PicketLink IDM meant that changing the LDAP group membership type of a user to anything other than 'member' would appear to delete that user from the group. This was caused by the PicketLink IDM UI not showing any memberships other than 'member', even if other types were correctly retained in the underlying database. - </para> - <para> - This issue has been fixed with an updated PicketLink jar. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-363"></ulink>... - <listitem> - <para> - The updated PicketLink jar has also resolved an issue encountered when deleting registered portal users from LDAP. - </para> - <para> - Information about users deleted from LDAP would still be retained in the database and those user accounts would appear in the portal user list. If one of these legacy accounts was then edited, the inconsistences would prevent any further login attempts from succeeding until the user session was cleared. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-477"></ulink>... - <listitem> - <para> - The updated PicketLink IDM component removes case-sensitivity from the username field of the portal login page. - </para> - <para> - This allows users whose login names contain capital letters to authenticate successfully, regardless of the case used in the username field of the login form. - </para> - <para> - Note that the password field remains case-sensitive for security. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-368"></ulink>... - <listitem> - <para> - The datasource defined in <filename>jboss-epp-5.0/jboss-as/docs/examples/portal/gatein-sample-portal-ds.xml</filename> has been updated from <literal>local-tx-datasource</literal> to <literal>no-tx-datasource</literal>. - </para> - <para> - This update prevents exceptions being thrown by the JCR when the name of the datasource in <filename>server/default/deploy/gatein-ds.xml</filename> is changed to suit operational requirements. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-342"></ulink>... - <listitem> - <para> - Node names were being displayed incorrectly if they contained accentuated characters. For example; if the site language was German, the SiteMap node would display as <literal>Seiten&amp;uuml&semi;bersicht</literal> instead of <emphasis role="bold">Seitenübersicht</emphasis>. - </para> - <para> - Language <filename>.properties</filename> files have been updated to escape special characters correctly and languages that contain special characters now render as expected. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-192"></ulink>... - <listitem> - <para> - When changing a portlet title it was possible to exploit an XSS vulnerability. A fix has been applied to encode the content before rendering. - </para> - <para> - Refer to the source commit logs in the above JIRA for specific code changes in this fix. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-167"></ulink>... - <listitem> - <para> - A bug in the IBM JDK (1.5) prevented &PRODUCT; from starting correctly when using the <literal>default</literal> configuration profile. - </para> - <para> - This release includes a copy of the <filename>jcip-annotations.jar</filename> in the <filename>/server/default/lib</filename> directory as a workaround. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-448"></ulink>... - <listitem> - <para> - Users and group management replication was not successful in a clustered environment, producing the following exception: - </para> -<programlisting language="Java">java.io.NotSerializableException: Type TypeModel[name=org.exoplatform.commons.utils.LazyPageList] is not serializable - at org.exoplatform.commons.serialization.serial.ObjectWriter.write(ObjectWriter.java:209) - at org.exoplatform.commons.serialization.serial.ObjectWriter.write(ObjectWriter.java:82) - at org.exoplatform.commons.serialization.serial.ObjectWriter.replaceObject(ObjectWriter.java:238) -</programlisting> - <para> - The issue has been corrected in this release as the relevant classes have been made serializable. - </para> - <para> - Refer to the source commit logs in the above JIRA for specific code changes in this fix. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-470"></ulink>... - <listitem> - <para> - Adding a WSRP portlet to a category using the application registry was leading to the following exception: - </para> -<programlisting language="Java">ERROR [portal:UIPortalApplication] Error during the processAction phase -org.chromattic.api.UndeclaredRepositoryException: javax.jcr.RepositoryException: Illegal path entry: "app:": Illegal path entry: "app:": Illegal path entry: "app:"</programlisting> - <para> - This has been resolved with code that properly handles the '/' character in an application name. - </para> - <para> - Refer to the source commit logs in the above JIRA for specific code changes in this fix. - </para> - </listitem> - </varlistentry> + </variablelist> </section> Modified: epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Revision_History.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Revision_History.xml 2010-10-26 04:48:15 UTC (rev 4830) +++ epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Revision_History.xml 2010-10-26 06:37:47 UTC (rev 4831) @@ -6,6 +6,20 @@ <simpara> <revhistory> <revision> + <revnumber>1-1.1</revnumber> + <date>Tue Oct 26 2010</date> + <author> + <firstname>Scott</firstname> + <surname>Mumford</surname> + <email&gt;smumford(a)redhat.com&lt;/email&gt; + </author> + <revdescription> + <simplelist> + <member>Rebuilt for new Publican version features.</member> + </simplelist> + </revdescription> + </revision> + <revision> <revnumber>1-1.0</revnumber> <date>Fri Sep 03 2010</date> <author> Modified: epp/docs/branches/EPP_5_1_Branch/Site_Publisher_User_Guide/en-US/Book_Info.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Site_Publisher_User_Guide/en-US/Book_Info.xml 2010-10-26 04:48:15 UTC (rev 4830) +++ epp/docs/branches/EPP_5_1_Branch/Site_Publisher_User_Guide/en-US/Book_Info.xml 2010-10-26 06:37:47 UTC (rev 4831) @@ -4,9 +4,9 @@ %BOOK_ENTITIES; ]> <bookinfo id="book-Site_Publisher_User_Guide"> - <title>Site Publisher User Guide</title> - <subtitle>A guide to the basic usage of the JBoss Enterprise Portal Platform Site Publisher extension</subtitle> - <productname>JBoss Enterprise Portal Platform</productname> + <title>User Guide</title> + <subtitle>A guide to the basic usage of the Site Publisher extension for JBoss Enterprise Portal Platform</subtitle> + <productname>JBoss Site Publisher</productname> <productnumber>5</productnumber> <edition>1</edition> <pubsnumber>2.0</pubsnumber> Deleted: epp/docs/branches/EPP_5_1_Branch/Site_Publisher_User_Guide/en-US/Site_Publisher_User_Guide.ent =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Site_Publisher_User_Guide/en-US/Site_Publisher_User_Guide.ent 2010-10-26 04:48:15 UTC (rev 4830) +++ epp/docs/branches/EPP_5_1_Branch/Site_Publisher_User_Guide/en-US/Site_Publisher_User_Guide.ent 2010-10-26 06:37:47 UTC (rev 4831) @@ -1,4 +0,0 @@ -<!ENTITY PRODUCT "JBoss Enterprise Portal Platform"> -<!ENTITY BOOKID "Site_Publisher_User_Guide"> -<!ENTITY YEAR "2010"> -<!ENTITY HOLDER "Red Hat, Inc"> Deleted: epp/docs/branches/EPP_5_1_Branch/Site_Publisher_User_Guide/en-US/Site_Publisher_User_Guide.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Site_Publisher_User_Guide/en-US/Site_Publisher_User_Guide.xml 2010-10-26 04:48:15 UTC (rev 4830) +++ epp/docs/branches/EPP_5_1_Branch/Site_Publisher_User_Guide/en-US/Site_Publisher_User_Guide.xml 2010-10-26 06:37:47 UTC (rev 4831) @@ -1,17 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ -<!ENTITY % BOOK_ENTITIES SYSTEM "Site_Publisher_User_Guide.ent"> -%BOOK_ENTITIES; -]> -<book> - <xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="Preamble.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="Introduction.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="Usage.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="Administration.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="Next.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <index /> -</book> - Added: epp/docs/branches/EPP_5_1_Branch/Site_Publisher_User_Guide/en-US/User_Guide.ent =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Site_Publisher_User_Guide/en-US/User_Guide.ent (rev 0) +++ epp/docs/branches/EPP_5_1_Branch/Site_Publisher_User_Guide/en-US/User_Guide.ent 2010-10-26 06:37:47 UTC (rev 4831) @@ -0,0 +1,4 @@ +<!ENTITY PRODUCT "JBoss Enterprise Portal Platform"> +<!ENTITY BOOKID "Site_Publisher_User_Guide"> +<!ENTITY YEAR "2010"> +<!ENTITY HOLDER "Red Hat, Inc"> Added: epp/docs/branches/EPP_5_1_Branch/Site_Publisher_User_Guide/en-US/User_Guide.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Site_Publisher_User_Guide/en-US/User_Guide.xml (rev 0) +++ epp/docs/branches/EPP_5_1_Branch/Site_Publisher_User_Guide/en-US/User_Guide.xml 2010-10-26 06:37:47 UTC (rev 4831) @@ -0,0 +1,17 @@ +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!ENTITY % BOOK_ENTITIES SYSTEM "Site_Publisher_User_Guide.ent"> +%BOOK_ENTITIES; +]> +<book> + <xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="Preamble.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="Introduction.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="Usage.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="Administration.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="Next.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <index /> +</book> + Modified: epp/docs/branches/EPP_5_1_Branch/User_Guide/en-US/Book_Info.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/User_Guide/en-US/Book_Info.xml 2010-10-26 04:48:15 UTC (rev 4830) +++ epp/docs/branches/EPP_5_1_Branch/User_Guide/en-US/Book_Info.xml 2010-10-26 06:37:47 UTC (rev 4831) @@ -7,7 +7,7 @@ <productname>JBoss Enterprise Portal Platform</productname> <productnumber>5</productnumber> <edition>1</edition> - <pubsnumber>2.7</pubsnumber> + <pubsnumber>2.8</pubsnumber> <abstract> <para> This document provides an easy to follow guide to the functions and Modified: epp/docs/branches/EPP_5_1_Branch/User_Guide/en-US/Revision_History.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/User_Guide/en-US/Revision_History.xml 2010-10-26 04:48:15 UTC (rev 4830) +++ epp/docs/branches/EPP_5_1_Branch/User_Guide/en-US/Revision_History.xml 2010-10-26 06:37:47 UTC (rev 4831) @@ -8,7 +8,21 @@ <simpara> <revhistory> <revision> - <revnumber>2.7</revnumber> + <revnumber>1-2.8</revnumber> + <date>Tue Oct 26 2010</date> + <author> + <firstname>Scott</firstname> + <surname>Mumford</surname> + <email&gt;smumford(a)redhat.com&lt;/email&gt; + </author> + <revdescription> + <simplelist> + <member>Rebuilt for new Publican version features.</member> + </simplelist> + </revdescription> + </revision> + <revision> + <revnumber>1-2.7</revnumber> <date>Thu Sep 30 2010</date> <author> <firstname>Scott</firstname> @@ -22,7 +36,7 @@ </revdescription> </revision> <revision> - <revnumber>2.6</revnumber> + <revnumber>1-2.6</revnumber> <date>Fri Sep 10 2010</date> <author> <firstname>Scott</firstname> @@ -36,7 +50,7 @@ </revdescription> </revision> <revision> - <revnumber>2.5</revnumber> + <revnumber>1-2.5</revnumber> <date>Mon May 10 2010</date> <author> <firstname>Scott</firstname> @@ -51,7 +65,7 @@ </revision> <revision> - <revnumber>2.0</revnumber> + <revnumber>1-2.0</revnumber> <date>Sat Mar 20 2010</date> <author> <firstname>Scott</firstname> @@ -65,7 +79,7 @@ </revdescription> </revision> <revision> - <revnumber>1.5</revnumber> + <revnumber>1-1.5</revnumber> <date>Tue Jan 19 2010</date> <author> <firstname>Scott</firstname> @@ -79,7 +93,7 @@ </revdescription> </revision> <revision> - <revnumber>1.1</revnumber> + <revnumber>1-1.1</revnumber> <date>Mon Dec 07 2009</date> <author> <firstname>Scott</firstname> @@ -93,7 +107,7 @@ </revdescription> </revision> <revision> - <revnumber>1</revnumber> + <revnumber>1-1.0</revnumber> <date>Thu Nov 19 2009</date> <author> <firstname>Scott</firstname> @@ -107,7 +121,7 @@ </revdescription> </revision> <revision> - <revnumber>0</revnumber> + <revnumber>1-0</revnumber> <date>Tue Nov 17 2009</date> <author> <firstname>Scott</firstname>