[portal-commits] JBoss Portal SVN: r6302 - in docs/trunk/quickstartuser/en: modules and 1 other directory.

Author: roy.russo(a)jboss.com Date: 2007-02-15 11:37:59 -0500 (Thu, 15 Feb 2007) New Revision: 6302 Added: docs/trunk/quickstartuser/en/images/image108.jpg Modified: docs/trunk/quickstartuser/en/images/image084.jpg docs/trunk/quickstartuser/en/images/image085.jpg docs/trunk/quickstartuser/en/images/image086.jpg docs/trunk/quickstartuser/en/images/image087.jpg docs/trunk/quickstartuser/en/images/image088.jpg docs/trunk/quickstartuser/en/images/image091.jpg docs/trunk/quickstartuser/en/images/image092.jpg docs/trunk/quickstartuser/en/images/image093.jpg docs/trunk/quickstartuser/en/images/image094.jpg docs/trunk/quickstartuser/en/images/image095.jpg docs/trunk/quickstartuser/en/images/image096.jpg docs/trunk/quickstartuser/en/images/image098.jpg docs/trunk/quickstartuser/en/images/image100.jpg docs/trunk/quickstartuser/en/images/image103.jpg docs/trunk/quickstartuser/en/images/image106.jpg docs/trunk/quickstartuser/en/modules/deployportlet.xml docs/trunk/quickstartuser/en/modules/interaction.xml Log: JBPORTAL-1114 - updating quickstart guide Modified: docs/trunk/quickstartuser/en/images/image084.jpg =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image085.jpg =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image086.jpg =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image087.jpg =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image088.jpg =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image091.jpg =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image092.jpg =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image093.jpg =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image094.jpg =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image095.jpg =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image096.jpg =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image098.jpg =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image100.jpg =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image103.jpg =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image106.jpg =================================================================== (Binary files differ) Added: docs/trunk/quickstartuser/en/images/image108.jpg =================================================================== (Binary files differ) Property changes on: docs/trunk/quickstartuser/en/images/image108.jpg ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Modified: docs/trunk/quickstartuser/en/modules/deployportlet.xml =================================================================== --- docs/trunk/quickstartuser/en/modules/deployportlet.xml 2007-02-15 16:31:50 UTC (rev 6301) +++ docs/trunk/quickstartuser/en/modules/deployportlet.xml 2007-02-15 16:37:59 UTC (rev 6302) @@ -1,113 +1,153 @@ <?xml version="1.0" encoding="UTF-8"?> <chapter id="deployportlet"> - <chapterinfo> - <author> - <firstname>Kevin</firstname> + <chapterinfo> + <author> + <firstname>Kevin</firstname> - <surname>Barfield</surname> + <surname>Barfield</surname> - <email&gt;kevin.barfield(a)jboss.com&lt;/email&gt; - </author> - </chapterinfo> + <email&gt;kevin.barfield(a)jboss.com&lt;/email&gt; + </author> + </chapterinfo> - <title>Deploying Portlets</title> + <title>Deploying Portlets</title> - <para>Let's add a portlet from Portletswap to the JBoss Portal we have - running. Open a browser to the following URL: <ulink - url="http://www.portletswap.com">http://www.portletswap.com</ulink> (Figure - 47). <mediaobject> - <imageobject> - <imagedata align="center" fileref="images/image089.png" format="png" - valign="middle" /> - </imageobject> + <para>Let's add a portlet from Portletswap to the JBoss Portal we have + running. Open a browser to the following URL: + <ulink + url="http://www.portletswap.com">http://www.portletswap.com + </ulink> + (Figure + 47). + <mediaobject> + <imageobject> + <imagedata align="center" fileref="images/image089.png" format="png" + valign="middle"/> + </imageobject> - <caption><para>Figure 47. Portletswap website</para></caption> - </mediaobject> Click on the "Browse Portlets" link to see the categories - of portlets available (Figure 48). <mediaobject> - <imageobject> - <imagedata align="left" fileref="images/image101.jpg" format="JPG" - valign="middle" /> - </imageobject> + <caption> + <para>Figure 47. Portletswap website</para> + </caption> + </mediaobject> + Click on the "Browse Portlets" link to see the categories + of portlets available (Figure 48). + <mediaobject> + <imageobject> + <imagedata align="left" fileref="images/image101.jpg" format="JPG" + valign="middle"/> + </imageobject> - <caption><para>Figure 48. Portlet categories on - portletswap.</para></caption> - </mediaobject> Click on the Miscellaneous Portlets browse link to see a - list of portlets (Figure 49). <mediaobject> - <imageobject> - <imagedata align="left" fileref="images/image102.jpg" format="JPG" - valign="middle" /> - </imageobject> + <caption> + <para>Figure 48. Portlet categories on + portletswap. + </para> + </caption> + </mediaobject> + Click on the Miscellaneous Portlets browse link to see a + list of portlets (Figure 49). + <mediaobject> + <imageobject> + <imagedata align="left" fileref="images/image102.jpg" format="JPG" + valign="middle"/> + </imageobject> - <caption><para>Figure 49. List of portlets on - portletswap.</para></caption> - </mediaobject> Click on the download link next to the Flash MoviePortlet. - The download dialog will appear (Figure 50). <mediaobject> - <imageobject> - <imagedata align="center" fileref="images/image064.jpg" format="JPG" - valign="middle" /> - </imageobject> + <caption> + <para>Figure 49. List of portlets on + portletswap. + </para> + </caption> + </mediaobject> + Click on the download link next to the Flash MoviePortlet. + The download dialog will appear (Figure 50). + <mediaobject> + <imageobject> + <imagedata align="center" fileref="images/image064.jpg" format="JPG" + valign="middle"/> + </imageobject> - <caption><para>Figure 50. Download dialog.</para></caption> - </mediaobject> This zip file contains both the binary and the source for - the portlet. Open the zip and extract the flash.war file. Place this file in - the $JBOSS_HOME\server\default\deploy directory. The console for the - JBoss Portal will show the portlet being deployed (Figure 51). <mediaobject> - <imageobject> - <imagedata align="center" fileref="images/image066.jpg" format="JPG" - valign="middle" /> - </imageobject> + <caption> + <para>Figure 50. Download dialog.</para> + </caption> + </mediaobject> + This zip file contains both the binary and the source for + the portlet. Open the zip and extract the flash.war file. Place this file in + the $JBOSS_HOME\server\default\deploy directory. The console for the + JBoss Portal will show the portlet being deployed (Figure 51). - <caption><para>Figure 51. Flash portlet is deployed to JBoss - Portal.</para></caption> - </mediaobject> To see the deployed portlet, we need to add it to our - Starter portal page. First, we need to create an instance of the portlet. Go - to the Admin portal page (Figure 52). <mediaobject> - <imageobject> - <imagedata align="left" fileref="images/image012.jpg" format="JPG" - valign="middle" /> - </imageobject> + <emphasis>11:23:17,640 INFO [TomcatDeployer] deploy, ctxPath=/flash, warUrl=.../tmp/deploy/tmp64975flash-exp.war/</emphasis> - <caption><para>Figure 52. Admin portal page.</para></caption> - </mediaobject></para> + To see the deployed portlet, we need to add it to our + Starter portal page. First, we need to create an instance of the portlet. Go + to the Management portlet (Figure 52). + <mediaobject> + <imageobject> + <imagedata align="left" fileref="images/image108.jpg" format="JPG" + valign="middle"/> + </imageobject> - <para>Click on the Portlets link. A list of all portlets will be displayed. - Click on the FlashPortlet link. A dialog to create an instance will appear - (Figure 53).<mediaobject> - <imageobject> - <imagedata align="center" fileref="images/image103.jpg" format="JPG" - valign="middle" /> - </imageobject> + <caption> + <para>Figure 52. Admin portal page.</para> + </caption> + </mediaobject> + </para> - <caption><para>Figure 53. Portlets admininstration.</para></caption> - </mediaobject> Type in "Flash Portlet " as the instance name and click on - the create instance button. Now there is an instance of the portlet that can - be added to the Starter portal page. Click on the Instances link to see all - portlet instances (Figure 54).<mediaobject> - <imageobject> - <imagedata align="left" fileref="images/image104.jpg" format="JPG" - valign="middle" /> - </imageobject> + <para>Click on the Portlets link. A list of all portlets will be displayed. + Click on the FlashPortlet link. A dialog to create an instance will appear + (Figure 53). + <mediaobject> + <imageobject> + <imagedata align="center" fileref="images/image103.jpg" format="JPG" + valign="middle"/> + </imageobject> - <caption><para>Figure 54. Portlet instances - admininstration.</para></caption> - </mediaobject>Click on the Portal link and expand the tree to the Starter - portal page. Select the Flash Portlet from the portlet list, and add it to - the Starter portal page with a name of "flash" (Figure 55).<mediaobject> - <imageobject> - <imagedata align="left" fileref="images/image105.jpg" format="JPG" - valign="middle" /> - </imageobject> + <caption> + <para>Figure 53. Portlets admininstration.</para> + </caption> + </mediaobject> + Type in "Flash Portlet " as the instance name and click on + the create instance button. Now there is an instance of the portlet that can + be added to the Starter portal page. Click on the Instances link to see all + portlet instances (Figure 54). + <mediaobject> + <imageobject> + <imagedata align="left" fileref="images/image104.jpg" format="JPG" + valign="middle"/> + </imageobject> - <caption><para>Figure 55. Starter portal page with flash portlet - added.</para></caption> - </mediaobject> Click on the Starter portal page, and the flash portlet is - displayed (Figure 56).<mediaobject> - <imageobject> - <imagedata align="left" fileref="images/image106.jpg" format="JPG" - valign="middle" /> - </imageobject> + <caption> + <para>Figure 54. Portlet instances + admininstration. + </para> + </caption> + </mediaobject> + Click on the Portal link and expand the tree to the Starter + portal page. Select the Flash Portlet from the portlet list, and add it to + the Starter portal page with a name of "flash" (Figure 55). + <mediaobject> + <imageobject> + <imagedata align="left" fileref="images/image105.jpg" format="JPG" + valign="middle"/> + </imageobject> - <caption><para>Figure 56. Starter portal page with flash - portlet.</para></caption> - </mediaobject></para> + <caption> + <para>Figure 55. Starter portal page with flash portlet + added. + </para> + </caption> + </mediaobject> + Click on the Starter portal page, and the flash portlet is + displayed (Figure 56). + <mediaobject> + <imageobject> + <imagedata align="left" fileref="images/image106.jpg" format="JPG" + valign="middle"/> + </imageobject> + + <caption> + <para>Figure 56. Starter portal page with flash + portlet. + </para> + </caption> + </mediaobject> + </para> </chapter> \ No newline at end of file Modified: docs/trunk/quickstartuser/en/modules/interaction.xml =================================================================== --- docs/trunk/quickstartuser/en/modules/interaction.xml 2007-02-15 16:31:50 UTC (rev 6301) +++ docs/trunk/quickstartuser/en/modules/interaction.xml 2007-02-15 16:37:59 UTC (rev 6302) @@ -342,11 +342,11 @@ <sect1> <title>Portal Management</title> - <para>Click on the Admin portal page. The user, role, catalog, CMS Admin, - and management portlets are on this portal page (Figure 29). + <para>Click on the Admin link. From this Admin Portal, you should have access to the Members, CMS, and Portal + management interfaces. (Figure 29). <mediaobject> <imageobject> - <imagedata align="left" fileref="images/image012.jpg" format="JPG" + <imagedata align="left" fileref="images/image108.jpg" format="JPG" valign="middle"/> </imageobject> @@ -354,7 +354,7 @@ <para>Figure 29. Admin portal page.</para> </caption> </mediaobject> - Click on the "List of all the users" link to see the users + Click the "Members" tab to access the member management page. Click on the "Search" button to see the users in the portal (Figure 30). <mediaobject> <imageobject> @@ -397,7 +397,7 @@ </caption> </mediaobject> Now let's look at the user profile for the starter user. - Click on the "List of all users" link, then the "Profile" link next to the + Click on the "Search" button, then the "Profile" link next to the starter user. The user profile view appears (Figure 33). <mediaobject> <imageobject> @@ -411,12 +411,11 @@ </mediaobject> This shows all of the fields available in the user profile. Enter the first name of "starter" and click the "Save changes" - button. The User portlet menu view is displayed again. Click on the - default size icon to go back to the Admin portal page default view (Figure + button. The Member management page is displayed now.(Figure 34). <mediaobject> <imageobject> - <imagedata align="left" fileref="images/image012.jpg" format="jpg" + <imagedata align="left" fileref="images/image108.jpg" format="jpg" valign="middle"/> </imageobject> @@ -426,13 +425,11 @@ </para> </caption> </mediaobject> - Now, let's explore the management portlet. This portlet + Now, let's explore the management portlet, by clicking on the "Home" tab. This portlet shows a tree view of the portals, portal pages, and portlet instances. - Click on the "+" icon next to root, then the "+" icon next to default, and - finally the "+" icon next to Admin. This shows us that there is a default - portal with four portal pages defined. In addition, we can see the six - portlet instances (including navigation) that are used in the management - portal page (Figure 35). + Click on the "+" icon next to root, then the "+" icon next to "admin", then the "+" icon next to "Members". + This shows us that there is an admin portal with 3 portal pages defined. In addition, we can see the 2 + portlet instances that are used in the Members portal page (Figure 35). <mediaobject> <imageobject> <imagedata align="center" fileref="images/image088.jpg" format="JPG" @@ -448,20 +445,8 @@ Using the arrows next to the portlet instance names, we can dynamically move the portlet instances on the portal page. Click on the up arrow icon next to the RolePortletWindow to move the role portlet - above the user portlet The page now shows the role portlet above the user - portlet on the page (Figure 36). - <mediaobject> - <imageobject> - <imagedata align="left" fileref="images/image089.jpg" format="JPG" - valign="middle"/> - </imageobject> + above the user portlet. - <caption> - <para>Figure 36. Role portlet is moved on the management - portlet page. - </para> - </caption> - </mediaobject> Let's create a new portal page. Click on the "default" portal link. The add portal page view is shown (Figure 37). <mediaobject> @@ -506,7 +491,7 @@ </para> </caption> </mediaobject> - First, let's add a navigation portlet. Choose the + First, let's add a weather portlet. Choose the navigation portlet instance from the dropdown (Figure 40). <mediaobject> <imageobject> @@ -521,8 +506,8 @@ </caption> </mediaobject> Type in the name you want to give this portlet instance - ("nav") and click the "Add navigation" button. The "nav" portlet instance - is now shown under navigation (Figure 41). + ("weather") and click the "Add Center" button. The "weather" portlet instance + is now shown under the "center" (Figure 41). <mediaobject> <imageobject> <imagedata align="left" fileref="images/image094.jpg" format="JPG" @@ -535,7 +520,7 @@ </para> </caption> </mediaobject> - Click on the "nav" link to go into the details for that + Click on the "weather" link to go into the details for that portlet instance (Figure 42) <mediaobject> <imageobject> @@ -544,14 +529,13 @@ </imageobject> <caption> - <para>Figure 42. Details for the nav portlet + <para>Figure 42. Details for the weather portlet instance. </para> </caption> </mediaobject> Click on the "Theme" link to update the theme for this - portlet. Since this is a navigation portlet and it doesn't need portlet - decorations, let's set the Window Renderer, Decoration Renderer, and + portlet. Let's set the Window Renderer, Decoration Renderer, and Portlet Renderer to "emptyRenderer" (Figure 43). <mediaobject> <imageobject> @@ -560,30 +544,11 @@ </imageobject> <caption> - <para>Figure 43. Theme details for the nav portlet + <para>Figure 43. Theme details for the weather portlet instance. </para> </caption> </mediaobject> - Click the "Update" button, then click the Starter portal - page in the management portlet to continue adding portlets to the Starter - portal page. Select the CatalogPortletInstance from the portlet instance - list, enter a name of "catalog", and click the "Add left" button. Select - the CMSPortletInstance from the portlet instance list, enter a name of - "CMS", and click the "Add center" button. See Figure 44 for the updated - detail of the Starter portal page. - <mediaobject> - <imageobject> - <imagedata align="left" fileref="images/image097.jpg" format="JPG" - valign="middle"/> - </imageobject> - - <caption> - <para>Figure 44. Starter page detail with portlet instances - added. - </para> - </caption> - </mediaobject> Finally, let's take a look at security in the management portlet. Click on the "Security" link, and the list of available roles and actions is shown for the Starter portal page.(Figure 45). @@ -600,7 +565,7 @@ </caption> </mediaobject> Let's take a look at the Starter portal page we created. - Click on the "Starter" tab at the top to go to the Starter portal page + Click on the "Main" link, and then the "Starter" tab at the top to go to the Starter portal page (Figure 46). <mediaobject> <imageobject>