Author: roy.russo(a)jboss.com Date: 2006-12-19 15:26:59 -0500 (Tue, 19 Dec 2006) New Revision: 5906 Added: docs/trunk/userGuide/en/images/intro/dashboard_assignportlets.gif docs/trunk/userGuide/en/images/intro/dashboard_assignthemes.gif docs/trunk/userGuide/en/images/intro/dashboard_configure.gif docs/trunk/userGuide/en/images/intro/dashboard_createpage.gif docs/trunk/userGuide/en/images/intro/dashboard_dnd.gif docs/trunk/userGuide/en/images/intro/dashboard_selectpage.gif docs/trunk/userGuide/en/images/intro/login_ss.gif docs/trunk/userGuide/en/images/intro/portlet_assign.gif docs/trunk/userGuide/en/images/intro/portlet_down.gif docs/trunk/userGuide/en/images/intro/portlet_remove.gif docs/trunk/userGuide/en/images/intro/portlet_up.gif Modified: docs/trunk/userGuide/en/images/intro/dashboard.jpg docs/trunk/userGuide/en/modules/intro.xml Log: JBPORTAL-1164 - Document dashboards in User Guide Modified: docs/trunk/userGuide/en/images/intro/dashboard.jpg =================================================================== (Binary files differ) Added: docs/trunk/userGuide/en/images/intro/dashboard_assignportlets.gif =================================================================== (Binary files differ) Property changes on: docs/trunk/userGuide/en/images/intro/dashboard_assignportlets.gif ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: docs/trunk/userGuide/en/images/intro/dashboard_assignthemes.gif =================================================================== (Binary files differ) Property changes on: docs/trunk/userGuide/en/images/intro/dashboard_assignthemes.gif ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: docs/trunk/userGuide/en/images/intro/dashboard_configure.gif =================================================================== (Binary files differ) Property changes on: docs/trunk/userGuide/en/images/intro/dashboard_configure.gif ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: docs/trunk/userGuide/en/images/intro/dashboard_createpage.gif =================================================================== (Binary files differ) Property changes on: docs/trunk/userGuide/en/images/intro/dashboard_createpage.gif ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: docs/trunk/userGuide/en/images/intro/dashboard_dnd.gif =================================================================== (Binary files differ) Property changes on: docs/trunk/userGuide/en/images/intro/dashboard_dnd.gif ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: docs/trunk/userGuide/en/images/intro/dashboard_selectpage.gif =================================================================== (Binary files differ) Property changes on: docs/trunk/userGuide/en/images/intro/dashboard_selectpage.gif ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: docs/trunk/userGuide/en/images/intro/login_ss.gif =================================================================== (Binary files differ) Property changes on: docs/trunk/userGuide/en/images/intro/login_ss.gif ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: docs/trunk/userGuide/en/images/intro/portlet_assign.gif =================================================================== (Binary files differ) Property changes on: docs/trunk/userGuide/en/images/intro/portlet_assign.gif ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: docs/trunk/userGuide/en/images/intro/portlet_down.gif =================================================================== (Binary files differ) Property changes on: docs/trunk/userGuide/en/images/intro/portlet_down.gif ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: docs/trunk/userGuide/en/images/intro/portlet_remove.gif =================================================================== (Binary files differ) Property changes on: docs/trunk/userGuide/en/images/intro/portlet_remove.gif ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: docs/trunk/userGuide/en/images/intro/portlet_up.gif =================================================================== (Binary files differ) Property changes on: docs/trunk/userGuide/en/images/intro/portlet_up.gif ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Modified: docs/trunk/userGuide/en/modules/intro.xml =================================================================== --- docs/trunk/userGuide/en/modules/intro.xml 2006-12-19 17:46:38 UTC (rev 5905) +++ docs/trunk/userGuide/en/modules/intro.xml 2006-12-19 20:26:59 UTC (rev 5906) @@ -219,6 +219,12 @@ admin/admin ]]> </programlisting> + <mediaobject> + <imageobject> + <imagedata fileref="images/intro/login_ss.gif" format="gif" align="center" + valign="middle"/> + </imageobject> + </mediaobject> </para> <para> Once logged in, the top-right menu will change so you can then navigate to your personal dashboard and other @@ -531,14 +537,154 @@ persisted... so the next time the user logs in to his dashboard, he will see the previous changes he made. <mediaobject> <imageobject> - <imagedata fileref="images/intro/dashboard_dnd.jpg" format="jpg" align="center" + <imagedata fileref="images/intro/dashboard_dnd.gif" format="gif" align="center" valign="middle"/> </imageobject> </mediaobject> - <note>At the time of this release, functionality on Adding Pages, and Adding portlet windows, has not been - added to the dashboarding area for users. - </note> + While navigating any of the dashboard pages, a user will be able to drag and drop portlet windows to any + location, if the administrator allows this functionality. Changes made in this fashion will be persisted. </para> + <sect2 id="dashboard_configure"> + <title>Configuring your personal dashboard</title> + <para> + A user is able to configure his personal dashboard, by accessing the Configurator, using the top-right menu + item, labeled + <emphasis>Edit Content</emphasis> + . He should then see the main Configurator screen: + <mediaobject> + <imageobject> + <imagedata fileref="images/intro/dashboard_configure.gif" format="gif" align="center" + valign="middle"/> + </imageobject> + </mediaobject> + From this screen, a user is able to perform configuration actions on his dashboard, by first selecting the + page he would like to edit, using the page selector dropdown: + <mediaobject> + <imageobject> + <imagedata fileref="images/intro/dashboard_selectpage.gif" format="gif" align="center" + valign="middle"/> + </imageobject> + </mediaobject> + The possible actions on a selected page are as follows: + <itemizedlist> + <listitem> + <xref linkend="dashboard_createpages"/> + </listitem> + <listitem> + <xref linkend="dashboard_assignportlets"/> + </listitem> + <listitem> + <xref linkend="dashboard_assignthemes"/> + </listitem> + <listitem> + <xref linkend="dashboard_deletepage"/> + </listitem> + </itemizedlist> + </para> + <sect3 id="dashboard_createpages"> + <title>Creating Pages</title> + <para> + A user is able to create new pages in his personal dashboard by simply entering a desired Page name in + the + <emphasis>Create New Page</emphasis> + dialogue. + <mediaobject> + <imageobject> + <imagedata fileref="images/intro/dashboard_createpage.gif" format="gif" align="center" + valign="middle"/> + </imageobject> + </mediaobject> + <note> + <itemizedlist> + <listitem>Page names must be unique.</listitem> + <listitem>Page names cannot be blank.</listitem> + </itemizedlist> + </note> + Upon creating a new page, the Configurator will refresh and allow a user to customize the new page. + </para> + </sect3> + <sect3 id="dashboard_assignportlets"> + <title>Managing Portlets</title> + <para> + <mediaobject> + <imageobject> + <imagedata fileref="images/intro/dashboard_assignportlets.gif" format="gif" align="center" + valign="middle"/> + </imageobject> + </mediaobject> + This section of the Configurator allows users to add, remove, and reorder portlets on a selected + dashboard + page. + </para> + <para> + <emphasis role="bold">Assigning portlets</emphasis> + to a page is accomplished by selecting which portlets you would like added to a page + from the + <emphasis>Available Content</emphasis> + list. (You may select multiple portlets by holding CTRL and clicking on the available portlets.) Once you + have selected which portlet you would like to assign to a specific column, click the + <imageobject> + <imagedata fileref="images/intro/portlet_assign.gif" format="gif"/> + </imageobject> + button next to the target column. + </para> + <para> + <emphasis role="bold">Removing portlets</emphasis> + from a page is accomplished by selecting which portlets you would like removed from a + specific column. (You may select multiple portlets by holding CTRL and clicking on the available + portlets.) + Once you + have selected which portlet you would like removed, click the + <imageobject> + <imagedata fileref="images/intro/portlet_remove.gif" format="gif"/> + </imageobject> + button next to the source column. + </para> + <para> + <emphasis role="bold">Sorting portlets</emphasis> + in a column is accomplished by selecting which portlets you would like to sort from a + specific column. (You may select multiple portlets by holding CTRL and clicking on the available + portlets.) + Once you + have selected which portlet you would like re-ordered, click the + <imageobject> + <imagedata fileref="images/intro/portlet_up.gif" format="gif"/> + </imageobject> + or + <imageobject> + <imagedata fileref="images/intro/portlet_down.gif" format="gif"/> + </imageobject> + button next to the source column. + </para> + </sect3> + <sect3 id="dashboard_assignthemes"> + <title>Managing Theme and Layouts</title> + <para> + Using the Theme and Layout dropdowns, the configurator allows for theme and/or layout assignment to a + specific dashboard page. The user simply selects the desired theme and/or layout and presses + <emphasis>Select</emphasis> + to assign it to the page. + <mediaobject> + <imageobject> + <imagedata fileref="images/intro/dashboard_assignthemes.gif" format="gif" align="center" + valign="middle"/> + </imageobject> + </mediaobject> + </para> + </sect3> + <sect3 id="dashboard_deletepage"> + <title>Deleting Pages</title> + <para> + Users may delete dashboard pages at any time, by scrolling to the bottom of the Configurator screen and + clicking the + <emphasis>Delete this page</emphasis> + button. We will note that users are not able to delete the default dashboard page. + <warning> + Deleted pages are NOT recoverable. This change is permanent! + </warning> + </para> + </sect3> + </sect2> </sect1> <sect1 id="adminportal"> <title>Admin Portal</title>