[gatein-commits] gatein SVN: r2932 - in portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US: modules and 2 other directories.

Author: thomas.heute(a)jboss.com Date: 2010-05-03 06:44:14 -0400 (Mon, 03 May 2010) New Revision: 2932 Removed: portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortalDevelopment/AjaxLoadingMaskLayerDeactivation.xml portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortalDevelopment/UploadComponent.xml Modified: portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/Reference_Guide.xml portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/Introduction.xml portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortalDevelopment.xml portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortalDevelopment/DefaultPortalNavigationConfiguration.xml portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortalDevelopment/Skinning.xml portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortletDevelopment/PortletBridge/configuration.xml portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortletDevelopment/PortletBridge/gettingstarted.xml Log: JBEPP-276: Reference Guide Minor fixes Portlet Bridge review Removed some WebUI chapters Modified: portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/Reference_Guide.xml =================================================================== --- portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/Reference_Guide.xml 2010-05-03 09:24:25 UTC (rev 2931) +++ portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/Reference_Guide.xml 2010-05-03 10:44:14 UTC (rev 2932) @@ -14,6 +14,5 @@ <xi:include href="modules/WSRP.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="modules/Advanced.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: portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/Introduction.xml =================================================================== --- portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/Introduction.xml 2010-05-03 09:24:25 UTC (rev 2931) +++ portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/Introduction.xml 2010-05-03 10:44:14 UTC (rev 2932) @@ -6,7 +6,7 @@ <chapter id="chap-Reference_Guide-Introduction"> <title>Introduction</title> <para> - &PRODUCT; is the merge of two mature Java projects; JBoss Portal and eXo Portal. This new community project takes the best of both offerings and incorporates them into a single portal framework. The aim is to provide an intuitive user-friendly portal, and a framework to address the needs of today's Web 2.0 applications. + GateIn on which is based &PRODUCT; is the merge of two mature Java projects; JBoss Portal and eXo Portal. This new community project takes the best of both offerings and incorporates them into a single portal framework. The aim is to provide an intuitive user-friendly portal, and a framework to address the needs of today's Web 2.0 applications. </para> <mediaobject> <imageobject role="html"> Deleted: portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortalDevelopment/AjaxLoadingMaskLayerDeactivation.xml =================================================================== --- portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortalDevelopment/AjaxLoadingMaskLayerDeactivation.xml 2010-05-03 09:24:25 UTC (rev 2931) +++ portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortalDevelopment/AjaxLoadingMaskLayerDeactivation.xml 2010-05-03 10:44:14 UTC (rev 2932) @@ -1,98 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ -<!ENTITY % BOOK_ENTITIES SYSTEM "Reference_Guide.ent"> -%BOOK_ENTITIES; -]> -<chapter id="chap-Reference_Guide-Deactivation_of_the_Ajax_Loading_Mask_Layer_"> - <title>Deactivation of the Ajax Loading Mask Layer </title> - <!-- <section id="sect-Reference_Guide-Deactivation_of_the_Ajax_Loading_Mask_Layer_-Overview"> - <title>Overview</title> - <para> - In this article, you will learn: - </para> - <itemizedlist> - <listitem> - <para> - Purpose of ajax-loading mask. - </para> - </listitem> - <listitem> - <para> - How to deactivate ajax-loading mask. - </para> - </listitem> - <listitem> - <para> - Synchronous / Asynchronous issue. - </para> - </listitem> - </itemizedlist> - </section> --> - <section id="sect-Reference_Guide-Deactivation_of_the_Ajax_Loading_Mask_Layer_-Purpose"> - <title>Purpose</title> - <para> - The loading mask layer is deployed after an ajax-call. Its purpose is to block the GUI in order to prevent further user actions until the the ajax-request has been completed. - </para> - <para> - However, the mask layer may need to be deactivated in instances where the portal requires user instructions before previous instructions have been carried out. - </para> - <procedure id="proc-Reference_Guide-Purpose-How_to_Deactivate_the_Ajax_Loading_Mask"> - <title>How to Deactivate the Ajax-Loading Mask</title> - <step> - <para> - Generate a script to make an asynchronous ajax-call. Use the <literal>uicomponent.doAsync()</literal> method rather than the <literal>uicomponent.event()</literal> method. - </para> - <para> - For example: - </para> - -<programlisting>&lt;a href="&lt;%=uicomponent.doAsync(action, beanId, params)%&gt;" alt=""&gt;Asynchronous&lt;/a&gt; -</programlisting> - </step> - <step> - <para> - The <literal>doAsync()</literal> method automatically adds the following new parameter into the parameters list; <literal>asyncparam = new Parameter(AJAX ASYNC,"true"); (AJAX ASYNC == "ajax async")</literal> - </para> - <para> - This request is asynchronous and the ajax-loading mask will not deployed. - </para> - <note> - <title>Asynchronous Requests Using <literal>uicomponent.event()</literal></title> - <para> - An asynchronous request can still be made using the <literal>uicomponent.event()</literal>. When using this method, however, the <literal>asyncparam</literal> must be added manually. - </para> - </note> - </step> - </procedure> - - <para> - The GUI will be blocked to ensure a user can only request one action at a time and while the request seems to be synchronous, all ajax requests are, in fact, always asynchronous. For further information refer to <xref linkend="sect-Reference_Guide-Deactivation_of_the_Ajax_Loading_Mask_Layer_-Synchronous_issue" />. - </para> - </section> - - <section id="sect-Reference_Guide-Deactivation_of_the_Ajax_Loading_Mask_Layer_-Synchronous_issue"> - <title>Synchronous issue</title> - <para> - Most web browsers support ajax requests in two modes: <emphasis>Synchronous</emphasis> and <emphasis>Asynchronous</emphasis>. This mode is specified with a boolean <literal>bAsync</literal> parameter. - </para> - -<programlisting>var bAsync = false; // Synchronous -request.open(instance.method, instance.url, bAsync); -</programlisting> - <para> - However, in order to work with browsers that do not support <emphasis>Synchronous</emphasis> requests, <literal>bAsync</literal> is set to always be true (Ajax request will always be asynchronous). - </para> - <!-- -<programlisting>var bAsync = false; // Synchronous -request.open(instance.method, instance.url, bAsync); // Firefox will not execute -</programlisting> - <para> - So - </para> --> -<programlisting>// Asynchronous request -request.open(instance.method, instance.url, true); -</programlisting> - </section> - -</chapter> - Modified: portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortalDevelopment/DefaultPortalNavigationConfiguration.xml =================================================================== --- portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortalDevelopment/DefaultPortalNavigationConfiguration.xml 2010-05-03 09:24:25 UTC (rev 2931) +++ portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortalDevelopment/DefaultPortalNavigationConfiguration.xml 2010-05-03 10:44:14 UTC (rev 2932) @@ -262,7 +262,6 @@ <listitem> <para> Porlet instances can be associated with <literal>portlet-preferences</literal> that override the ones defined in <filename>portlet.xml</filename> of the portlet application <literal>war</literal>. - (TODO: clarify which file in which war). </para> <programlisting role="XML">&lt;?xml version="1.0" encoding="ISO-8859-1"?&gt; Modified: portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortalDevelopment/Skinning.xml =================================================================== --- portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortalDevelopment/Skinning.xml 2010-05-03 09:24:25 UTC (rev 2931) +++ portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortalDevelopment/Skinning.xml 2010-05-03 10:44:14 UTC (rev 2932) @@ -30,7 +30,7 @@ <term>Window Styles</term> <listitem> <para> - The CSS styles associated with the porlet window decorators. The window decorators contain the control buttons and boarders surrounding each portlet. Individual portlets can have their own window decorator selected, or be rendered without one. + The CSS styles associated with the porlet window decorators. The window decorators contain the control buttons and borders surrounding each portlet. Individual portlets can have their own window decorator selected, or be rendered without one. </para> </listitem> </varlistentry> @@ -170,7 +170,7 @@ &PRODUCT; automatically discovers web archives that contain a file descriptor for skins (<filename>WEB-INF/gatein-resources.xml</filename>). This file is reponsible for specifying the portal, portlet and window decorators to be deployed into the skin service. </para> <para> - The full schema can be found in the lib directory: <filename>exo.portal.component.portal.jar/gatein_resources_1_0.xsd</filename>. + The full schema can be found at: <ulink type="http" url="http://www.gatein.org/xml/ns/gatein_resources_1_0"/>;. </para> <para> Deleted: portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortalDevelopment/UploadComponent.xml =================================================================== --- portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortalDevelopment/UploadComponent.xml 2010-05-03 09:24:25 UTC (rev 2931) +++ portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortalDevelopment/UploadComponent.xml 2010-05-03 10:44:14 UTC (rev 2932) @@ -1,155 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ -<!ENTITY % BOOK_ENTITIES SYSTEM "Reference_Guide.ent"> -%BOOK_ENTITIES; -]> -<chapter id="chap-Reference_Guide-Upload_Component"> - <title>Upload Component</title> - <!-- <section id="sect-Reference_Guide-Upload_Component-Overview"> - <title>Overview</title> - <para> - In this article, you will learn how to : - </para> - <itemizedlist> - <listitem> - <para> - configure the Upload service - </para> - </listitem> - <listitem> - <para> - add a default upload size limit - </para> - </listitem> - <listitem> - <para> - use the Upload component in your application, with a specific upload size limit - </para> - </listitem> - <listitem> - <para> - clean the service when the upload finishes - </para> - </listitem> - </itemizedlist> - </section> --> - <section id="sect-Reference_Guide-Upload_Component-Upload_Service"> - <title>Upload Service</title> - <para> - This service is defined by the class: <literal>org.exoplatform.upload.UploadService</literal>; - </para> - <para> - This can be configured with the following xml code: - </para> - -<programlisting role="XML">&lt;component&gt; - &lt;type&gt;org.exoplatform.upload.UploadService&lt;/type&gt; - &lt;init-params&gt; - &lt;value-param&gt; - &lt;name&gt;upload.limit.size&lt;/name&gt; - &lt;description&gt;Maximum size of the file to upload in MB&lt;/description&gt; - &lt;value&gt;10&lt;/value&gt; - &lt;/value-param&gt; - &lt;/init-params&gt; - &lt;/component&gt; -</programlisting> - <para> - This code allows for a default upload size limit for the service to be configured. The value unit is in MegaBytes. - </para> - <para> - This limit will be used by default by all applications if no application-specific limit is set. Setting a different limit for applications is discussed in a later section. - </para> - <para> - If the value is set at <parameter>0</parameter> the upload size is unlimited. - </para> - <procedure id="proc-Reference_Guide-Upload_Service-How_to_use_the_upload_component"> - <title>How to use the upload component</title> - <step> - <para> - Create an object type <literal>org.exoplatform.webui.form.UIFormUploadInput</literal>. - </para> - <para> - Two constructors are available for this: - </para> - -<programlisting>public UIFormUploadInput(String name, String bindingExpression) -</programlisting> - <para> - or: - </para> - -<programlisting>public UIFormUploadInput(String name, String bindingExpression, int limit) -</programlisting> - <para> - This is an example using the second form : - </para> - -<programlisting role="JAVA">PortletRequestContext pcontext = (PortletRequestContext)WebuiRequestContext.getCurrentInstance(); -PortletPreferences portletPref = pcontext.getRequest().getPreferences(); -int limitMB = Integer.parseInt(portletPref.getValue("uploadFileSizeLimitMB", "").trim()); -UIFormUploadInput uiInput = new UIFormUploadInput("upload", "upload", limitMB); -</programlisting> - </step> - <step> - <para> - To obtain the limit from the <literal>xml</literal> configuration, this piece of code can be added to the either <filename>portlet.xml</filename> or <filename>portlet-preferences.xml</filename> : - </para> - -<programlisting role="XML">&lt;preference&gt; - &lt;name&gt;uploadFileSizeLimitMB&lt;/name&gt; - &lt;value&gt;30&lt;/value&gt; - &lt;read-only&gt;false&lt;/read-only&gt; -&lt;/preference&gt; -</programlisting> - <para> - Again, a <parameter>0</parameter> value means an unlimited upload size, and the value unit is set in MegaBytes. - </para> - </step> - <step> - <para> - Use the <literal>getUploadDataAsStream()</literal> method to get the uploaded data: - </para> - -<programlisting role="JAVA">UIFormUploadInput input = (UIFormUploadInput)uiForm.getUIInput("upload"); -InputStream inputStream = input.getUploadDataAsStream(); -... -jcrData.setValue(inputStream); -</programlisting> - </step> - <step> - <para> - The upload service stores a temporary file on the file system during the upload process. When the upload is finished, the service must be cleaned in order to: - </para> - <orderedlist numeration="arabic"> - <listitem> - <para> - Delete the temporary file and... - </para> - </listitem> - <listitem> - <para> - Delete the classes used for the upload. - </para> - </listitem> - </orderedlist> - <para> - Use the <literal>removeUpload()</literal> method defined in the upload service to purge the file: - </para> - -<programlisting role="JAVA">UploadService uploadService = uiForm.getApplicationComponent(UploadService.class) ; -UIFormUploadInput uiChild = uiForm.getChild(UIFormUploadInput.class) ; -uploadService.removeUpload(uiChild.getUploadId()) ; -</programlisting> - <note> - <title>Saving the uploaded file</title> - <para> - Ensure the file is saved <emphasis role="bold">before</emphasis> the service is cleaned. - </para> - </note> - </step> - </procedure> - - </section> - -</chapter> - Modified: portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortalDevelopment.xml =================================================================== --- portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortalDevelopment.xml 2010-05-03 09:24:25 UTC (rev 2931) +++ portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortalDevelopment.xml 2010-05-03 10:44:14 UTC (rev 2932) @@ -1,6 +1,6 @@ <?xml version='1.0' encoding='utf-8' ?> <!DOCTYPE part PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ -<!ENTITY % BOOK_ENTITIES SYSTEM "Reference_Guide.ent"> +<!ENTITY % BOOK_ENTITIES SYSTEM "../Reference_Guide.ent"> %BOOK_ENTITIES; ]> <part id="part-Reference_Guide-Portal_Development"> @@ -14,8 +14,6 @@ <xi:include href="PortalDevelopment/RTLFramework.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="PortalDevelopment/XMLResourceBundles.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="PortalDevelopment/JavascriptInterApplicationCommunication.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="PortalDevelopment/UploadComponent.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="PortalDevelopment/AjaxLoadingMaskLayerDeactivation.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="PortalDevelopment/JavascriptConfiguration.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> </part> Modified: portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortletDevelopment/PortletBridge/configuration.xml =================================================================== --- portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortletDevelopment/PortletBridge/configuration.xml 2010-05-03 09:24:25 UTC (rev 2931) +++ portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortletDevelopment/PortletBridge/configuration.xml 2010-05-03 10:44:14 UTC (rev 2932) @@ -305,7 +305,7 @@ <section id="sect-Reference_Guide-Sending_and_Receiving_Events-Configuration"> <title>Configuration</title> <para> - Just like with any portlet 2.0 event consumer and receiver, you must define them in the portlet.xml. To see a working example, checkout the Seam Booking Demo portlet. <ulink url="http://anonsvn.jboss.org/repos/portletbridge/tags/2.0.0.CR1/exa... /> + Just like with any portlet 2.0 event consumer and receiver, you must define them in the portlet.xml. To see a working example, checkout the Seam Booking Demo portlet. <ulink url="http://anonsvn.jboss.org/repos/portletbridge/tags/2.0.0.FINAL/e... /> </para> <para> You must also define the following init params in your portlet.xml. @@ -358,7 +358,7 @@ Public Render Parameters (or PRPs) are one of the most powerful and simple Portlet 2.0 features. Several portlets (JSF or not) can share the same render parameters. This feature can be use to present a cohesive UI to the user across all portlets on the page (i.e. using an employee ID to display relative data). </para> <para> - The bridge maps a render parameter to a backing bean using settings in your faces-config.xml and portlet.xml. A clear and working example can be found in the Seam Booking Demo portlet. <ulink url="http://anonsvn.jboss.org/repos/portletbridge/tags/2.0.0.CR1/exa... /> + The bridge maps a render parameter to a backing bean using settings in your faces-config.xml and portlet.xml. A clear and working example can be found in the Seam Booking Demo portlet. <ulink url="http://anonsvn.jboss.org/repos/portletbridge/tags/2.0.0.FINAL/e... /> </para> <para> You must define the following init params in your portlet.xml. Modified: portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortletDevelopment/PortletBridge/gettingstarted.xml =================================================================== --- portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortletDevelopment/PortletBridge/gettingstarted.xml 2010-05-03 09:24:25 UTC (rev 2931) +++ portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Reference_Guide/en-US/modules/PortletDevelopment/PortletBridge/gettingstarted.xml 2010-05-03 10:44:14 UTC (rev 2932) @@ -48,7 +48,7 @@ The JBoss Portlet Bridge currently supports JBoss Portal, GateIn, JSF 1.2, JBoss Seam, and JBoss Richfaces. There are configurations that apply to supporting each framework. See section <xref linkend="sect-Reference_Guide-Bridge_Configuration" /> for instructions. </para> <para> - The JBoss Portlet Bridge project is also actively developing extensions, and to differentiate from just another "project" that has boring ol' "extensions" we coined the term "Bridgelets" - because what would a project with Java and JSF be without having "*let" on the end of it? Not very cool in my opinion ;) With that said, in this current release we decided to bring all of our bridgelets into the impl code base since they are critical in most JSF portlet applications. Now it only takes a single line of configuration to utilize these features. + The JBoss Portlet Bridge project is also actively developing extensions called "Bridgelets". In this current release we decided to bring all of our bridgelets into the impl code base since they are critical in most JSF portlet applications. Now it only takes a single line of configuration to utilize these features. </para> <section id="sect-Reference_Guide-Bridge_Frameworks_and_Extensions-Seam_Bridgelets"> <title>Seam Bridgelets</title> @@ -73,57 +73,6 @@ &lt;param-value&gt;true&lt;/param-value&gt; &lt;/context-param&gt; </programlisting> - <para> - <!-- <table frame='all'> - <title>Available Bridgelets</title> - <tgroup cols='5' align='left' colsep='1' rowsep='1'> - <colspec colname='c1'/> - <colspec colname='c2'/> - <colspec colname='c3'/> - <colspec colnum='5' colname='c5'/> - <thead> - <row> - <entry align="center">Bridgelet</entry> - <entry namest="c2" nameend="c5" align="center">Command</entry> - </row> - </thead> - <tbody> - <row class="table-odd" style="background-color:#D6DEE0;border:1px solid #E1E9EB;color:#334558;"> - <entry align="left">Single Sign On</entry> - <entry namest="c2" nameend="c5" align="left"> - <para>By inlcuding the following dependency in your web pom, you will automatically have SSO - between Jboss Portal and your Seam application. - <programlisting><![CDATA[ -<dependency> - <groupId>org.jboss.portletbridge.extensions.seam</groupId> - <artifactId>PortalIdentity</artifactId> - <version>2.0.0.BETA</version> -</dependency>]]> - </programlisting></para> - </entry> - </row> - <row class="table-even" style="background-color:#D6DEE0;border:1px solid #E1E9EB;color:#334558;"> - <entry align="left">RichFaces Javascript Compatibility</entry> - <entry namest="c2" nameend="c5" align="left"> - <para>Richfaces does not account for multiple components on the same portal page by default. This bridgelet - renders all RichFaces component javascript to be portal friendly. - <programlisting><![CDATA[ -<dependency> - <groupId>org.jboss.portletbridge.extensions.richfaces</groupId> - <artifactId>PortalResourceBuilder</artifactId> - <version>2.0.0.BETA</version> -</dependency>]]> - </programlisting> </para> - </entry> - </row> - </tbody> - </tgroup> - </table> --> - <note> - <para> - Don't forget that the bridge is still in Beta and so are any extensions. If you would like to contribute to any part of this project, we encourage you to be active on the <ulink url="http://www.jboss.com/index.html?module=bb&amp;op=viewforum&... forum</ulink> and bring issues/enhancements to attention. - </para> - </note> </para> </section> @@ -132,18 +81,11 @@ <section id="sect-Reference_Guide-Getting_started_with_JBoss_Portlet_Bridge-Before_you_start"> <title>Before you start</title> <para> - Current version and compatibilty information can be easily located on the <ulink url="http://www.jboss.org/community/wiki/JBossPortletBridge">... wiki</ulink>. Ensure you are using compatible versions of all integrated frameworks before you begin. - </para> + The embedded version in the &PRODUCT; is made to be compatible with the JSF implementation, portal and application server that compose the product. You will find the binaries embedded in <literal>jboss-epp-5.0/portletbridge</literal> + </para> <para> - JBoss Portal and GateIn provides it's latest distribution included in JBoss Application Server. All of the guesswork has been eliminated so that you can unzip and run the Portal with a few clicks. <ulink url="http://jboss.org/gatein/downloads.html">Get the latest here</ulink> (ensure you choose the Portal + JBoss AS link) + You can run a provided archetype <xref linkend="sect-Reference_Guide-Getting_started_with_JBoss_Portlet_Bridge-Maven_Archetypes" /> and deploy the generated war in a few easy steps. This will also give you an empty project to play around with or start from scratch. </para> - <para> - Next, all that's left is to download the <ulink url="http://www.jboss.org/portletbridge/download/">JBoss Portlet Bridge distribution</ulink> and cofigure your portlet to use the bridge. Or, you can run a provided archetype <xref linkend="sect-Reference_Guide-Getting_started_with_JBoss_Portlet_Bridge-Maven_Archetypes" /> and deploy the generated war in a few easy steps. This will also give you an empty project to play around with or start from scratch. - </para> - <!-- <para> - For system requirements and setting up your JBoss Portal environment see the - <ulink url="http://docs.jboss.com/jbportal/v2.6.4/referenceGuide/html_singl... guide</ulink>. - </para> --> </section> <section id="sect-Reference_Guide-Getting_started_with_JBoss_Portlet_Bridge-Maven_Archetypes"> @@ -177,10 +119,10 @@ <programlisting>mvn archetype:generate -DarchetypeGroupId=org.jboss.portletbridge.archetypes -DarchetypeArtifactId=1.2-basic - -DarchetypeVersion=2.0.0.CR1 + -DarchetypeVersion=2.0.0.FINAL -DgroupId=org.whatever.project -DartifactId=myprojectname - -DarchetypeRepository=http://repository.jboss.org/maven2/ + -DarchetypeRepository=https://repository.jboss.org/nexus/content/groups/public/ </programlisting> </entry> </row> @@ -193,10 +135,10 @@ <programlisting>mvn archetype:generate -DarchetypeGroupId=org.jboss.portletbridge.archetypes -DarchetypeArtifactId=richfaces-basic - -DarchetypeVersion=2.0.0.CR1 + -DarchetypeVersion=2.0.0.FINAL -DgroupId=org.whatever.project -DartifactId=myprojectname - -DarchetypeRepository=http://repository.jboss.org/maven2/ + -DarchetypeRepository=https://repository.jboss.org/nexus/content/groups/public/ </programlisting> </entry> </row> @@ -209,10 +151,10 @@ <programlisting>mvn archetype:generate -DarchetypeGroupId=org.jboss.portletbridge.archetypes -DarchetypeArtifactId=seam-basic - -DarchetypeVersion=2.0.0.CR1 + -DarchetypeVersion=2.0.0.FINAL -DgroupId=org.whatever.project -DartifactId=seamproject - -DarchetypeRepository=http://repository.jboss.org/maven2/ + -DarchetypeRepository=https://repository.jboss.org/nexus/content/groups/public/ </programlisting> </entry> </row>