From do-not-reply at jboss.org Wed Nov 30 13:02:56 2011
Content-Type: multipart/mixed; boundary="===============0747235863135642784=="
MIME-Version: 1.0
From: do-not-reply at jboss.org
To: gatein-commits at lists.jboss.org
Subject: [gatein-commits] gatein SVN: r8166 -
 portal/trunk/docs/reference-guide/en-US/modules.
Date: Wed, 30 Nov 2011 13:02:56 -0500
Message-ID: <201111301802.pAUI2ubg010930@svn01.web.mwc.hst.phx2.redhat.com>

--===============0747235863135642784==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable

Author: chris.laprun(a)jboss.com
Date: 2011-11-30 13:02:55 -0500 (Wed, 30 Nov 2011)
New Revision: 8166

Modified:
   portal/trunk/docs/reference-guide/en-US/modules/WSRP.xml
Log:
- GTNWSRP-267: Added section on using pages.xml and <wsrp> to add a remote =
portlet to a page.

Modified: portal/trunk/docs/reference-guide/en-US/modules/WSRP.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- portal/trunk/docs/reference-guide/en-US/modules/WSRP.xml	2011-11-30 17:=
11:28 UTC (rev 8165)
+++ portal/trunk/docs/reference-guide/en-US/modules/WSRP.xml	2011-11-30 18:=
02:55 UTC (rev 8166)
@@ -778,8 +778,7 @@
 =

             </example>
 =

-            <para>Here is an example of a WSRP descriptor with registratio=
n data and cache expiring every minute:
-            </para>
+            <para>Here is an example of a WSRP descriptor with registratio=
n data and cache expiring every minute:</para>
 =

             <example>
                <para>
@@ -841,6 +840,109 @@
             </mediaobject>
          </para>
       </sect2>
+
+      <sect2>
+         <title>Adding remote portlets to pages</title>
+         <para>
+            Since remote portlets can be manipulated just like regular por=
tlets, you can add them to pages just like you
+            would do for a regular portlet. Please refer to the appropriat=
e section of the documentation for how to do
+            so.
+         </para>
+         <para>
+            Of note, though, is that, starting with version 3.2 of GateIn =
(5.2 of EPP), it is now possible to also add a
+            remote portlet to a
+            <filename>pages.xml</filename>
+            configuration file.
+            This is accomplished using the
+            <literal>&lt;wsrp&gt;</literal>
+            element instead of the
+            <literal>&lt;portlet&gt;</literal>
+            element in your
+            <filename>pages.xml</filename>
+            document. While
+            <literal>&lt;portlet&gt;</literal>
+            references a local portlet using the name of the application i=
n which the portlet is contained and the
+            portlet name itself to identify which portlet to use,
+            <literal>&lt;wsrp&gt;</literal>
+            references a remote portlet using a combination of the consume=
r identifier for the producer publishing the
+            portlet and the portlet handle identifying the portlet within =
the context of the producer.
+         </para>
+         <para>
+            The format for such a reference to a remote portlet is a follo=
ws: first, the identifier of the
+            consumer that accesses the remote producer publishing the remo=
te portlet, then a separator (currently a
+            period (<literal>.</literal>)) and finally the portlet handle =
for that
+            portlet, which is a string provided by the producer to identif=
y the portlet.
+         </para>
+         <para>
+            Since there currently is no easy way to determine the correct =
portlet handle, we recommend that you use the
+            graphical user interface to add remote portlets to pages inste=
ad of using
+            <filename>pages.xml</filename>.
+         </para>
+         <note>
+            <para>
+               For remote portlets published by &PRODUCT_NAME;'s WSRP prod=
ucer, the portlet handles are, at
+               the time of this writing, following the
+               <literal>/&lt;portlet application name&gt;.&lt;portlet name=
&gt;</literal>
+               format.
+            </para>
+         </note>
+         <sect3>
+            <title>Example</title>
+            <para>
+               In the following example, we define 2 portlets for a page n=
amed
+               <literal>Test</literal>
+               in our
+               <filename>pages.xml</filename>
+               configuration. They are actually references to the same por=
tlet, albeit one accessed locally and the
+               other
+               one accessing it via the
+               <literal>selfv2</literal>
+               consumer which consumes &PRODUCT_NAME;'s WSRP producer. You=
 can see that the first one is local (the
+               <code>&lt;portlet-application&gt;</code>
+               with the
+               '<literal>Added locally</literal>'
+               title) and follows the usual declaration. The second portle=
t (the one with the
+               '<literal>Added from selfv2 consumer</literal>'
+               title) comes from the
+               <literal>selfv2</literal>
+               consumer and uses the
+               <code>&lt;wsrp&gt;</code>
+               element instead of
+               <code>&lt;portlet&gt;</code>
+               element and follows the format for portlets coming from the=
 &PRODUCT_NAME;'s WSRP producer.
+            </para>
+            <example>
+               <para>
+                  <programlisting><![CDATA[
+<page>
+   <name>Test</name>
+
+   ...
+
+   <portlet-application>
+      <portlet>
+         <application-ref>richFacesPortlet</application-ref>
+         <portlet-ref>richFacesPortlet</portlet-ref>
+      </portlet>
+      <title>Added locally</title>
+
+      ...
+
+   </portlet-application>
+
+   <portlet-application>
+      <wsrp>selfv2./richFacesPortlet.richFacesPortlet</wsrp>
+      <title>Added from selfv2 consumer</title>
+
+      ...
+
+   </portlet-application>
+</page>]]></programlisting>
+               </para>
+            </example>
+         </sect3>
+
+      </sect2>
    </sect1>
 =

    <sect1>


--===============0747235863135642784==--