[gatein-commits] gatein SVN: r1021 - in portal/trunk/docs/user-guide/en/modules: language and 1 other directories.

Author: smumford Date: 2009-12-15 23:50:09 -0500 (Tue, 15 Dec 2009) New Revision: 1021 Modified: portal/trunk/docs/user-guide/en/modules/Portal.xml portal/trunk/docs/user-guide/en/modules/language/Change_Interface_Language.xml portal/trunk/docs/user-guide/en/modules/language/Multi-Language_Navigation_Nodes.xml portal/trunk/docs/user-guide/en/modules/language/Right_To_Left_Support_(RTL).xml portal/trunk/docs/user-guide/en/modules/portal/Change_Node_Order.xml portal/trunk/docs/user-guide/en/modules/portal/Change_Portal_Skins.xml portal/trunk/docs/user-guide/en/modules/portal/Create_a_New_Portal.xml portal/trunk/docs/user-guide/en/modules/portal/Drag_and_Drop_the_Page_Body.xml portal/trunk/docs/user-guide/en/modules/portal/Manage_Navigation_Nodes.xml portal/trunk/docs/user-guide/en/modules/portal/Manage_Page_Navigation.xml portal/trunk/docs/user-guide/en/modules/portal/Manage_Pages.xml portal/trunk/docs/user-guide/en/modules/portal/Manage_Portals.xml portal/trunk/docs/user-guide/en/modules/portal/Page_Creation_Wizard.xml portal/trunk/docs/user-guide/en/modules/portal/User_Management.xml Log: xml structure changes commit Modified: portal/trunk/docs/user-guide/en/modules/Portal.xml =================================================================== --- portal/trunk/docs/user-guide/en/modules/Portal.xml 2009-12-16 04:14:57 UTC (rev 1020) +++ portal/trunk/docs/user-guide/en/modules/Portal.xml 2009-12-16 04:50:09 UTC (rev 1021) @@ -28,8 +28,8 @@ <xi:include href="portal/Manage_Permission.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="portal/Change_Portal_Skins.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="portal/Manage_Page_Navigation.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> -<!-- <xi:include href="portal/Manage_Navigation_Nodes.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="portal/Change_Node_Order.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> To be included in Reference Guide --> + <xi:include href="portal/Manage_Navigation_Nodes.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="portal/Change_Node_Order.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="portal/Manage_Pages.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="portal/Page_Creation_Wizard.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="portal/Drag_and_Drop_the_Page_Body.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> Modified: portal/trunk/docs/user-guide/en/modules/language/Change_Interface_Language.xml =================================================================== --- portal/trunk/docs/user-guide/en/modules/language/Change_Interface_Language.xml 2009-12-16 04:14:57 UTC (rev 1020) +++ portal/trunk/docs/user-guide/en/modules/language/Change_Interface_Language.xml 2009-12-16 04:50:09 UTC (rev 1021) @@ -23,36 +23,67 @@ --><title>Change Interface Language</title> <para> - GateIn Portal provides users with the most familiar interface language to work with and perform all actions efficiently. The priority of the interface language is 1. User's language 2. Browser's language 3. Portal 's language. Thus to display your prefer language, you should pay attention to this order to change the language type appropriately. + &PRODUCT; provides users with the most familiar interface language to work with and perform all actions efficiently. The priority of the interface language is as follows: </para> + <orderedlist numeration="arabic"> + <listitem> + <para> + User's language + </para> + </listitem> + <listitem> + <para> + Browser's language + </para> + </listitem> + <listitem> + <para> + Portal 's language + </para> + </listitem> + </orderedlist> <para> + Thus to display your prefered language, you should pay attention to this order to change the language type appropriately. + </para> + + <para> You can change the interface language permanently by three ways : </para> <section id="sect-User_Guide-Change_Interface_Language-The_1st_way"> - <title>The 1^st^ way</title> - <para> - This way supports you to change the interface language of the current Portal. - </para> - <para> - 1. Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Edit Current portal</emphasis>. - </para> - <para> - 2. Click !images/EditIcon.png! icon to edit portal's properties. - </para> - <para> - 3. In the <emphasis role="bold">Portal Setting</emphasis> tab: You can change display language of Portal by selecting another language in the <emphasis role="bold">Locale</emphasis> field. - </para> - <para> - 4. Click <emphasis role="bold">Save</emphasis> and <emphasis role="bold">Finish</emphasis>!images/FinishIcon.png! icon to take affect. - </para> - <para> + <title>Method One</title> + <para> + This way supports you to change the interface language of the current Portal. + </para> + <procedure> + <step> + <para> + Go to <emphasis role="bold">&PRODUCT; Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Edit Current portal</emphasis>. + </para> + </step> + <step> + <para> + Click !images/EditIcon.png! icon to edit portal's properties. + </para> + </step> + <step> + <para> + In the <emphasis role="bold">Portal Setting</emphasis> tab: You can change display language of Portal by selecting another language in the <emphasis role="bold">Locale</emphasis> field. + </para> + </step> + <step> + <para> + Click <emphasis role="bold">Save</emphasis> and <emphasis role="bold">Finish</emphasis>!images/FinishIcon.png! icon to take affect. + </para> + </step> + </procedure> + <!-- <para> For Portal 2.6 </para> <para> You easily change the interface language of the current Portal by following guides: </para> <para> - 1. Go to <emphasis role="bold">Editor</emphasis> on the Toolbar --&gt; click <emphasis role="bold">Edit Page</emphasis>. The <emphasis role="bold">Edit Inline Composer</emphasis> popup will appear: + 1. Go to <emphasis role="bold">Editor</emphasis> on the Toolbar &gt; click <emphasis role="bold">Edit Page</emphasis>. The <emphasis role="bold">Edit Inline Composer</emphasis> popup will appear: </para> <mediaobject> <imageobject> @@ -67,39 +98,49 @@ </para> <para> 4. Click <emphasis role="bold">Save</emphasis> and <emphasis role="bold">Finish</emphasis>!images/DiskIcon.png! icon to take affect. - </para> + </para> --> </section> <section id="sect-User_Guide-Change_Interface_Language-The_2nd_way"> - <title>The 2^nd^ way</title> - <para> - If you can access GateIn Start, you can do this way to set interface language for yourself, not for interface language of Portal by these following steps: - </para> - <para> - 1. Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Language Settings</emphasis> - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/InterfaceLanguage.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - <para> - The <emphasis role="bold">Interface Language Setting</emphasis> form is displayed with a list of all supported languages. The current using language is marked by!images/MarkedIcon.png! icon. - </para> - <para> - 2. Select another one by clicking on the name of language. - </para> - <para> - 3. Click the <emphasis role="bold">Apply</emphasis> button and wait for few seconds to take affect. - </para> - <para> + <title>Method Two</title> + <para> + If you can access &PRODUCT; Start, you can do this way to set interface language for yourself, not for interface language of Portal by these following steps: + </para> + <procedure> + <step> + <para> + Go to <emphasis role="bold">&PRODUCT; Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Language Settings</emphasis> + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/InterfaceLanguage.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + </step> + <step> + <para> + The <emphasis role="bold">Interface Language Setting</emphasis> form is displayed with a list of all supported languages. The current using language is marked by!images/MarkedIcon.png! icon. + </para> + </step> + <step> + <para> + Select another one by clicking on the name of language. + </para> + </step> + <step> + <para> + Click the <emphasis role="bold">Apply</emphasis> button and wait for few seconds to take affect. + </para> + </step> + </procedure> + <!--<para> For Portal 2.6 </para> <para> You can set the interface language for yourself by following guides: </para> <para> - 1. Go to GateIn on the Toolbar --&gt; click <emphasis role="bold">Change Language</emphasis> + 1. Go to &PRODUCT; on the Toolbar &gt; click <emphasis role="bold">Change Language</emphasis> </para> <mediaobject> <imageobject> @@ -114,83 +155,83 @@ </para> <para> 3. Click the <emphasis role="bold">Apply</emphasis> button and wait for few seconds to take affect. - </para> + </para> --> </section> <section id="sect-User_Guide-Change_Interface_Language-The_3rd_way"> - <title>The 3^rd^ way</title> + <title>Method Three</title> <para> You also set interface language for yourself, not for interface language of the Portal by this way. </para> - <para> - 1. Click <emphasis role="bold">Change Language</emphasis> on the right corner to show the <emphasis role="bold">Interface Language Setting</emphasis> form: - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/Root1.png" format="PNG" /> - </imageobject> - </mediaobject> - <para> - The <emphasis role="bold">Interface Language Setting</emphasis> form will appear: - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/InterfaceLanguage.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - <para> - 2. Select another language in list. The selected language will be marked by !images/MarkedIcon.png! icon. - </para> - <para> - 3. Click the <emphasis role="bold">Apply</emphasis> button to change the interface language and wait for few seconds to take affect or click the <emphasis role="bold">Cancel</emphasis> button to quit without changes. - </para> + <procedure> + <step> + <para> + Click <emphasis role="bold">Change Language</emphasis> on the right corner to show the <emphasis role="bold">Interface Language Setting</emphasis> form: + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/Root1.png" format="PNG" /> + </imageobject> + </mediaobject> + </step> + <step> + <para> + The <emphasis role="bold">Interface Language Setting</emphasis> form will appear: + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/InterfaceLanguage.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + </step> + <step> + <para> + Select another language in list. The selected language will be marked by !images/MarkedIcon.png! icon. + </para> + </step> + <step> + <para> + Click the <emphasis role="bold">Apply</emphasis> button to change the interface language and wait for few seconds to take affect or click the <emphasis role="bold">Cancel</emphasis> button to quit without changes. + </para> + </step> + </procedure> </section> <section id="sect-User_Guide-Change_Interface_Language-Set_language_for_a_user"> <title>Set language for a user</title> - <para> - There are two modes to set displaying language for a user. - </para> - <itemizedlist> - <listitem> - <para> - <emphasis role="bold">Public Mode</emphasis>: Displaying language of this mode depends on the language of browser that you are using. - </para> - </listitem> - </itemizedlist> - <itemizedlist> - <listitem> - <para> - If you set language of browser that Portal does not support, the displaying language will be the language of Portal. - </para> - </listitem> - <listitem> - <para> - If you set language of browser that Portal supports, the displaying language will be the language of browser. - </para> - </listitem> - </itemizedlist> - <itemizedlist> - <listitem> - <para> - <emphasis role="bold">Private Mode</emphasis>: Displaying language of this mode belongs to the language of each user which is set when registering. - </para> - </listitem> - </itemizedlist> - <itemizedlist> - <listitem> - <para> - When you sign in by a default account (root, john, demo, marry): the displaying language of these users are none, so it will belong to browser's language. If you change value in the <emphasis role="bold">Language</emphasis> field in the <emphasis role="bold">User Profile</emphasis> tab (only default user: root and john can change this value by access 'Management' page: Go to <emphasis role="bold">Organization</emphasis>--&gt; <emphasis role="bold">Management</emphasis> page), your displaying language will be the set value. Your displaying language has also directly affect when you change language by other ways. - </para> - </listitem> - <listitem> - <para> - When you sign in by a new registered user: by default, your displaying language is English. However, if you set by another language in the <emphasis role="bold">Language</emphasis> field in the <emphasis role="bold">User Profile</emphasis> tab when you register a new account, your displaying language is the set language. - </para> - </listitem> - </itemizedlist> + <para> + There are two modes to set displaying language for a user. + </para> + <variablelist> + <varlistentry> + <term>Public Mode</term> + <listitem> + <para> + Displaying language of this mode depends on the language of browser that you are using. + </para> + <para> + If you set language of browser that Portal does not support, the displaying language will be the language of Portal. + </para> + <para> + If you set language of browser that Portal supports, the displaying language will be the language of browser. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Private Mode</term> + <listitem> + <para> + Displaying language of this mode belongs to the language of each user which is set when registering. + </para> + <para> + When you sign in by a default account (root, john, demo, marry): the displaying language of these users are none, so it will belong to browser's language. If you change value in the <emphasis role="bold">Language</emphasis> field in the <emphasis role="bold">User Profile</emphasis> tab (only default user: root and john can change this value by access 'Management' page: Go to <emphasis role="bold">Organization</emphasis>--&gt; <emphasis role="bold">Management</emphasis> page), your displaying language will be the set value. Your displaying language has also directly affect when you change language by other ways. + </para> + <para> + When you sign in by a new registered user: by default, your displaying language is English. However, if you set by another language in the <emphasis role="bold">Language</emphasis> field in the <emphasis role="bold">User Profile</emphasis> tab when you register a new account, your displaying language is the set language. + </para> + </listitem> + </varlistentry> + </variablelist> </section> </section> - - Modified: portal/trunk/docs/user-guide/en/modules/language/Multi-Language_Navigation_Nodes.xml =================================================================== --- portal/trunk/docs/user-guide/en/modules/language/Multi-Language_Navigation_Nodes.xml 2009-12-16 04:14:57 UTC (rev 1020) +++ portal/trunk/docs/user-guide/en/modules/language/Multi-Language_Navigation_Nodes.xml 2009-12-16 04:50:09 UTC (rev 1021) @@ -25,7 +25,7 @@ <section id="sect-User_Guide-Multi_Language_Navigation_Nodes-Overview"> <title>Overview</title> <para> - Exo Portal supports a multi-language environment for your portal. You can internationalize any menu entry on the navigation. As the navigation bar is composed by nodes so you have to modify the display names of the nodes. Instead of entering the display name in English you have to use a so called resource key. This resource key is used to define the label that is shown on the navigation bar, the menu, and the breadcrumb. + &PRODUCT; supports a multi-language environment for your portal. You can internationalize any menu entry on the navigation. As the navigation bar is composed by nodes so you have to modify the display names of the nodes. Instead of entering the display name in English you have to use a so called resource key. This resource key is used to define the label that is shown on the navigation bar, the menu, and the breadcrumb. </para> </section> @@ -42,8 +42,26 @@ <section id="sect-User_Guide-Multi_Language_Navigation_Nodes-Creating_Keys"> <title>Creating Keys</title> <para> - There are three ways to create a key for a node: using the <emphasis role="bold">Create Page Wizard</emphasis> or using the <emphasis role="bold">Edit Page Wizard</emphasis> or the <emphasis role="bold">Edit Page and Navigation</emphasis> dialog. + There are three ways to create a key for a node: </para> + <orderedlist numeration="arabic"> + <listitem> + <para> + <xref linkend="sect-User_Guide-Multi_Language_Navigation_Nodes-Creating_Keys_using_the_Create_Page_Wizard"/>; + </para> + </listitem> + <listitem> + <para> + <xref linkend="sect-User_Guide-Multi_Language_Navigation_Nodes-CreatingEditing_Keys_by_Edit_Page_Wizard"/> + </para> + </listitem> + <listitem> + <para> + <xref linkend="sect-User_Guide-Multi_Language_Navigation_Nodes-CreatingEditing_Keys_using_the_Edit_Page_and_Navigation"/> + </para> + </listitem> + </orderedlist> + </section> <section id="sect-User_Guide-Multi_Language_Navigation_Nodes-Creating_Keys_using_the_Create_Page_Wizard"> @@ -54,27 +72,27 @@ <procedure> <step> <para> - 1. Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Basic</emphasis> --&gt; <emphasis role="bold">Create Page Wizard</emphasis> + Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Basic</emphasis> --&gt; <emphasis role="bold">Create Page Wizard</emphasis> </para> </step> <step> <para> - 2. Click <emphasis role="bold">Next</emphasis> to move to step 1 + Click <emphasis role="bold">Next</emphasis> to move to step 1 </para> </step> <step> <para> - 3. At step 1, continue as usual, but enter a resource key in the <emphasis role="bold">Display Name</emphasis> field. + At step 1, continue as usual, but enter a resource key in the <emphasis role="bold">Display Name</emphasis> field. + </para> <mediaobject> <imageobject> <imagedata fileref="images/PageWizard.png" format="PNG" width="444" /> </imageobject> </mediaobject> - </para> </step> <step> <para> - 4. Click on the <emphasis role="bold">Next</emphasis> button and continue and click on the <emphasis role="bold">Save</emphasis> button. For example, create a key named "AAA". + Click on the <emphasis role="bold">Next</emphasis> button and continue and click on the <emphasis role="bold">Save</emphasis> button. For example, create a key named "AAA". </para> </step> </procedure> @@ -83,50 +101,69 @@ <section id="sect-User_Guide-Multi_Language_Navigation_Nodes-CreatingEditing_Keys_by_Edit_Page_Wizard"> <title>Creating/Editing Keys by *Edit Page Wizard*</title> - <para> - 1. Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Basic</emphasis> --&gt; <emphasis role="bold">Edit Page Wizard</emphasis> - </para> - <para> - 2. Click on the <emphasis role="bold">Next</emphasis> button to move to step 1 - </para> - <para> - 3. At step 1, continue as usual, but enter a resource key in the <emphasis role="bold">Display Name</emphasis> field. - </para> + <procedure> + <step> + <para> + Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Basic</emphasis> --&gt; <emphasis role="bold">Edit Page Wizard</emphasis> + </para> + </step> + <step> + <para> + Click on the <emphasis role="bold">Next</emphasis> button to move to step 1 + </para> + </step> + <step> + <para> + At step 1, continue as usual, but enter a resource key in the <emphasis role="bold">Display Name</emphasis> field. + </para> + </step> + </procedure> </section> <section id="sect-User_Guide-Multi_Language_Navigation_Nodes-CreatingEditing_Keys_using_the_Edit_Page_and_Navigation"> <title>Creating/Editing Keys using the *Edit Page and Navigation*</title> - <para> - 1. Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Edit Page and Navigation</emphasis>. - </para> - <para> - 2. There are two alternatives: - </para> - <itemizedlist> - <listitem> - <para> - Create a new node: Select the parent path, right click and click on <emphasis role="bold">Add new node</emphasis> option . - </para> - </listitem> - <listitem> - <para> - Edit an existing node: Right click on the node you want to create/edit key and click on <emphasis role="bold">Edit this node</emphasis> in the pop-up menu. - </para> - </listitem> - </itemizedlist> - <para> - 3. A Create/Edit node dialog appears, enter a resource key in the <emphasis role="bold">Label</emphasis> field - </para> - <para> - +Note:+ You can reuse the same resource key in several nodes. - </para> + <procedure> + <step> + <para> + Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Edit Page and Navigation</emphasis>. + </para> + </step> + <step> + <para> + There are two alternatives: + </para> + <itemizedlist> + <listitem> + <para> + Create a new node: Select the parent path, right click and click on <emphasis role="bold">Add new node</emphasis> option . + </para> + </listitem> + <listitem> + <para> + Edit an existing node: Right click on the node you want to create/edit key and click on <emphasis role="bold">Edit this node</emphasis> in the pop-up menu. + </para> + </listitem> + </itemizedlist> + </step> + <step> + <para> + A Create/Edit node dialog appears, enter a resource key in the <emphasis role="bold">Label</emphasis> field + </para> + </step> + <note> + <para> + You can reuse the same resource key in several nodes. + </para> + </note> + </procedure> </section> <section id="sect-User_Guide-Multi_Language_Navigation_Nodes-Internationalize_Resource_Keys"> <title>Internationalize Resource Keys</title> <para> - Exo Portal organizes resource keys in resource files. Each file contains a list of keys and their meanings (translations) in one specific language. Normally one resource file has one language supported by Portal. This helps to structure the resource keys. Each resource file has a name and a language attribute. One resource file only can contain translations for one single language. + &PRODUCT; organizes resource keys in resource files. Each file contains a list of keys and their meanings (translations) in one specific language. Normally one resource file has one language supported by Portal. This helps to structure the resource keys. Each resource file has a name and a language attribute. One resource file only can contain translations for one single language. </para> + <procedure> <para> Do as follows: 1. Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Page Navigation</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> --&gt; <emphasis role="bold">Internationalization</emphasis> </para> Modified: portal/trunk/docs/user-guide/en/modules/language/Right_To_Left_Support_(RTL).xml =================================================================== --- portal/trunk/docs/user-guide/en/modules/language/Right_To_Left_Support_(RTL).xml 2009-12-16 04:14:57 UTC (rev 1020) +++ portal/trunk/docs/user-guide/en/modules/language/Right_To_Left_Support_(RTL).xml 2009-12-16 04:50:09 UTC (rev 1021) @@ -33,50 +33,58 @@ <imagedata fileref="images/HomePage2.png" format="PNG" width="444" /> </imageobject> </mediaobject> - <section id="sect-User_Guide-RTL_Support_Right_To_Left-The_Account_Portlet"> + <formalpara> <title>The Account Portlet</title> + <para> <mediaobject> <imageobject> <imagedata fileref="images/NewAccount3.png" format="PNG" width="444" /> </imageobject> </mediaobject> - </section> + </para> + </formalpara> - <section id="sect-User_Guide-RTL_Support_Right_To_Left-The_Application_Registry_Portlet"> + <formalpara> <title>The Application Registry Portlet</title> + <para> <mediaobject> <imageobject> <imagedata fileref="images/ApplicationRegistry2.png" format="PNG" width="444" /> </imageobject> </mediaobject> - </section> + </para> + </formalpara> - <section id="sect-User_Guide-RTL_Support_Right_To_Left-The_Internationalization_Portlet"> + <formalpara> <title>The Internationalization Portlet:</title> + <para> <mediaobject> <imageobject> <imagedata fileref="images/In3.png" format="PNG" /> </imageobject> </mediaobject> - </section> + </para> + </formalpara> - <section id="sect-User_Guide-RTL_Support_Right_To_Left-The_Organization_Portlet"> + <formalpara> <title>The Organization Portlet:</title> + <para> <mediaobject> <imageobject> <imagedata fileref="images/Organization5.png" format="PNG" width="444" /> </imageobject> </mediaobject> - </section> + </para> + </formalpara> - <section id="sect-User_Guide-RTL_Support_Right_To_Left-The_User_Workspace"> +<!-- Deprecated <section id="sect-User_Guide-RTL_Support_Right_To_Left-The_User_Workspace"> <title>The User Workspace</title> <mediaobject> <imageobject> <imagedata fileref="images/UserWorkspace2.png" format="PNG" width="444" /> </imageobject> </mediaobject> - </section> + </section> --> </section> Modified: portal/trunk/docs/user-guide/en/modules/portal/Change_Node_Order.xml =================================================================== --- portal/trunk/docs/user-guide/en/modules/portal/Change_Node_Order.xml 2009-12-16 04:14:57 UTC (rev 1020) +++ portal/trunk/docs/user-guide/en/modules/portal/Change_Node_Order.xml 2009-12-16 04:50:09 UTC (rev 1021) @@ -22,31 +22,41 @@ 02110-1301 USA, or see the FSF site: http://www.fsf.org. --><title>Change Node Order</title> - <para> - You can easily change the position of node on the navigation bar on their own convenient order by following these steps: - </para> - <para> - 1. Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Edit Page and Navigation</emphasis>. - </para> - <para> - 2. Select a navigation from the navigation list. - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/Navigation.png" format="PNG" /> - </imageobject> - </mediaobject> - <para> - 3. Select the node that you want to move. Right click on the selected node and then click on <emphasis role="bold">Move up</emphasis> or <emphasis role="bold">Move down</emphasis> - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/MoveUpDown.png" format="PNG" /> - </imageobject> - </mediaobject> - <para> - The selected node will be moved up/down. - </para> + <para> + You can easily change the position of node on the navigation bar on their own convenient order by following these steps: + </para> + <procedure> + <step> + <para> + Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Edit Page and Navigation</emphasis>. + </para> + </step> + <step> + <para> + Select a navigation from the navigation list. + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/Navigation.png" format="PNG" /> + </imageobject> + </mediaobject> + </step> + <step> + <para> + Select the node that you want to move. Right click on the selected node and then click on <emphasis role="bold">Move up</emphasis> or <emphasis role="bold">Move down</emphasis> + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/MoveUpDown.png" format="PNG" /> + </imageobject> + </mediaobject> + </step> + <step> + <para> + The selected node will be moved up/down. + </para> + </step> + </procedure> </section> Modified: portal/trunk/docs/user-guide/en/modules/portal/Change_Portal_Skins.xml =================================================================== --- portal/trunk/docs/user-guide/en/modules/portal/Change_Portal_Skins.xml 2009-12-16 04:14:57 UTC (rev 1020) +++ portal/trunk/docs/user-guide/en/modules/portal/Change_Portal_Skins.xml 2009-12-16 04:50:09 UTC (rev 1021) @@ -28,18 +28,6 @@ <para> skin switch that takes only effect on the user's current session until he signs out. You can change the skin permanently or temporarily. </para> - <itemizedlist> - <listitem> - <para> - <xref linkend="User_Guide-Change_Portal_Skins-Change_the_skin_temporarily"/> - </para> - </listitem> - <listitem> - <para> - <xref linkend="User_Guide-Change_Portal_Skins-Change_the_skin_permanently"/> - </para> - </listitem> - </itemizedlist> <variablelist> <varlistentry id="User_Guide-Change_Portal_Skins-Change_the_skin_temporarily"> Modified: portal/trunk/docs/user-guide/en/modules/portal/Create_a_New_Portal.xml =================================================================== --- portal/trunk/docs/user-guide/en/modules/portal/Create_a_New_Portal.xml 2009-12-16 04:14:57 UTC (rev 1020) +++ portal/trunk/docs/user-guide/en/modules/portal/Create_a_New_Portal.xml 2009-12-16 04:50:09 UTC (rev 1021) @@ -25,84 +25,82 @@ <para> Creating a new portal requires you to have a special permission that only an administrator can give you. You need follow these guides to create a new portal. </para> + <procedure> + <step> + <para> + Click on <emphasis role="bold">Site</emphasis> in the toolbar. + </para> + </step> + <step> + <para> + Click the <emphasis role="bold">Add New Portal</emphasis> button. By default, the <emphasis role="bold">Create New Portal</emphasis> form is shown with the <emphasis role="bold">Portal Templates</emphasis> tab. + <mediaobject> + <imageobject> + <imagedata fileref="images/PortalTemplate2.6.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + </para> + <para> + By default, Portal template is Classic. Select the <emphasis role="bold">Portal Setting</emphasis> tab. + <mediaobject> + <imageobject> + <imagedata fileref="images/PortalSetting2.5.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + </para> + </step> + <step> + <para> + Enter a value for the <emphasis role="bold">Portal Name</emphasis> field. This field is required and must be unique. Only alpha, digit and underscore characters are allowed for this field and it must have at least 3 characters. + </para> + </step> + <step> + <para> + Select a display language for the portal by selecting a language from the list. + </para> + </step> + <step> + <para> + Select a skin for a portal by selecting one from the skin list. + </para> + </step> + <step> + <para> + Click on the <emphasis role="bold">Properties</emphasis> tab to fill in the <emphasis role="bold">Keep session alive</emphasis> property. Keeping the working session for a long time to avoid a time out. There are 3 options: + <itemizedlist> + <listitem> + <para> + never : it never happens even if an application requests it + </para> + </listitem> + <listitem> + <para> + on-demand : it starts to be used as soon as an application requests it + </para> + </listitem> + <listitem> + <para> + always : it's always enabled (which has a cost but the administrator will be aware of that) + </para> + </listitem> + </itemizedlist> + </para> + </step> + <step> + <para> + Click on the <emphasis role="bold">Permission Setting</emphasis> tab and set the permissions for the Portal. + </para> + <para> + By default the access permissions list for the portal is empty. You have to select at least one or tick on the <emphasis role="bold">Make it public</emphasis> check box to assign access permission to everyone. + </para> + </step> + <step> + <para> + Click on <emphasis role="bold">Save</emphasis> to accept creating a new portal. + </para> + </step> + </procedure> <para> - <orderedlist> - <listitem> - <para> - Click on <emphasis role="bold">Site</emphasis> in the toolbar. - </para> - </listitem> - <listitem> - <para> - Click the <emphasis role="bold">Add New Portal</emphasis> button. By default, the <emphasis role="bold">Create New Portal</emphasis> form is shown with the <emphasis role="bold">Portal Templates</emphasis> tab. - <mediaobject> - <imageobject> - <imagedata fileref="images/PortalTemplate2.6.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - </para> - <para> - By default, Portal template is Classic. Select the <emphasis role="bold">Portal Setting</emphasis> tab. - <mediaobject> - <imageobject> - <imagedata fileref="images/PortalSetting2.5.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - </para> - </listitem> - <listitem> - <para> - Enter a value for the <emphasis role="bold">Portal Name</emphasis> field. This field is required and must be unique. Only alpha, digit and underscore characters are allowed for this field and it must have at least 3 characters. - </para> - </listitem> - <listitem> - <para> - Select a display language for the portal by selecting a language from the list. - </para> - </listitem> - <listitem> - <para> - Select a skin for a portal by selecting one from the skin list. - </para> - </listitem> - <listitem> - <para> - Click on the <emphasis role="bold">Properties</emphasis> tab to fill in the <emphasis role="bold">Keep session alive</emphasis> property. Keeping the working session for a long time to avoid a time out. There are 3 options: - <itemizedlist> - <listitem> - <para> - never : it never happens even if an application requests it - </para> - </listitem> - <listitem> - <para> - on-demand : it starts to be used as soon as an application requests it - </para> - </listitem> - <listitem> - <para> - always : it's always enabled (which has a cost but the administrator will be aware of that) - </para> - </listitem> - </itemizedlist> - </para> - </listitem> - <listitem> - <para> - Click on the <emphasis role="bold">Permission Setting</emphasis> tab and set the permissions for the Portal. - </para> - <para> - By default the access permissions list for the portal is empty. You have to select at least one or tick on the <emphasis role="bold">Make it public</emphasis> check box to assign access permission to everyone. - </para> - </listitem> - <listitem> - <para> - Click on <emphasis role="bold">Save</emphasis> to accept creating a new portal. - </para> - </listitem> - </orderedlist> - </para> - <para> You also can edit or delete a portal, see more details on <xref linkend="sect-User_Guide-Manage_Portals" /> </para> </section> Modified: portal/trunk/docs/user-guide/en/modules/portal/Drag_and_Drop_the_Page_Body.xml =================================================================== --- portal/trunk/docs/user-guide/en/modules/portal/Drag_and_Drop_the_Page_Body.xml 2009-12-16 04:14:57 UTC (rev 1020) +++ portal/trunk/docs/user-guide/en/modules/portal/Drag_and_Drop_the_Page_Body.xml 2009-12-16 04:50:09 UTC (rev 1021) @@ -25,22 +25,28 @@ <para> You can easily drag and drop page body to the specific place where you want to in the page by following guides: </para> - <para> - 1. Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Edit Current portal</emphasis>. It will display : - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/DragPage1.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - <para> - 2. Click on the <emphasis role="bold">Portal Page</emphasis>, drag and drop to another reasonable places which you want to in this page. - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/DragPage3.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> + <procedure> + <step> + <para> + Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Edit Current portal</emphasis>. It will display : + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/DragPage1.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + </step> + <step> + <para> + Click on the <emphasis role="bold">Portal Page</emphasis>, drag and drop to another reasonable places which you want to in this page. + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/DragPage3.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + </step> + </procedure> </section> Modified: portal/trunk/docs/user-guide/en/modules/portal/Manage_Navigation_Nodes.xml =================================================================== --- portal/trunk/docs/user-guide/en/modules/portal/Manage_Navigation_Nodes.xml 2009-12-16 04:14:57 UTC (rev 1020) +++ portal/trunk/docs/user-guide/en/modules/portal/Manage_Navigation_Nodes.xml 2009-12-16 04:50:09 UTC (rev 1021) @@ -22,394 +22,419 @@ 02110-1301 USA, or see the FSF site: http://www.fsf.org. --><title>Manage Navigation Nodes</title> - <section id="sect-User_Guide-Manage_Navigation_Nodes-Overview"> - <title>Overview</title> <para> If you are allowed to access GateIn Start in the User Workspace, you can take all actions related to a node such as : add a new node, edit, copy, cut, delete and clone node. </para> - </section> - - <section id="sect-User_Guide-Manage_Navigation_Nodes-Add_a_new_node"> - <title>Add a new node</title> - <para> - 1. Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Edit Page and Navigation</emphasis> - </para> - <para> - 2. Select a navigation from the navigation list. - </para> - <para> - 3. Select a node from list (to create a new node like sub-node of the selected node) or click the icon!images/UpIcon.png! to create a new node on root - </para> - <para> - 4. Right-click on the selected navigation or node and select <emphasis role="bold">Add new Node</emphasis> option. Add new node form appears: - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/AddNode4.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - <para> - The <emphasis role="bold">Page Node Setting</emphasis> tab includes: - </para> - <informaltable colsep="0" frame="none" rowsep="0"> - <tgroup cols="2"> - <colspec align="center"></colspec> - <colspec align="center"></colspec> - <tbody> - <row> - <entry> - <emphasis role="bold"> Name </emphasis> - </entry> - <entry> - <emphasis role="bold"> Description </emphasis> - </entry> - </row> - <row> - <entry> - Uri - </entry> - <entry> - An identification of the node. The Uri is automatically created after adding a new node - </entry> - </row> - <row> - <entry> - Node name - </entry> - <entry> - The name of the node. This field is required and must be unique. Only alpha, digit and underscore characters are allowed for this field and it must have at least 3 characters. - </entry> - </row> - <row> - <entry> - Label - </entry> - <entry> - The display name of the node on the screen. This field is not required and may be changed. This field must have a length between 3 and 120 characters. - </entry> - </row> - <row> - <entry> - Visible - </entry> - <entry> - This check box allow to hide (and show) the page and its node at the navigation bar, the page navigation and the site map - </entry> - </row> - <row> - <entry> - Publication date &amp; time - </entry> - <entry> - This option allows publishing this node for a period of time. *Start Publication Date* and *End Publication Date* only appear when this option is selected. - </entry> - </row> - <row> - <entry> - Start Publication Date - </entry> - <entry> - The start date and time to publish the node. - </entry> - </row> - <row> - <entry> - End Publication Date - </entry> - <entry> - The end date and time to publish the node. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - <para> - In the <emphasis role="bold">Page Selector</emphasis> tab, you can select a page or not for this node. - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/PageSelector.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - <informaltable colsep="0" frame="none" rowsep="0"> - <tgroup cols="2"> - <colspec align="center"></colspec> - <colspec align="center"></colspec> - <tbody> - <row> - <entry> - <emphasis role="bold"> Name </emphasis> - </entry> - <entry> - <emphasis role="bold"> Description </emphasis> - </entry> - </row> - <row> - <entry> - Page Id - </entry> - <entry> - The identification string of the page. - </entry> - </row> - <row> - <entry> - Name - </entry> - <entry> - The selected page's name. - </entry> - </row> - <row> - <entry> - Title - </entry> - <entry> - The selected page's title. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - <para> - You do not have to input values in these fields. It is automatically displayed after selecting an existing page by clicking the <emphasis role="bold">Search and Select Page</emphasis> button. The <emphasis role="bold">Select a page</emphasis> form appears like: - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/SelectPage1.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - <orderedlist numeration="arabic"> - <listitem> + + <section id="sect-User_Guide-Manage_Navigation_Nodes-Add_a_new_node"> + <title>Add a new node</title> + <procedure> + <step> + <para> + Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Edit Page and Navigation</emphasis> + </para> + </step> + <step> + <para> + Select a navigation from the navigation list. + </para> + </step> + <step> + <para> + Select a node from list (to create a new node like sub-node of the selected node) or click the icon!images/UpIcon.png! to create a new node on root + </para> + </step> + <step> + <para> + Right-click on the selected navigation or node and select <emphasis role="bold">Add new Node</emphasis> option. Add new node form appears: + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/AddNode4.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + <para> + The <emphasis role="bold">Page Node Setting</emphasis> tab includes: + </para> + <informaltable colsep="0" frame="none" rowsep="0"> + <tgroup cols="2"> + <colspec align="center"></colspec> + <colspec align="center"></colspec> + <tbody> + <row> + <entry> + <emphasis role="bold"> Name </emphasis> + </entry> + <entry> + <emphasis role="bold"> Description </emphasis> + </entry> + </row> + <row> + <entry> + Uri + </entry> + <entry> + An identification of the node. The Uri is automatically created after adding a new node + </entry> + </row> + <row> + <entry> + Node name + </entry> + <entry> + The name of the node. This field is required and must be unique. Only alpha, digit and underscore characters are allowed for this field and it must have at least 3 characters. + </entry> + </row> + <row> + <entry> + Label + </entry> + <entry> + The display name of the node on the screen. This field is not required and may be changed. This field must have a length between 3 and 120 characters. + </entry> + </row> + <row> + <entry> + Visible + </entry> + <entry> + This check box allow to hide (and show) the page and its node at the navigation bar, the page navigation and the site map + </entry> + </row> + <row> + <entry> + Publication date &amp; time + </entry> + <entry> + This option allows publishing this node for a period of time. *Start Publication Date* and *End Publication Date* only appear when this option is selected. + </entry> + </row> + <row> + <entry> + Start Publication Date + </entry> + <entry> + The start date and time to publish the node. + </entry> + </row> + <row> + <entry> + End Publication Date + </entry> + <entry> + The end date and time to publish the node. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + <para> + In the <emphasis role="bold">Page Selector</emphasis> tab, you can select a page or not for this node. + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/PageSelector.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + <informaltable colsep="0" frame="none" rowsep="0"> + <tgroup cols="2"> + <colspec align="center"></colspec> + <colspec align="center"></colspec> + <tbody> + <row> + <entry> + <emphasis role="bold"> Name </emphasis> + </entry> + <entry> + <emphasis role="bold"> Description </emphasis> + </entry> + </row> + <row> + <entry> + Page Id + </entry> + <entry> + The identification string of the page. + </entry> + </row> + <row> + <entry> + Name + </entry> + <entry> + The selected page's name. + </entry> + </row> + <row> + <entry> + Title + </entry> + <entry> + The selected page's title. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> <para> - list of all existing pages is displayed with basic information. You can follow these guides to select a page for creating a node: + You do not have to input values in these fields. It is automatically displayed after selecting an existing page by clicking the <emphasis role="bold">Search and Select Page</emphasis> button. The <emphasis role="bold">Select a page</emphasis> form appears like: </para> - </listitem> - <listitem> - <para> - Select a page from list or search a specific page : - </para> - </listitem> - </orderedlist> - <itemizedlist> - <listitem> - <para> - Enter a search term related to the page which you want to search: - </para> - </listitem> - </itemizedlist> - <mediaobject> - <imageobject> - <imagedata fileref="images/NewSearch1.png" format="PNG" /> - </imageobject> - </mediaobject> - <itemizedlist> - <listitem> - <para> - Choose the field you wish to search in: - </para> - </listitem> - </itemizedlist> - <mediaobject> - <imageobject> - <imagedata fileref="images/NewSearch2.png" format="PNG" /> - </imageobject> - </mediaobject> - <itemizedlist> - <listitem> - <para> - Click the magnifying glass!images/NewGlassIcon.png! icon to perform searching. All pages matching with search term will be listed. - </para> - </listitem> - <listitem> - <para> - Click the OK!images/NewOkIcon.png! icon on the row of the page to select. - </para> - </listitem> - <listitem> - <para> - After selecting a page, the details of this page will be displayed in the <emphasis role="bold">Page Selector</emphasis> form. - </para> - </listitem> - </itemizedlist> - <para> - After configuring the page node settings, the page selector and the node's icon, click the <emphasis role="bold">Save</emphasis> button to accept or the <emphasis role="bold">Cancel</emphasis> button to quit without creating a new node. - </para> - </section> - - <section id="sect-User_Guide-Manage_Navigation_Nodes-Edit_a_node"> - <title>Edit a node</title> - <para> - 1. Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Edit Page and Navigation</emphasis> - </para> - <para> - 2. Select a navigation from the navigation list. - </para> - <para> - 3. Right-click on the selected node and select <emphasis role="bold">Edit this Node</emphasis> option. - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/EditNode1.png" format="PNG" /> - </imageobject> - </mediaobject> - <para> - It will displays a form to edit this node: - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/PageNodeSetting.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - <para> - In the <emphasis role="bold">Page Node Setting</emphasis> tab: you can change the value of these fields: Label, Visible and Publication Date &amp; time. After finish changing, click the <emphasis role="bold">Save</emphasis> button to accept changing or <emphasis role="bold">Cancel</emphasis> button to refuse it. - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/PageSelector6.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - <para> - In the <emphasis role="bold">Page Selector</emphasis> tab : you also search and select another page for this node by clicking the <emphasis role="bold">Search and Select Page</emphasis> button. You can see more details on how to select a page for a node on the above <emphasis role="bold">Add a new node</emphasis> section. After finish changing another page for this node, click the <emphasis role="bold">Save</emphasis> button to accept changing or <emphasis role="bold">Cancel</emphasis> button to leave without saving any changes. - </para> - </section> - - <section id="sect-User_Guide-Manage_Navigation_Nodes-Copy_a_node"> - <title>Copy a node</title> - <para> - You also easily copy a node by following these steps: - </para> - <para> - 1. Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Edit Page and Navigation</emphasis> - </para> - <para> - 2. Select a navigation from the navigation list. - </para> - <para> - 3. Right-click on the selected node and select <emphasis role="bold">Copy node</emphasis> option. - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/CopyNode3.png" format="PNG" /> - </imageobject> - </mediaobject> - <para> - 4. Select the position that you want to paste this node and select <emphasis role="bold">Paste Node</emphasis> option. Click the!images/MarkIcon.png! icon to <emphasis role="bold">Save</emphasis>. - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/PasteNode3.png" format="PNG" /> - </imageobject> - </mediaobject> - </section> - - <section id="sect-User_Guide-Manage_Navigation_Nodes-Clone_nodes"> - <title>Clone nodes</title> - <para> - Clone node<emphasis role="bold">function allows you to copy the node. However, the differences between</emphasis>copy node<emphasis role="bold">and</emphasis>clone node<emphasis role="bold">is that the clone node has its own page and this page has the same content as the selected node, so there will be a new page that has the same name with the selected node's page, is shown in the page list when you access</emphasis>Manage Pages. - </para> - <itemizedlist> - <listitem> - <para> - 1. Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Edit Page and Navigation</emphasis> - </para> - </listitem> - <listitem> - <para> - 2. Select a navigation from the navigation list. - </para> - </listitem> - <listitem> - <para> - 3. Right-click on selected node and select <emphasis role="bold">Clone node</emphasis> option. - </para> <mediaobject> <imageobject> - <imagedata fileref="images/CloneNode2.png" format="PNG" /> + <imagedata fileref="images/SelectPage1.png" format="PNG" width="444" /> </imageobject> </mediaobject> - </listitem> - <listitem> + <para> + This window lists of all existing pages is displayed with basic information. You can follow these guides to select a page for creating a node: + </para> + <para> + Select a page from list or search a specific page : + </para> + <procedure id="proc-User_Guide-Manage_Navigation_Nodes-Search_for_a_page"> + <step> + <para> + Enter a search term related to the page which you want to search: + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/NewSearch1.png" format="PNG" /> + </imageobject> + </mediaobject> + </step> + <step> + <para> + Choose the field you wish to search in: + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/NewSearch2.png" format="PNG" /> + </imageobject> + </mediaobject> + </step> + <step> + <para> + Click the magnifying glass!images/NewGlassIcon.png! icon to perform searching. All pages matching with search term will be listed. + </para> + </step> + <step> + <para> + Click the OK!images/NewOkIcon.png! icon on the row of the page to select. + </para> + </step> + <step> + <para> + After selecting a page, the details of this page will be displayed in the <emphasis role="bold">Page Selector</emphasis> form. + </para> + </step> + </procedure> + <para> + After configuring the page node settings, the page selector and the node's icon, click the <emphasis role="bold">Save</emphasis> button to accept or the <emphasis role="bold">Cancel</emphasis> button to quit without creating a new node. + </para> + </step> + </procedure> + </section> + + <section id="sect-User_Guide-Manage_Navigation_Nodes-Edit_a_node"> + <title>Edit a node</title> + <procedure> + <step> + <para> + Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Edit Page and Navigation</emphasis> + </para> + </step> + <step> + <para> + Select a navigation from the navigation list. + </para> + </step> + <step> + <para> + Right-click on the selected node and select <emphasis role="bold">Edit this Node</emphasis> option. + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/EditNode1.png" format="PNG" /> + </imageobject> + </mediaobject> + <para> + It will displays a form to edit this node: + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/PageNodeSetting.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + </step> + <step> + <para> + In the <emphasis role="bold">Page Node Setting</emphasis> tab: you can change the value of these fields: Label, Visible and Publication Date &amp; time. After finish changing, click the <emphasis role="bold">Save</emphasis> button to accept changing or <emphasis role="bold">Cancel</emphasis> button to refuse it. + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/PageSelector6.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + </step> + <step> + <para> + In the <emphasis role="bold">Page Selector</emphasis> tab : you also search and select another page for this node by clicking the <emphasis role="bold">Search and Select Page</emphasis> button. You can see more details on how to select a page for a node on the above <emphasis role="bold">Add a new node</emphasis> section. After finish changing another page for this node, click the <emphasis role="bold">Save</emphasis> button to accept changing or <emphasis role="bold">Cancel</emphasis> button to leave without saving any changes. + </para> + </step> + </procedure> + </section> + + <section id="sect-User_Guide-Manage_Navigation_Nodes-Copy_a_node"> + <title>Copy a node</title> + <procedure> + <step> + <para> + Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Edit Page and Navigation</emphasis> + </para> + </step> + <step> + <para> + Select a navigation from the navigation list. + </para> + </step> + <step> + <para> + Right-click on the selected node and select <emphasis role="bold">Copy node</emphasis> option. + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/CopyNode3.png" format="PNG" /> + </imageobject> + </mediaobject> + </step> + <step> + <para> + Select the position that you want to paste this node and select <emphasis role="bold">Paste Node</emphasis> option. Click the!images/MarkIcon.png! icon to <emphasis role="bold">Save</emphasis>. + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/PasteNode3.png" format="PNG" /> + </imageobject> + </mediaobject> + </step> + </procedure> + </section> + + <section id="sect-User_Guide-Manage_Navigation_Nodes-Clone_nodes"> + <title>Clone nodes</title> <para> - 4. Select the position that you want to paste this node and select <emphasis role="bold">Paste Node</emphasis> option. Click the!images/MarkIcon.png! icon to <emphasis role="bold">Save</emphasis>. + <emphasis role="bold">Clone node</emphasis> function allows you to copy the node. However, the differences between <emphasis role="bold">copy node</emphasis> and <emphasis role="bold">clone node</emphasis> is that the clone node has its own page and this page has the same content as the selected node, so there will be a new page that has the same name with the selected node's page, is shown in the page list when you access<emphasis role="bold">Manage Pages</emphasis>. </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/PasteCloneNode2.png" format="PNG" /> - </imageobject> - </mediaobject> - <para> - In <emphasis role="bold">Manage Pages</emphasis> you will see: - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/ManagePage2.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - </listitem> - </itemizedlist> - </section> + <procedure> + <step> + <para> + Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Edit Page and Navigation</emphasis> + </para> + </step> + <step> + <para> + Select a navigation from the navigation list. + </para> + </step> + <step> + <para> + Right-click on selected node and select <emphasis role="bold">Clone node</emphasis> option. + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/CloneNode2.png" format="PNG" /> + </imageobject> + </mediaobject> + </step> + <step> + <para> + Select the position that you want to paste this node and select <emphasis role="bold">Paste Node</emphasis> option. Click the!images/MarkIcon.png! icon to <emphasis role="bold">Save</emphasis>. + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/PasteCloneNode2.png" format="PNG" /> + </imageobject> + </mediaobject> + <para> + In <emphasis role="bold">Manage Pages</emphasis> you will see: + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/ManagePage2.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + </step> + </procedure> + </section> - <section id="sect-User_Guide-Manage_Navigation_Nodes-Cut_a_node"> - <title>Cut a node</title> - <para> - 1. Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Edit Page and Navigation</emphasis> - </para> - <para> - 2. Select a navigation from the navigation list. - </para> - <para> - 3. Right-click on the selected node and select <emphasis role="bold">Cut node</emphasis> option. - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/CutNode4.png" format="PNG" /> - </imageobject> - </mediaobject> - <para> - 4. Select the position that you want to paste this node and select <emphasis role="bold">Paste Node</emphasis> option. Click the!images/MarkIcon.png! icon to <emphasis role="bold">Save</emphasis>. - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/PasteCutNode4.png" format="PNG" /> - </imageobject> - </mediaobject> - </section> + <section id="sect-User_Guide-Manage_Navigation_Nodes-Cut_a_node"> + <title>Cut a node</title> + <procedure> + <step> + <para> + Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Edit Page and Navigation</emphasis> + </para> + </step> + <step> + <para> + Select a navigation from the navigation list. + </para> + </step> + <step> + <para> + Right-click on the selected node and select <emphasis role="bold">Cut node</emphasis> option. + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/CutNode4.png" format="PNG" /> + </imageobject> + </mediaobject> + </step> + <step> + <para> + Select the position that you want to paste this node and select <emphasis role="bold">Paste Node</emphasis> option. Click the!images/MarkIcon.png! icon to <emphasis role="bold">Save</emphasis>. + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/PasteCutNode4.png" format="PNG" /> + </imageobject> + </mediaobject> + </step> + </procedure> + </section> - <section id="sect-User_Guide-Manage_Navigation_Nodes-Delete_a_node"> - <title>Delete a node</title> - <orderedlist> - <listitem> - <para> - 1. Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Edit Page and Navigation</emphasis> - </para> - </listitem> - <listitem> - <para> - 2. Select a navigation from the navigation list. - </para> - </listitem> - <listitem> - <para> - 3. Right-click on the selected node and select <emphasis role="bold">Delete node</emphasis> option. - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/DeleteNode2.png" format="PNG" /> - </imageobject> - </mediaobject> - <para> - It will display an alert message, click the <emphasis role="bold">OK</emphasis> button to accept deleting or <emphasis role="bold">Cancel</emphasis> button to quit without deleting a node. - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/http.png" format="PNG" /> - </imageobject> - </mediaobject> - </listitem> - </orderedlist> - </section> - + <section id="sect-User_Guide-Manage_Navigation_Nodes-Delete_a_node"> + <title>Delete a node</title> + <procedure> + <step> + <para> + Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Edit Page and Navigation</emphasis> + </para> + </step> + <step> + <para> + Select a navigation from the navigation list. + </para> + </step> + <step> + <para> + Right-click on the selected node and select <emphasis role="bold">Delete node</emphasis> option. + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/DeleteNode2.png" format="PNG" /> + </imageobject> + </mediaobject> + <para> + It will display an alert message, click the <emphasis role="bold">OK</emphasis> button to accept deleting or <emphasis role="bold">Cancel</emphasis> button to quit without deleting a node. + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/http.png" format="PNG" /> + </imageobject> + </mediaobject> + </step> + </procedure> + </section> </section> Modified: portal/trunk/docs/user-guide/en/modules/portal/Manage_Page_Navigation.xml =================================================================== --- portal/trunk/docs/user-guide/en/modules/portal/Manage_Page_Navigation.xml 2009-12-16 04:14:57 UTC (rev 1020) +++ portal/trunk/docs/user-guide/en/modules/portal/Manage_Page_Navigation.xml 2009-12-16 04:50:09 UTC (rev 1021) @@ -7,7 +7,7 @@ Copyright (C) 2009 eXo Platform SAS. This is free software; you can redistribute it and/or modify it - under the terms of the GNU Lesser General Public License as + under the titles of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. @@ -26,151 +26,170 @@ In order to understand clearly about what the navigation is and navigation types that GateIn Portal supports, please refer the <xref linkend="sect-User_Guide-Navigation" /> page. </para> + <section id="User_Guide-Manage_Page_Navigation-Portals_page_navigation"> + <title>Portal's page navigation</title> + <para> + Stuff Goes here? + </para> + </section> + + <section id="User_Guide-Manage_Page_Navigation-Creating_a_portals_navigation"> + <title>Creating a portal's navigation</title> + <para> + The page navigation of a portal is created automatically when a portal is created. + </para> + </section> + + <section id="User_Guide-Manage_Page_Navigation-Editing_a_portals_navigation"> + <title>Editing a portal's navigation</title> + <para> + Only users who have the edit right on a portal can perform this action. + </para> + <para> + Follows these below guides to edit a portal's navigation: + </para> + <procedure> + <step> + <para> + Go to <emphasis role="bold">GateIn Start</emphasis>-&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis>--&gt; <emphasis role="bold">Edit Page and Navigation</emphasis>. + </para> + </step> + <step> + <para> + Select Portal navigation in list on the left pane (eg: portal: classic's Nav). + </para> + </step> + <step> + <para> + Right click the blank space on the left pane and select <emphasis role="bold">Edit Navigation</emphasis> in the menu: + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/EditPortalNavigation.png" format="PNG" /> + </imageobject> + </mediaobject> + <para> + The form for editing the portal navigation will be opened: + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/EditPortalNavigation2.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + <para> + The number that users select in the <emphasis role="bold">Priority</emphasis> field is the priority of a page navigation on the Navigation bar. + </para> + </step> + <step> + <para> + Make changes to fields in this form: <emphasis role="bold">Description</emphasis>, <emphasis role="bold">Priority</emphasis>. + </para> + </step> + <step> + <para> + Click the <emphasis role="bold">Save</emphasis> button to accept changes. + </para> + </step> + <step> + <para> + Click the!images/OKIcon.png! to take effect of new change or click the <emphasis role="bold">Cancel</emphasis> button to quit without saving any change. + </para> + </step> + </procedure> + </section> + + <section id="User_Guide-Manage_Page_Navigation-Deleting_a_portals_navigation"> + <title>Deleting a portal's navigation</title> + <para> + No one can create the portal's page navigation so no one can delete it. A navigation is deleted automatically after you delete its portal. + </para> + </section> - <section id="sect-User_Guide-Manage_Page_Navigation-Portals_page_navigation"> - <title>Portal's page navigation</title> - <para> - Stuff Goes here? - </para> - </section> + <section id="User_Guide-Manage_Page_Navigation-Groups_page_navigation"> + <title>Group's page navigation</title> + <para> + Each group has only one page navigation. Only users of that group have the "manager" membership can create/edit/delete navigation for that group + </para> + </section> - <section id="sect-User_Guide-Manage_Page_Navigation-Creating_a_portals_navigation"> - <title>Creating a portal's navigation</title> - <para> - The page navigation of a portal is created automatically when a portal is created. - </para> - </section> - - <section id="sect-User_Guide-Manage_Page_Navigation-Editing_a_portals_navigation"> - <title>Editing a portal's navigation</title> - <para> - Only users who have the edit right on a portal can perform this action. - </para> - <para> - Follows these below guides to edit a portal 's navigation: - </para> - <para> - 1. Go to <emphasis role="bold">GateIn Start</emphasis>-&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis>--&gt; <emphasis role="bold">Edit Page and Navigation</emphasis>. - </para> - <para> - 2. Select Portal navigation in list on the left pane (eg: portal: classic's Nav). - </para> - <para> - 3. Right click the blank space on the left pane and select <emphasis role="bold">Edit Navigation</emphasis> in the menu: - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/EditPortalNavigation.png" format="PNG" /> - </imageobject> - </mediaobject> - <para> - The form for editing the portal navigation will be opened: - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/EditPortalNavigation2.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - <para> - <emphasis><emphasis role="bold">Notice</emphasis></emphasis>: The number that users select in the <emphasis role="bold">Priority</emphasis> field is the priority of a page navigation on the Navigation bar. - </para> - <para> - 4. Make changes to fields in this form: <emphasis role="bold">Description</emphasis>, <emphasis role="bold">Priority</emphasis>. - </para> - <para> - 5. Click the <emphasis role="bold">Save</emphasis> button to accept changes. - </para> - <para> - 6. Click the!images/OKIcon.png! to take effect of new changes. - </para> - <para> - Or click the <emphasis role="bold">Cancel</emphasis> button to quit without saving any change. - </para> - </section> - - <section id="sect-User_Guide-Manage_Page_Navigation-Deleting_a_portals_navigation"> - <title>Deleting a portal's navigation</title> - <para> - No one can create the portal's page navigation so no one can delete it. A navigation is deleted automatically after you delete its portal. - </para> - </section> - - <section id="sect-User_Guide-Manage_Page_Navigation-Groups_page_navigation"> - <title>Group's page navigation</title> - <para> - Each group has only one page navigation. Only users of that group have the "manager" membership can create/edit/delete navigation for that group - </para> - </section> - - <section id="sect-User_Guide-Manage_Page_Navigation-Editing_a_groups_navigation"> - <title>Editing a group's navigation</title> - <para> - 1. Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Edit Page and Navigation</emphasis>. - </para> - <para> - 2. Select a Group navigation in the list on the left pane (eg: group:platform/administrator's Nav). All pages of this group will be listed underneath. - </para> - <para> - 3. Right click the blank space on the left pane and select <emphasis role="bold">Edit Navigation</emphasis> in the context menu: - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/EditGroupNavigation.png" format="PNG" /> - </imageobject> - </mediaobject> - <para> - The form for editing the group navigation will be opened: - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/EditGroupNavigation2.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - <para> - 4. Make changes for two fields: <emphasis role="bold">Description</emphasis> and <emphasis role="bold">Priority</emphasis>. - </para> - <para> - <emphasis><emphasis role="bold">Notice</emphasis></emphasis>: The number that users select in the <emphasis role="bold">Priority</emphasis> field is the priority of a page navigation on the Navigation bar. - </para> - <para> - 5. Click the <emphasis role="bold">Save</emphasis> button to accept any changes. - </para> - <para> - 6. Click the!images/OKIcon.png! to take effect new changes on the Navigation bar. - </para> - <para> - Or click the <emphasis role="bold">Cancel</emphasis> button to quit without saving any change. - </para> - </section> - - <section id="sect-User_Guide-Manage_Page_Navigation-Users_page_navigation"> - <title>User's page navigation</title> - <para> - Stuff Goes here? - </para> - </section> - - <section id="sect-User_Guide-Manage_Page_Navigation-Creating_a_users_navigation"> - <title>Creating a user's navigation</title> - <para> - The page navigation of a user is created automatically when a user is created (registered). So an administrator don't have to create it. - </para> - </section> - - <section id="sect-User_Guide-Manage_Page_Navigation-Editing_a_users_navigation"> - <title>Editing a user's navigation</title> - <para> - Only the user who is the owner of the user page navigation can edit it. - </para> - </section> - - <section id="sect-User_Guide-Manage_Page_Navigation-Deleting_a_users_navigation"> - <title>Deleting a user's navigation</title> - <para> - No one can create user's page navigation so that no one can delete it. A user's navigation is deleted automatically when its user is deleted. - </para> - </section> + <section id="User_Guide-Manage_Page_Navigation-Editing_a_groups_navigation"> + <title>Editing a group's navigation</title> + <procedure> + <step> + <para> + Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Edit Page and Navigation</emphasis>. + </para> + </step> + <step> + <para> + Select a Group navigation in the list on the left pane (eg: group:platform/administrator's Nav). All pages of this group will be listed underneath. + </para> + </step> + <step> + <para> + Right click the blank space on the left pane and select <emphasis role="bold">Edit Navigation</emphasis> in the context menu: + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/EditGroupNavigation.png" format="PNG" /> + </imageobject> + </mediaobject> + <para> + The form for editing the group navigation will be opened: + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/EditGroupNavigation2.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + </step> + <step> + <para> + Make changes for two fields: <emphasis role="bold">Description</emphasis> and <emphasis role="bold">Priority</emphasis>. + </para> + <para> + The number that users select in the <emphasis role="bold">Priority</emphasis> field is the priority of a page navigation on the Navigation bar. + </para> + </step> + <step> + <para> + Click the <emphasis role="bold">Save</emphasis> button to accept any changes. + </para> + </step> + <step> + <para> + Click the!images/OKIcon.png! to take effect new changes on the Navigation bar or click the <emphasis role="bold">Cancel</emphasis> button to quit without saving any change. + </para> + </step> + </procedure> + </section> + + <section id="User_Guide-Manage_Page_Navigation-Users_page_navigation"> + <title>User's page navigation</title> + <para> + Stuff Goes here? + </para> + </section> + + <section id="User_Guide-Manage_Page_Navigation-Creating_a_users_navigation"> + <title>Creating a user's navigation</title> + <para> + The page navigation of a user is created automatically when a user is created (registered). So an administrator don't have to create it. + </para> + </section> + + <section id="User_Guide-Manage_Page_Navigation-Editing_a_users_navigation"> + <title>Editing a user's navigation</title> + <para> + Only the user who is the owner of the user page navigation can edit it. + </para> + </section> + + <section id="User_Guide-Manage_Page_Navigation-Deleting_a_users_navigation"> + <title>Deleting a user's navigation</title> + <para> + No one can create user's page navigation so that no one can delete it. A user's navigation is deleted automatically when its user is deleted. + </para> + </section> </section> - - Modified: portal/trunk/docs/user-guide/en/modules/portal/Manage_Pages.xml =================================================================== --- portal/trunk/docs/user-guide/en/modules/portal/Manage_Pages.xml 2009-12-16 04:14:57 UTC (rev 1020) +++ portal/trunk/docs/user-guide/en/modules/portal/Manage_Pages.xml 2009-12-16 04:50:09 UTC (rev 1021) @@ -22,440 +22,446 @@ 02110-1301 USA, or see the FSF site: http://www.fsf.org. --><title>Manage Pages</title> - <para> - Only by using one page list can users add, edit, delete and view quickly and easily which pages you like to. Following these guides to manage pages: - </para> - <section id="sect-User_Guide-Manage_Pages-Add_a_new_Page_in_the_Page_List"> - <title>Add a new Page in the Page List</title> <para> - You easily add a new page by following these simple steps: + Only by using one page list can users add, edit, delete and view quickly and easily which pages you like to. Following these guides to manage pages: </para> - <para> - 1. Go to <emphasis role="bold">GateIn</emphasis> -&gt;<emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Manage Pages</emphasis> - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/ManagePage.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - <para> - For GateIn Portal 2.6 - </para> - <orderedlist> - <listitem> + + <section id="sect-User_Guide-Manage_Pages-Add_a_new_Page_in_the_Page_List"> + <title>Add a new Page in the Page List</title> <para> - 1. Go to <emphasis role="bold">Administrator</emphasis> on the Toolbar --&gt; <emphasis role="bold">Manage Pages</emphasis> + You easily add a new page by following these simple steps: </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/ManagePage2.6.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - <para> - Details - </para> - <informaltable colsep="0" frame="none" rowsep="0"> - <tgroup cols="2"> - <colspec align="center"></colspec> - <colspec align="center"></colspec> - <tbody> - <row> - <entry> - <emphasis role="bold"> Button </emphasis> - </entry> - <entry> - <emphasis role="bold"> Description </emphasis> - </entry> - </row> - <row> - <entry> - Add New Page - </entry> - <entry> - allows you to add a new page. - </entry> - </row> - <row> - <entry> - Back - </entry> - <entry> - allows you to return to home page. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </listitem> - <listitem> - <para> - 2. Click the <emphasis role="bold">Add New Page</emphasis> button. - </para> - </listitem> - <listitem> - <para> - 3. Enter values for fields in the <emphasis role="bold">Page Setting</emphasis> tab - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/PageSetting.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - <informaltable colsep="0" frame="none" rowsep="0"> - <tgroup cols="2"> - <colspec align="center"></colspec> - <colspec align="center"></colspec> - <tbody> - <row> - <entry> - <emphasis role="bold"> Name </emphasis> - </entry> - <entry> - <emphasis role="bold"> Description </emphasis> - </entry> - </row> - <row> - <entry> - Page Id - </entry> - <entry> - The string to identify the page. It is automatically generated when you will finish creating page. - </entry> - </row> - <row> - <entry> - Owner type - </entry> - <entry> - The owner type of the the page (portal, group or user). The "User" type is displayed by default. You can change the owner type by clicking on the icon. - </entry> - </row> - <row> - <entry> - Owner Id - </entry> - <entry> - The identification name of page owner. When the owner type is "group", there will be a list of groups of which you have to select one. - </entry> - </row> - <row> - <entry> - Page Name - </entry> - <entry> - The name of the page. This is a required field and must be unique. Only alpha, digit and underscore characters are allowed to be used for this field and it must have a length between 3 and 30 characters - </entry> - </row> - <row> - <entry> - Page title - </entry> - <entry> - The title of the the page. This field is not required and must have a length between 3 and 30 characters. - </entry> - </row> - <row> - <entry> - Show Max Window - </entry> - <entry> - The option allows to choose whether showing the page in maximum size or not. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - <para> - If the <emphasis role="bold">Owner type</emphasis> is "portal" or "group": - </para> - <itemizedlist> - <listitem> + <procedure> + <step> <para> - <emphasis role="bold">Owner type</emphasis> is 'portal': it means you create a page for a portal. Thus only users who have edit permissions on the portal can create this page type. + Go to <emphasis role="bold">GateIn</emphasis> -&gt;<emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Manage Pages</emphasis>. </para> - </listitem> - <listitem> + <mediaobject> + <imageobject> + <imagedata fileref="images/ManagePage.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + </step> + <step> <para> - <emphasis role="bold">Owner type</emphasis> is 'group': it means you create a page for a group. Thus only users who are 'manager' of a group can create this page type. + Click on Add New Page </para> - </listitem> - </itemizedlist> - <mediaobject> - <imageobject> - <imagedata fileref="images/PageSetting1.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - <itemizedlist> - <listitem> + <mediaobject> + <imageobject> + <imagedata fileref="images/ManagePage2.6.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + </step> + <step> <para> - Permission Setting is initialized + Details </para> - </listitem> - </itemizedlist> - <mediaobject> - <imageobject> - <imagedata fileref="images/PermissionSetting1.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - <itemizedlist> - <listitem> + <informaltable colsep="0" frame="none" rowsep="0"> + <tgroup cols="2"> + <colspec align="center"></colspec> + <colspec align="center"></colspec> + <tbody> + <row> + <entry> + <emphasis role="bold"> Button </emphasis> + </entry> + <entry> + <emphasis role="bold"> Description </emphasis> + </entry> + </row> + <row> + <entry> + Add New Page + </entry> + <entry> + allows you to add a new page. + </entry> + </row> + <row> + <entry> + Back + </entry> + <entry> + allows you to return to home page. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </step> + <step> <para> + Click the <emphasis role="bold">Add New Page</emphasis> button. + </para> + </step> + <step> + <para> + Enter values for fields in the <emphasis role="bold">Page Setting</emphasis> tab + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/PageSetting.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + <informaltable colsep="0" frame="none" rowsep="0"> + <tgroup cols="2"> + <colspec align="center"></colspec> + <colspec align="center"></colspec> + <tbody> + <row> + <entry> + <emphasis role="bold"> Name </emphasis> + </entry> + <entry> + <emphasis role="bold"> Description </emphasis> + </entry> + </row> + <row> + <entry> + Page Id + </entry> + <entry> + The string to identify the page. It is automatically generated when you will finish creating page. + </entry> + </row> + <row> + <entry> + Owner type + </entry> + <entry> + The owner type of the the page (portal, group or user). The "User" type is displayed by default. You can change the owner type by clicking on the icon. + </entry> + </row> + <row> + <entry> + Owner Id + </entry> + <entry> + The identification name of page owner. When the owner type is "group", there will be a list of groups of which you have to select one. + </entry> + </row> + <row> + <entry> + Page Name + </entry> + <entry> + The name of the page. This is a required field and must be unique. Only alpha, digit and underscore characters are allowed to be used for this field and it must have a length between 3 and 30 characters + </entry> + </row> + <row> + <entry> + Page title + </entry> + <entry> + The title of the the page. This field is not required and must have a length between 3 and 30 characters. + </entry> + </row> + <row> + <entry> + Show Max Window + </entry> + <entry> + The option allows to choose whether showing the page in maximum size or not. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + <para> + If the <emphasis role="bold">Owner type</emphasis> is "portal" or "group": + </para> + <itemizedlist> + <listitem> + <para> + <emphasis role="bold">Owner type</emphasis> is 'portal': it means you create a page for a portal. Thus only users who have edit permissions on the portal can create this page type. + </para> + </listitem> + <listitem> + <para> + <emphasis role="bold">Owner type</emphasis> is 'group': it means you create a page for a group. Thus only users who are 'manager' of a group can create this page type. + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/PageSetting1.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + </listitem> + <listitem> + <para> + Permission Setting is initialized + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/PermissionSetting1.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + </listitem> + <listitem> + <para> With <emphasis role="bold">Access Permission</emphasis>: The content of this tab is identical to the <emphasis role="bold">Owner type</emphasis> field in the <emphasis role="bold">Page Setting</emphasis> tab. Thus, all users have access rights of the page type selected in the <emphasis role="bold">Owner type</emphasis> field will appear in this tab. But you also can change the value of this tab as follows: + </para> + </listitem> + <listitem> + <para> + Check the check box if you want to share access with everyone + </para> + </listitem> + <listitem> + <para> + Or click the <emphasis role="bold">Add Permission</emphasis> button to assign permission on group level, then select a group and membership. + </para> + </listitem> + <listitem> + <para> + Or click the trash can icon to remove a group from the list. + </para> + </listitem> + <listitem> + <para> + With <emphasis role="bold">Edit Permission</emphasis>: The content of this tab depends on the value of the <emphasis role="bold">Owner type</emphasis> field in the <emphasis role="bold">Page Setting</emphasis> tab. + </para> + </listitem> + <listitem> + <para> + If the <emphasis role="bold">Owner type</emphasis> is "group", edit permission is assigned to users who are "manager" of the group that is selected in <emphasis role="bold">Owner id</emphasis>. You only can change this value when editing the page. + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/EditPermission1.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + </listitem> + <listitem> + <para> + If the <emphasis role="bold">Owner type</emphasis> is "portal": The name of the current portal is automatically selected for <emphasis role="bold">Owner id</emphasis> so that the edit permissions are assigned to users who can edit the current portal. Users only can change this value when editing the page. + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/EditPermission2.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + </listitem> + </itemizedlist> + </step> + <step> + <para> + Click the <emphasis role="bold">Save</emphasis> button to accept creating a new page or the <emphasis role="bold">Cancel</emphasis> button to quit the form. </para> - </listitem> - <listitem> + </step> + </procedure> + </section> + + <section id="sect-User_Guide-Manage_Pages-Edit_a_Page"> + <title>Edit a Page</title> + <procedure> + <step> <para> - Check the check box if you want to share access with everyone + Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Manage Pages</emphasis> </para> - </listitem> - <listitem> + </step> + <step> <para> - Or click the <emphasis role="bold">Add Permission</emphasis> button to assign permission on group level, then select a group and membership. + In the existing pages list: click the edit icon on the row of page you want to edit. </para> - </listitem> - <listitem> + <!-- <informaltable colsep="0" frame="none" rowsep="0"> + <tgroup cols="2"> + <colspec align="center"></colspec> + <colspec align="center"></colspec> + <tbody> + <row> + <entry> + <emphasis role="bold"> Indicator </emphasis> + </entry> + <entry> + <emphasis role="bold"> Meaning </emphasis> + </entry> + </row> + <row> + <entry> + !images/PreviewPage.png! + </entry> + <entry> + Preview page: allows viewing node's page with preview mode in a Normal Page + </entry> + </row> + <row> + <entry> + !images/EditPage.png! + </entry> + <entry> + Edit page properties: allows editing node's page properties + </entry> + </row> + <row> + <entry> + !images/ShowContainer.png! + </entry> + <entry> + Show container: allows to list all existing containers that will be used to change the layout of a selected page + </entry> + </row> + <row> + <entry> + !images/ShowPortlet.png! + </entry> + <entry> + Show portlet: allows to list all existing portlets that will be used to re-arrange the content of selected page. + </entry> + </row> + <row> + <entry> + !images/SavePage.png! + </entry> + <entry> + Save page: allows saving changes of a page + </entry> + </row> + <row> + <entry> + !images/Back.png! + </entry> + <entry> + Back: allows returning to the page list without saving + </entry> + </row> + <row> + <entry> + !images/Finish.png! + </entry> + <entry> + Finish:allows saving and returning to the page list + </entry> + </row> + </tbody> + </tgroup> + </informaltable> --> <para> - Or click the trash can icon to remove a group from the list. + Edit page properties Click the edit!images/EditPage.png! icon to show a form to edit page properties. </para> - </listitem> - </itemizedlist> - <itemizedlist> - <listitem> + </step> + <step> <para> - With <emphasis role="bold">Edit Permission</emphasis>: The content of this tab depends on the value of the <emphasis role="bold">Owner type</emphasis> field in the <emphasis role="bold">Page Setting</emphasis> tab. + In the <emphasis role="bold">Page Properties</emphasis> window: </para> - </listitem> - <listitem> + <informaltable colsep="0" frame="none" rowsep="0"> + <tgroup cols="2"> + <colspec align="center"></colspec> + <colspec align="center"></colspec> + <tbody> + <row> + <entry> + <emphasis role="bold"> Name </emphasis> + </entry> + <entry> + <emphasis role="bold"> Description </emphasis> + </entry> + </row> + <row> + <entry> + Page Id + </entry> + <entry> + The string to identify editing page. This string is generated automatically, user can not change. + </entry> + </row> + <row> + <entry> + Owner type + </entry> + <entry> + The type of editing page. User can not change. + </entry> + </row> + <row> + <entry> + Owner Id + </entry> + <entry> + The identification name of page's owner. User can not change. + </entry> + </row> + <row> + <entry> + Page name + </entry> + <entry> + The name of the page. User can not change. + </entry> + </row> + <row> + <entry> + Page title + </entry> + <entry> + The title of page. User can change and it must have length from 3 to 30 characters. + </entry> + </row> + <row> + <entry> + Show Max Window + </entry> + <entry> + The option allows whether showing page in maximum size or not. User should check this option for desktop page only. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + <itemizedlist> + <listitem> + <para> + Permission Setting: This form is supported for pages of a group or a portal. Because page of an user is private, no one else can access or edit user's page except the creator, so you do not have to set permission for it. Permission on each page is set in two levels: Access right and Edit right. + </para> + </listitem> + <listitem> +<important> +<title>This does not match GateIn-3.0.0-Beta02</title> + <para> + <emphasis role="bold">Access right</emphasis>: Page Access right can be set to some user groups or set to everyone (also includes unregistered users). There is a list of current access permissions on page. You can click delete icon to remove permission or click the <emphasis role="bold">Add Permission</emphasis> button to add more or tick on <emphasis role="bold">Make it public</emphasis> option check box to allow all users to access. + </para> +</important> + </listitem> + <listitem> +<important> +<title>This does not match GateIn-3.0.0-Beta02</title> + <para> + <emphasis role="bold">Edit right</emphasis>: It allows users to change information of page. Edit right only is set for a group of users. Edit right on a page can be set for one group with one specific membership type (or <emphasis role="bold">means every membership types in group). If you want to re-assign this right to another group, click</emphasis>Select Permission to choose another one. + </para> +</important> + </listitem> + <listitem> + <para> + Editing page container layout + </para> + </listitem> + </itemizedlist> + </step> + <step> <para> - If the <emphasis role="bold">Owner type</emphasis> is "group", edit permission is assigned to users who are "manager" of the group that is selected in <emphasis role="bold">Owner id</emphasis>. You only can change this value when editing the page. + Click !images/ShowContainer.png! icon to show current container layout of selected page on your right and all the container layouts list on the left pane. </para> - </listitem> - </itemizedlist> - <mediaobject> - <imageobject> - <imagedata fileref="images/EditPermission1.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - <itemizedlist> - <listitem> <para> - If the <emphasis role="bold">Owner type</emphasis> is "portal": The name of the current portal is automatically selected for <emphasis role="bold">Owner id</emphasis> so that the edit permissions are assigned to users who can edit the current portal. Users only can change this value when editing the page. + If you want to change current layout, select a layout type from the list on the left pane, then left click on the template you want and drag and drop it into the right pane. New container will be displayed on the right pane. You can change position of current container by left click and drag and drop it to another place on the right pane or remove current container by clicking delete icon on the right corner. </para> - </listitem> - </itemizedlist> - <mediaobject> - <imageobject> - <imagedata fileref="images/EditPermission2.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - </listitem> - <listitem> - <para> - 4. Click the <emphasis role="bold">Save</emphasis> button to accept creating a new page or the <emphasis role="bold">Cancel</emphasis> button to quit the form. - </para> - </listitem> - </orderedlist> + <itemizedlist> + <listitem> + <para> + Editing page portlet layout + </para> + </listitem> + </itemizedlist> + </step> + <step> + <para> + Click !images/ShowPortlet.png! icon to show current portlet layout of page. + </para> + <para> + If you want to change current layout, select layout type from the list on the left pane, then left click on the template you want and drag and drop it into the right pane. New portlet will be added and displayed in the right pane. You can change position of current portlet by left click and drag and drop it to the place you want on the right pane or remove current portlet by clicking delete icon. + </para> + </step> + </procedure> </section> - <section id="sect-User_Guide-Manage_Pages-Edit_a_Page"> - <title>Edit a Page</title> - <para> - 1. Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Manage Pages</emphasis> - </para> - <para> - 2. In the existing pages list: click the edit icon on the row of page you want to edit. - </para> - <informaltable colsep="0" frame="none" rowsep="0"> - <tgroup cols="2"> - <colspec align="center"></colspec> - <colspec align="center"></colspec> - <tbody> - <row> - <entry> - <emphasis role="bold"> Indicator </emphasis> - </entry> - <entry> - <emphasis role="bold"> Meaning </emphasis> - </entry> - </row> - <row> - <entry> - !images/PreviewPage.png! - </entry> - <entry> - Preview page: allows viewing node's page with preview mode in a Normal Page - </entry> - </row> - <row> - <entry> - !images/EditPage.png! - </entry> - <entry> - Edit page properties: allows editing node's page properties - </entry> - </row> - <row> - <entry> - !images/ShowContainer.png! - </entry> - <entry> - Show container: allows to list all existing containers that will be used to change the layout of a selected page - </entry> - </row> - <row> - <entry> - !images/ShowPortlet.png! - </entry> - <entry> - Show portlet: allows to list all existing portlets that will be used to re-arrange the content of selected page. - </entry> - </row> - <row> - <entry> - !images/SavePage.png! - </entry> - <entry> - Save page: allows saving changes of a page - </entry> - </row> - <row> - <entry> - !images/Back.png! - </entry> - <entry> - Back: allows returning to the page list without saving - </entry> - </row> - <row> - <entry> - !images/Finish.png! - </entry> - <entry> - Finish:allows saving and returning to the page list - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - <itemizedlist> - <listitem> - <para> - Edit page properties Click the edit!images/EditPage.png! icon to show a form to edit page properties. - </para> - </listitem> - </itemizedlist> - <para> - In the <emphasis role="bold">Page Setting</emphasis> tab: - </para> - <informaltable colsep="0" frame="none" rowsep="0"> - <tgroup cols="2"> - <colspec align="center"></colspec> - <colspec align="center"></colspec> - <tbody> - <row> - <entry> - <emphasis role="bold"> Name </emphasis> - </entry> - <entry> - <emphasis role="bold"> Description </emphasis> - </entry> - </row> - <row> - <entry> - Page Id - </entry> - <entry> - The string to identify editing page. This string is generated automatically, user can not change. - </entry> - </row> - <row> - <entry> - Owner type - </entry> - <entry> - The type of editing page. User can not change. - </entry> - </row> - <row> - <entry> - Owner Id - </entry> - <entry> - The identification name of page's owner. User can not change. - </entry> - </row> - <row> - <entry> - Page name - </entry> - <entry> - The name of the page. User can not change. - </entry> - </row> - <row> - <entry> - Page title - </entry> - <entry> - The title of page. User can change and it must have length from 3 to 30 characters. - </entry> - </row> - <row> - <entry> - Show Max Window - </entry> - <entry> - The option allows whether showing page in maximum size or not. User should check this option for desktop page only. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - <itemizedlist> - <listitem> - <para> - Permission Setting: This form is supported for pages of a group or a portal. Because page of an user is private, no one else can access or edit user's page except the creator, so you do not have to set permission for it. Permission on each page is set in two levels: Access right and Edit right. - </para> - </listitem> - <listitem> - <para> - <emphasis role="bold">Access right</emphasis>: Page Access right can be set to some user groups or set to everyone (also includes unregistered users). There is a list of current access permissions on page. You can click delete icon to remove permission or click the <emphasis role="bold">Add Permission</emphasis> button to add more or tick on <emphasis role="bold">Make it public</emphasis> option check box to allow all users to access. - </para> - </listitem> - <listitem> - <para> - <emphasis role="bold">Edit right</emphasis>: It allows users to change information of page. Edit right only is set for a group of users. Edit right on a page can be set for one group with one specific membership type (or <emphasis role="bold">means every membership types in group). If you want to re-assign this right to another group, click</emphasis>Select Permission to choose another one. - </para> - </listitem> - </itemizedlist> - <itemizedlist> - <listitem> - <para> - Editing page container layout - </para> - </listitem> - </itemizedlist> - <para> - Click !images/ShowContainer.png! icon to show current container layout of selected page on your right and all the container layouts list on the left pane. - </para> - <para> - If you want to change current layout, select a layout type from the list on the left pane, then left click on the template you want and drag and drop it into the right pane. New container will be displayed on the right pane. You can change position of current container by left click and drag and drop it to another place on the right pane or remove current container by clicking delete icon on the right corner. - </para> - <itemizedlist> - <listitem> - <para> - Editing page portlet layout - </para> - </listitem> - </itemizedlist> - <para> - Click !images/ShowPortlet.png! icon to show current portlet layout of page. - </para> - <para> - If you want to change current layout, select layout type from the list on the left pane, then left click on the template you want and drag and drop it into the right pane. New portlet will be added and displayed in the right pane. You can change position of current portlet by left click and drag and drop it to the place you want on the right pane or remove current portlet by clicking delete icon. - </para> - </section> - <section id="sect-User_Guide-Manage_Pages-View_a_Page"> <title>View a Page</title> <para> Modified: portal/trunk/docs/user-guide/en/modules/portal/Manage_Portals.xml =================================================================== --- portal/trunk/docs/user-guide/en/modules/portal/Manage_Portals.xml 2009-12-16 04:14:57 UTC (rev 1020) +++ portal/trunk/docs/user-guide/en/modules/portal/Manage_Portals.xml 2009-12-16 04:50:09 UTC (rev 1021) @@ -30,15 +30,84 @@ <para> You can change information of the current using portal such as properties or layout. However, you must have the edit right given by an Admininstrator. When you have edit right, follow these steps to edit the current portal: </para> - <para> - 1. Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Edit Current Portal</emphasis>. A form to edit the current portal will appear: - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/EditCurrentPortal.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - <informaltable colsep="0" frame="none" rowsep="0"> + <procedure> + <step> + <para> + Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Edit Current Portal</emphasis>. A form to edit the current portal will appear: + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/EditCurrentPortal.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + <variablelist> + <varlistentry> + <term>Preview page</term> + <listitem> + <para> + allows viewing node's page in preview mode. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Edit page properties</term> + <listitem> + <para> + Allows editing node's page properties. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Show container</term> + <listitem> + <para> + Allows listing all existing containers when editing node's page. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Show portlet</term> + <listitem> + <para> + Allows listing all existing portlets when editing node's page. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Save page</term> + <listitem> + <para> + Allows saving changes of page when editing node's page. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Rollback</term> + <listitem> + <para> + Allows canceling all changes that have not been saved. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Abort</term> + <listitem> + <para> + Allows canceling all changes that have not been saved and escaping Edit page and navigation form. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Finish</term> + <listitem> + <para> + Allows saving all changes and escaping Edit page and navigation form. + </para> + </listitem> + </varlistentry> + </variablelist> + </step> + <!-- <informaltable colsep="0" frame="none" rowsep="0"> <tgroup cols="2"> <colspec align="center"></colspec> <colspec align="center"></colspec> @@ -117,20 +186,29 @@ </row> </tbody> </tgroup> - </informaltable> - <para> - 2. Click!images/EditPage.png! icon to edit portal properties. - </para> - <para> - 3. Click!images/ShowContainer.png! icon to edit portal container layout. - </para> - <para> - 4. Click!images/ShowPortlet.png! icon to edit portal portlet layout. - </para> - <para> - 5. Click!images/Savepage.png! icon to save changes. - </para> - <orderedlist id="orde-User_Guide-Edit_a_Portal-For_GateIn_Portal_2.6"> + </informaltable> --> + <step> + <para> + Click!images/EditPage.png! icon to edit portal properties. + </para> + </step> + <step> + <para> + Click!images/ShowContainer.png! icon to edit portal container layout. + </para> + </step> + <step> + <para> + Click!images/ShowPortlet.png! icon to edit portal portlet layout. + </para> + </step> + <step> + <para> + Click!images/Savepage.png! icon to save changes. + </para> + </step> + </procedure> + <!-- <orderedlist id="orde-User_Guide-Edit_a_Portal-For_GateIn_Portal_2.6"> <title>For GateIn Portal 2.6</title> <para> You must have the edit right to change information of the current using portal: @@ -198,57 +276,60 @@ 6. Click the <emphasis role="bold">Save</emphasis> button to accept changes or the <emphasis role="bold">Cancel</emphasis> button to quit. </para> </listitem> - </orderedlist> + </orderedlist> --> </section> <section id="sect-User_Guide-Manage_Portals-Delete_a_Portal"> <title>Delete a Portal</title> <para> - You can easily delete a portal by following these guides: + You can delete a portal by following these guides: </para> <para> 1. Go to <emphasis role="bold">GateIn Start</emphasis> -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Advanced</emphasis> --&gt; <emphasis role="bold">Manage Portals</emphasis> </para> - <para> - +The 1^st^ way+: - </para> - <orderedlist> - <listitem> + <procedure> + <title>Method One:</title> + <step> <para> - 1. Go to <emphasis role="bold">Administrator</emphasis> on the Toolbar --&gt; <emphasis role="bold">Manage Portals</emphasis>. List of all portals will be shown. + Go to <emphasis role="bold">Administrator</emphasis> on the Toolbar --&gt; <emphasis role="bold">Manage Portals</emphasis>. List of all portals will be shown. </para> - </listitem> - <listitem> + </step> + <step> <para> - 2. Click the trash can !images/deleteIcon.png! icon in the row of the portal you want to delete in the portal list. + Click the trash can !images/deleteIcon.png! icon in the row of the portal you want to delete in the portal list. </para> - </listitem> - <listitem> + </step> + <step> <para> - 3. Click the <emphasis role="bold">OK</emphasis> button in the confirmation message to delete. + Click the <emphasis role="bold">OK</emphasis> button in the confirmation message to delete. </para> - </listitem> - </orderedlist> - <para> - +The 2^nd^ way+: - </para> - <orderedlist> - <listitem> + </step> + </procedure> + + <procedure> + <title>Method Two:</title> + <step> <para> - 1. Click on <emphasis role="bold">Site</emphasis> in the Toolbar --&gt; click on!images/DeletePortal2.6.png! .The confirmation message will appear: + Click on <emphasis role="bold">Site</emphasis> in the Toolbar + </para> + </step> + <step> + <para> + Click on!images/DeletePortal2.6.png! .The confirmation message will appear: + </para> + </step> + <step> + <para> + Click <emphasis role="bold">OK</emphasis> to accept deleting a portal or <emphasis role="bold">Cancel</emphasis> to quit without deleting it. + </para> <mediaobject> <imageobject> <imagedata fileref="images/SureDelete.png" format="PNG" /> </imageobject> </mediaobject> - </listitem> - <listitem> - <para> - 2. Click <emphasis role="bold">OK</emphasis> to accept deleting a portal or <emphasis role="bold">Cancel</emphasis> to quit without deleting it. - </para> - </listitem> - </orderedlist> + </step> + </procedure> </section> </section> Modified: portal/trunk/docs/user-guide/en/modules/portal/Page_Creation_Wizard.xml =================================================================== --- portal/trunk/docs/user-guide/en/modules/portal/Page_Creation_Wizard.xml 2009-12-16 04:14:57 UTC (rev 1020) +++ portal/trunk/docs/user-guide/en/modules/portal/Page_Creation_Wizard.xml 2009-12-16 04:50:09 UTC (rev 1021) @@ -25,26 +25,20 @@ <para> Only by following there simple steps can you create a page quickly by using a wizard and publish this page on the Navigation bar: </para> - <para> - 1. Go to <emphasis role="bold">GateIn Start</emphasis> -&gt;<emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Basic</emphasis> --&gt; <emphasis role="bold">Create page wizard</emphasis>. <emphasis role="bold">Welcome to Page Creation Wizard</emphasis> appears: - </para> - <para> - For GateIn Portal 2.6 - </para> - <orderedlist> - <listitem> + <procedure> + <step> <para> - 1. Go to <emphasis role="bold">Editor</emphasis> --&gt; <emphasis role="bold">Add New Page</emphasis> on the Toolbar. <emphasis role="bold">Create page wizard</emphasis>: <emphasis role="bold">Welcome to Page Creation Wizard</emphasis> appears: + Go to <emphasis role="bold">GateIn Start</emphasis> -&gt;<emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Basic</emphasis> --&gt; <emphasis role="bold">Create page wizard</emphasis>. <emphasis role="bold">Welcome to Page Creation Wizard</emphasis> appears: </para> <mediaobject> <imageobject> <imagedata fileref="images/Welcome.png" format="PNG" width="444" /> </imageobject> </mediaobject> - </listitem> - <listitem> + </step> + <step> <para> - 2. Click the <emphasis role="bold">Next</emphasis> button or number '1' of the wizard steps in order to go to step 1. This step allows users to set up page setting such as :the navigation path, the node name, the display name, etc. + Click the <emphasis role="bold">Next</emphasis> button or number '1' of the wizard steps in order to go to step 1. This step allows users to set up page setting such as :the navigation path, the node name, the display name, etc. </para> <mediaobject> <imageobject> @@ -54,27 +48,86 @@ <para> There are two parts: the left pane is used to show a small description that will guide you what to do in this step. And the main wizard includes two parts: the left pane contains a list of navigations and shows the page list of each selected navigation, the right pane displays main information of a page. </para> - </listitem> - <listitem> + </step> + <step> <para> - 3. On the left of wizard: Click the combo box icon !images/ComboBox.png! to see the navigations list. Select a navigation from the list that you want to create page. The pages list of selected navigation are displayed. + On the left of wizard: Click the combo box icon !images/ComboBox.png! to see the navigations list. Select a navigation from the list that you want to create page. The pages list of selected navigation are displayed. </para> <mediaobject> <imageobject> <imagedata fileref="images/PageList.png" format="PNG" /> </imageobject> </mediaobject> - </listitem> - <listitem> + </step> + <step> <para> - 4. Select a page from the above list or click on arrow up icon !images/ArrowIcon.png! to add a page at root. + Select a page from the above list or click on arrow up icon !images/ArrowIcon.png! to add a page at root. </para> <mediaobject> <imageobject> <imagedata fileref="images/Pagewizard1.png" format="PNG" width="444" /> </imageobject> </mediaobject> - <informaltable colsep="0" frame="none" rowsep="0"> + <variablelist> + <varlistentry> + <term>Current Selected Page Node</term> + <listitem> + <para> + The path of the selected node to add a new sub page + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Node Name</term> + <listitem> + <para> + The node name of the added page. It is required field. This field must start with a character and must have a length between 3 and 30 characters. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Display Name</term> + <listitem> + <para> + The display name of the node which contains the added page and must have a length between 3 and 30 characters. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Visible</term> + <listitem> + <para> + This check box allows to hide this page. If not checked the page is under no circumstances shown, even if the publication period is OK. If checked the page or the page node appears on on the navigation bar, the page navigation and the site map. If "visible" is checked the visibility can depend on the "publication date &amp; time" option. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Publication date &amp;time</term> + <listitem> + <para> + This option allows publishing the page for a period of time. If this option is checked the visibility of the page depends on the publication period start and end date. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Start Publication Date</term> + <listitem> + <para> + The start date and time to publish the page + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>End Publication Date</term> + <listitem> + <para> + The end date and time to publish the page. + </para> + </listitem> + </varlistentry> + </variablelist> + + <!-- <informaltable colsep="0" frame="none" rowsep="0"> <tgroup cols="2"> <colspec align="center"></colspec> <colspec align="center"></colspec> @@ -145,17 +198,19 @@ </row> </tbody> </tgroup> - </informaltable> - <para> - +<emphasis role="bold">Note:</emphasis>+You can set date and time by clicking the <emphasis role="bold">Start Publication Date</emphasis> field and <emphasis role="bold">End Publication Date</emphasis> field and select a date in the calendar pop up - </para> + </informaltable> --> + <note> + <para> + You can set date and time by clicking the <emphasis role="bold">Start Publication Date</emphasis> field and <emphasis role="bold">End Publication Date</emphasis> field and select a date in the calendar pop up + </para> + </note> <mediaobject> <imageobject> <imagedata fileref="images/Calendar.png" format="PNG" /> </imageobject> </mediaobject> - </listitem> - <listitem> + </step> + <step> <para> 5. Click <emphasis role="bold">Next</emphasis> or number '2' of the wizard steps to go to step 2. </para> @@ -164,13 +219,13 @@ <imagedata fileref="images/PageWizard2.png" format="PNG" width="444" /> </imageobject> </mediaobject> - </listitem> - <listitem> + </step> + <step> <para> 6. Select <emphasis role="bold">Empty Layout</emphasis> or click the icon to see more templates to select. </para> - </listitem> - <listitem> + </step> + <step> <para> 7. Click the <emphasis role="bold">Next</emphasis> button or number '3' of the wizard step to go to step 3. You can drag portlets on the left pane and drop it on the right pane to constitute the content of this page. </para> @@ -179,6 +234,12 @@ <imagedata fileref="images/PageWizard3.png" format="PNG" width="444" /> </imageobject> </mediaobject> +<warning> +<title>These Images are not present</title> +<para> + the images in the below table are not present in the raw document files. +</para> +</warning> <informaltable colsep="0" frame="none" rowsep="0"> <tgroup cols="2"> <colspec align="center"></colspec> @@ -219,28 +280,14 @@ </tbody> </tgroup> </informaltable> - </listitem> - <listitem> + </step> + <step> <para> 8. Click the <emphasis role="bold">Show Container</emphasis> icon !images/ShowContainer.png! if you want to see the existing containers and re-select the layout of the page. There will be a category list which contains specific containers when clicking the icon. </para> - </listitem> - </orderedlist> + </step> + </procedure> <para> - for GateIn Portal 2.6 - </para> - <para> - The step 2 of creating a page by wizard is the same as the above - </para> - <para> - In the step 3, you can drag portlets from the Edit Inline Composer popup and drag it to the constitute the content of this page - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/Step32.6.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - <para> You can click on!images/Switch.png! to view the content of this page. </para> <para> Modified: portal/trunk/docs/user-guide/en/modules/portal/User_Management.xml =================================================================== --- portal/trunk/docs/user-guide/en/modules/portal/User_Management.xml 2009-12-16 04:14:57 UTC (rev 1020) +++ portal/trunk/docs/user-guide/en/modules/portal/User_Management.xml 2009-12-16 04:50:09 UTC (rev 1021) @@ -7,7 +7,7 @@ Copyright (C) 2009 eXo Platform SAS. This is free software; you can redistribute it and/or modify it - under the terms of the GNU Lesser General Public License as + under the titles of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. @@ -33,497 +33,404 @@ <imagedata fileref="images/UserManage.png" format="PNG" width="444" /> </imageobject> </mediaobject> - <section> - <title>Management processes:</title> - <para> - <itemizedlist> - <listitem> + + <section id="sect-User_Guide-User_Management-Manage_users"> + <title>Manage users</title> <para> - <xref linkend="User_Guide-User_Management-Manage_users"/> + Select the <emphasis role="bold">User Management</emphasis> tab in the <emphasis role="bold">Organization</emphasis> form. By default, it will show all existing registered users. With <emphasis role="bold">User Management</emphasis> , you can see all existing registered users, and also search, edit, delete them. For each user, you can see his groups and his memberships (roles) in these groups. You can not add users to a group but you can remove them from the group. </para> - </listitem> - <listitem> - <para> - <xref linkend="User_Guide-User_Management-Search_a_user"/> - </para> - </listitem> - <listitem> - <para> - <xref linkend="User_Guide-User_Management-Edit_a_user"/> - </para> - </listitem> - <listitem> - <para> - <xref linkend="User_Guide-User_Management-Delete_a_user"/> - </para> - </listitem> - <listitem> - <para> - <xref linkend="User_Guide-User_Management-Manage_groups"/> - </para> - </listitem> - <listitem> - <para> - <xref linkend="User_Guide-User_Management-Add_a_new_group"/> - </para> - </listitem> - <listitem> - <para> - <xref linkend="User_Guide-User_Management-Edit-a-group"/> - </para> - </listitem> - <listitem> - <para> - <xref linkend="User_Guide-User_Management-Add_a_new_user_to_the_group"/> - </para> - </listitem> - <listitem> - <para> - <xref linkend="User_Guide-User_Management-Edit_the_user_membership_in_a_group"/> - </para> - </listitem> - <listitem> - <para> - <xref linkend="User_Guide-User_Management-Delete_a_group"/> - </para> - </listitem> - <listitem> - <para> - <xref linkend="User_Guide-User_Management-Manage_memberships"/> - </para> - </listitem> - <listitem> - <para> - <xref linkend="User_Guide-User_Management-Add_a_new_membership_type"/> - </para> - </listitem> - <listitem> - <para> - <xref linkend="User_Guide-User_Management-Edit_a_membership_type"/> - </para> - </listitem> - <listitem> - <para> - <xref linkend="sect-User_Guide-User_Management-Delete_a_membership_type"/> - </para> - </listitem> - </itemizedlist> + </section> + + <section id="sect-User_Guide-User_Management-Search_a_user"> + <title>Search a user</title> + <para> + The Administrator can search users by user name, first name, last name or email address. </para> + <procedure> + <step> + <para> + Type the search title related to the user that you want to search. You do not need to enter an exact title. + </para> + </step> + <step> + <para> + Select the field in which you would like to search + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/SearchUser.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + </step> + <step> + <para> + Click the magnifying glass icon!images/SearchIcon.png! to perform searching. It will return a searching result in form. + </para> + </step> + </procedure> + </section> - <variablelist> - <varlistentry id="User_Guide-User_Management-Manage_users"> - <term>Manage users</term> - <listitem> + <section id="sect-User_Guide-User_Management-Edit_a_user"> + <title>Edit a user</title> + <procedure> + <step> <para> - Select the <emphasis role="bold">User Management</emphasis> tab in the <emphasis role="bold">Organization</emphasis> form. By default, it will show all existing registered users. With <emphasis role="bold">User Management</emphasis> , you can see all existing registered users, and also search, edit, delete them. For each user, you can see his groups and his memberships (roles) in these groups. You can not add users to a group but you can remove them from the group. + Click the edit icon!images/EditIcon.png! corresponding to the user that you want to edit. </para> - </listitem> - </varlistentry> - <varlistentry id="User_Guide-User_Management-Search_a_user"> - <term>Search a user</term> - <listitem> + <mediaobject> + <imageobject> + <imagedata fileref="images/Demo1.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + </step> + <step> <para> - The Administrator can search users by user name, first name, last name or email address. + Select the <emphasis role="bold">Account Info</emphasis> tab to view and change the essential user information. </para> - <procedure> - <step> + <itemizedlist> + <listitem> <para> - Type the search term related to the user that you want to search. You do not need to enter an exact term. + The <emphasis role="bold">User Name</emphasis> field can not be changed, other fields <emphasis role="bold">First Name</emphasis> , <emphasis role="bold">Last Name</emphasis> , <emphasis role="bold">Email Address</emphasis> can be changed. </para> - </step> - <step> + </listitem> + <listitem> <para> - Select the field in which you would like to search + The <emphasis role="bold">Change Password</emphasis> option allows making a new password for this user when he/she forgets his/her password. When the <emphasis role="bold">Change Password</emphasis> option is unchecked, <emphasis role="bold">New Password</emphasis> and <emphasis role="bold">Confirm Password</emphasis> are hidden. Passwords must contain at least 6 characters (letters, numbers and punctuation marks). </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/SearchUser.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - </step> - <step> - <para> - Click the magnifying glass icon!images/SearchIcon.png! to perform searching. It will return a searching result in form. - </para> - </step> - </procedure> - </listitem> - </varlistentry> - <varlistentry id="User_Guide-User_Management-Edit_a_user"> - <term>Edit a user</term> - <listitem> - <procedure> - <step> - <para> - Click the edit icon!images/EditIcon.png! corresponding to the user that you want to edit. - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/Demo1.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - </step> - <step> - <para> - Select the <emphasis role="bold">Account Info</emphasis> tab to view and change the essential user information. - </para> - <itemizedlist> - <listitem> - <para> - The <emphasis role="bold">User Name</emphasis> field can not be changed, other fields <emphasis role="bold">First Name</emphasis> , <emphasis role="bold">Last Name</emphasis> , <emphasis role="bold">Email Address</emphasis> can be changed. - </para> - </listitem> - <listitem> - <para> - The <emphasis role="bold">Change Password</emphasis> option allows making a new password for this user when he/she forgets his/her password. When the <emphasis role="bold">Change Password</emphasis> option is unchecked, <emphasis role="bold">New Password</emphasis> and <emphasis role="bold">Confirm Password</emphasis> are hidden. Passwords must contain at least 6 characters (letters, numbers and punctuation marks). - </para> - </listitem> - </itemizedlist> - </step> - <step> - <para> - Select the <emphasis role="bold">User Profile</emphasis> tab to view and change profile information. The <emphasis role="bold">Language</emphasis> field is used to set the display language of that user. - </para> - </step> - <step> - <para> - Select the <emphasis role="bold">User Membership</emphasis> tab to see user's information in groups. - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/Demo3.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - <itemizedlist> - <listitem> - <para> - The <emphasis role="bold">User Membership</emphasis> tab indicates to which group the selected user belongs. In the above figure, the user "demo" is a member of two groups: "guests" and "users". The parent group of both is "platform". - </para> - </listitem> - <listitem> - <para> - To remove the user from a group, click the trash can icon!images/DeleteIcon.png! on the row you want. - </para> - </listitem> - </itemizedlist> - </step> - <step> - <para> - Click the <emphasis role="bold">Save</emphasis> button to accept changes. - </para> - </step> - </procedure> - </listitem> - </varlistentry> - <varlistentry id="User_Guide-User_Management-Delete_a_user"> - <term>Delete a user</term> - <listitem> - <procedure> - <step> - <para> - In the <emphasis role="bold">User Management</emphasis> form: Click the trash can icon !images/DeleteIcon.png! corresponding to the user that you want to delete. - </para> - </step> - <step> - <para> - Click the <emphasis role="bold">OK</emphasis> button in the confirmation message to confirm or the <emphasis role="bold">Cancel</emphasis> button to quit without deleting anything. - </para> - </step> - </procedure> - </listitem> - </varlistentry> - <varlistentry id="User_Guide-User_Management-Manage_groups"> - <term>Manage groups</term> - <listitem> + </listitem> + </itemizedlist> + </step> + <step> <para> - Select the <emphasis role="bold">Group Management</emphasis> tab in the <emphasis role="bold">Organization</emphasis> form. + Select the <emphasis role="bold">User Profile</emphasis> tab to view and change profile information. The <emphasis role="bold">Language</emphasis> field is used to set the display language of that user. </para> + </step> + <step> <para> - By default, all existing groups will be displayed on the left pane. This tab is used to add new, edit or delete a group. The right pane shows information about the selected group including information about the members in the specific group and a small form to add a new user to a group. + Select the <emphasis role="bold">User Membership</emphasis> tab to see user's information in groups. </para> <mediaobject> <imageobject> - <imagedata fileref="images/GroupManage.png" format="PNG" width="444" /> + <imagedata fileref="images/Demo3.png" format="PNG" width="444" /> </imageobject> </mediaobject> - </listitem> - </varlistentry> - <varlistentry id="User_Guide-User_Management-Add_a_new_group"> - <term>Add a New Group</term> - <listitem> - <procedure> - <step> + <itemizedlist> + <listitem> <para> - Choose the path to create a new group by selecting the groups from list on the left pane or clicking the arrow icon !images/ArrowIcon.png! if you want to create a group in a higher level. The selected path is displayed in the path bar. + The <emphasis role="bold">User Membership</emphasis> tab indicates to which group the selected user belongs. In the above figure, the user "demo" is a member of two groups: "guests" and "users". The parent group of both is "platform". </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/Admin1.png" format="PNG" /> - </imageobject> - </mediaobject> - </step> - <step> + </listitem> + <listitem> <para> - Click the <emphasis role="bold">Add New Group</emphasis> icon. The <emphasis role="bold">Add New Group</emphasis> form will be displayed on the right pane: + To remove the user from a group, click the trash can icon!images/DeleteIcon.png! on the row you want. </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/AddGroup.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - <informaltable colsep="0" frame="none" rowsep="0"> - <tgroup cols="2"> - <colspec align="center"></colspec> - <colspec align="center"></colspec> - <tbody> - <row> - <entry> - <emphasis role="bold"> Name </emphasis> - </entry> - <entry> - <emphasis role="bold"> Description </emphasis> - </entry> - </row> - <row> - <entry> - Group Name - </entry> - <entry> - The name of the new group. This field is required and any length from 3 to 30 characters is allowed. - </entry> - </row> - <row> - <entry> - Label - </entry> - <entry> - The display name of the group. Any length from 3 to 30 characters is allowed. - </entry> - </row> - <row> - <entry> - Description - </entry> - <entry> - The description about the group. Any length from 3 to 30 characters is allowed. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </step> - <step> - <para> - Fill in the required fields. Only alpha, digit and underscore characters are allowed for the <emphasis role="bold">Group Name</emphasis> field and it must be unique. - </para> - </step> - <step> - <para> - Click the <emphasis role="bold">Save</emphasis> button to accept entered values or the <emphasis role="bold">Cancel</emphasis> button to quit. - </para> - </step> - </procedure> - </listitem> - </varlistentry> - <varlistentry id="User_Guide-User_Management-Edit-a-group"> - <term>Edit a group</term> - <listitem> - <procedure> - <step> - <para> - Select the path to the group you want to edit by selecting the groups from list on the left pane. - </para> - </step> - <step> - <para> - Click the edit icon!images/EditIcon1.png! to show the <emphasis role="bold">Edit Group</emphasis> form of the selected group. This form is identical with the <emphasis role="bold">New Group</emphasis> form. - </para> - </step> - <step> - <para> - You can not change the Group Name. Make changes for a <emphasis role="bold">Label</emphasis> or a <emphasis role="bold">Description</emphasis> field and then click the <emphasis role="bold">Save</emphasis> button to accept changes or the <emphasis role="bold">Cancel</emphasis> button to cancel changes and return to the <emphasis role="bold">Group Info</emphasis> form. - </para> - </step> - </procedure> - </listitem> - </varlistentry> - <varlistentry id="User_Guide-User_Management-Add_a_new_user_to_the_group"> - <term>Add a new user to the group</term> - <listitem> - <procedure> - <step> - <para> - Select the path to the group you want to edit by selecting the groups from the list on the left pane. The Group's information is displayed including the user list and a form which allows to add a new user. - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/AddMember1.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - </step> - <step> - <para> - Enter the exact user name of the user that you want to add to the selected group or you can enter some characters if you are not sure about the exact spelling. - </para> - <itemizedlist> - <listitem> - <para> - Click the magnifying glass icon!images/MagnifyIcon.png! to select users. - </para> - </listitem> - <listitem> - <para> - After clicking the magnifying icon!images/MagnifyIcon.png! , there will be a list of all existing users : - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/SelectUser.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - </listitem> - <listitem> - <para> - Select the check box of the user (s) that you would like to add to the group. - </para> - </listitem> - <listitem> - <para> - After clicking the <emphasis role="bold">Add</emphasis> button you will see the complete user name(s) in the <emphasis role="bold">Add member</emphasis> form. - </para> - </listitem> - </itemizedlist> - </step> - <step> - <para> - Select the membership for the user in a group from memberships list. The refresh icon!images/RefreshIcon.png! can be used to update the memberships list in case there are any changes. - </para> - </step> - <step> - <para> - Click the <emphasis role="bold">Save</emphasis> button to accept adding the selected user to a specific group with the selected membership type. - </para> - </step> - </procedure> - </listitem> - </varlistentry> - <varlistentry id="User_Guide-User_Management-Edit_the_user_membership_in_a_group"> - <term>Edit the user membership in a group</term> - <listitem> - <procedure> - <step> - <para> - Click the edit icon!images/EditIcon.png! corresponding to a specific user with a membership in the <emphasis role="bold">Group Info</emphasis> table to open the <emphasis role="bold">Edit Membership</emphasis> form : - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/EditMember1.png" format="PNG" /> - </imageobject> - </mediaobject> - </step> - <step> - <para> - Change the membership of the selected user by selecting another value in the <emphasis role="bold">Membership</emphasis> field. - </para> - </step> - <step> - <para> - Complete editing the selected user by clicking the <emphasis role="bold">Save</emphasis> button. - </para> - </step> - </procedure> - </listitem> - </varlistentry> - <varlistentry id="User_Guide-User_Management-Delete_a_group"> - <term>Delete a group</term> - <listitem> - <procedure> - <step> - <para> - Select the path to the group you want to delete by selecting the groups from list on the left pane. - </para> - </step> - <step> - <para> - Click the trash can !images/DeleteIcon.png! icon in order to delete. - </para> - </step> - <step> - <para> - Click the <emphasis role="bold">OK</emphasis> button on the confirmation message to accept or the <emphasis role="bold">Cancel</emphasis> button to quit without deleting. - </para> - </step> - </procedure> - </listitem> - </varlistentry> - <varlistentry id="User_Guide-User_Management-Manage_memberships"> - <term>Manage memberships</term> - <listitem> + </listitem> + </itemizedlist> + </step> + <step> <para> - The roles of an user in the specific group are managed in <emphasis role="bold">Membership Management</emphasis> form. Currently there are three membership types: Manager, Member and Validator. By default, Manager has the highest rights in a group. You can add new, edit or delete a membership type. Select the <emphasis role="bold">Membership Management</emphasis> tab in the <emphasis role="bold">Organization</emphasis> portlet. There will be a membership type list and a form to add new/edit: + Click the <emphasis role="bold">Save</emphasis> button to accept changes. </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/MembershipManage1.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> - </listitem> - </varlistentry> - <varlistentry id="User_Guide-User_Management-Add_a_new_membership_type"> - <term>Add a new membership type</term> - <listitem> - <procedure> - <step> - <para> - In the <emphasis role="bold">Add/Edit Membership</emphasis> form at the bottom, the input value for the membership name field (required) and the description field (optional). Only letters, digits, dots, dashes and underscores are allowed for the membership name. - </para> - </step> - <step> - <para> - Click the <emphasis role="bold">Save</emphasis> button to accept adding the new membership or click <emphasis role="bold">Reset</emphasis> button to clear the entered values. - </para> - </step> - </procedure> - </listitem> - </varlistentry> - <varlistentry id="User_Guide-User_Management-Edit_a_membership_type"> - <term>Edit a membership type</term> - <listitem> - <procedure> - <step> - <para> - Click the edit icon!images/EditIcon.png! in the row of the membership type you want to edit. The selected Membership type information is displayed in the Add/Edit Membership form. - </para> - </step> - <step> - <para> - Make changes in this form. - </para> - </step> - <step> - <para> - Click <emphasis role="bold">Save</emphasis> to accept changes. - </para> - </step> - </procedure> - </listitem> - </varlistentry> - <varlistentry id="sect-User_Guide-User_Management-Delete_a_membership_type"> - <term>Delete a membership type</term> - <listitem> - <procedure> - <step> - <para> - Click the trash can icon in the row of the membership type that you want to delete. - </para> - </step> - <step> - <para> - Click the <emphasis role="bold">OK</emphasis> button in the confirmation message to accept the deletion. - </para> - </step> - </procedure> - </listitem> - </varlistentry> - </variablelist> + </step> + </procedure> </section> + + <section id="sect-User_Guide-User_Management-Delete_a_user"> + <title>Delete a user</title> + <procedure> + <step> + <para> + In the <emphasis role="bold">User Management</emphasis> form: Click the trash can icon !images/DeleteIcon.png! corresponding to the user that you want to delete. + </para> + </step> + <step> + <para> + Click the <emphasis role="bold">OK</emphasis> button in the confirmation message to confirm or the <emphasis role="bold">Cancel</emphasis> button to quit without deleting anything. + </para> + </step> + </procedure> + </section> + + <section id="sect-User_Guide-User_Management-Manage_groups"> + <title>Manage groups</title> + <para> + Select the <emphasis role="bold">Group Management</emphasis> tab in the <emphasis role="bold">Organization</emphasis> form. + </para> + <para> + By default, all existing groups will be displayed on the left pane. This tab is used to add new, edit or delete a group. The right pane shows information about the selected group including information about the members in the specific group and a small form to add a new user to a group. + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/GroupManage.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + </section> + + <section id="sect-User_Guide-User_Management-Add_a_new_group"> + <title>Add a New Group</title> + <procedure> + <step> + <para> + Choose the path to create a new group by selecting the groups from list on the left pane or clicking the arrow icon !images/ArrowIcon.png! if you want to create a group in a higher level. The selected path is displayed in the path bar. + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/Admin1.png" format="PNG" /> + </imageobject> + </mediaobject> + </step> + <step> + <para> + Click the <emphasis role="bold">Add New Group</emphasis> icon. The <emphasis role="bold">Add New Group</emphasis> form will be displayed on the right pane: + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/AddGroup.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + <informaltable colsep="0" frame="none" rowsep="0"> + <tgroup cols="2"> + <colspec align="center"></colspec> + <colspec align="center"></colspec> + <tbody> + <row> + <entry> + <emphasis role="bold"> Name </emphasis> + </entry> + <entry> + <emphasis role="bold"> Description </emphasis> + </entry> + </row> + <row> + <entry> + Group Name + </entry> + <entry> + The name of the new group. This field is required and any length from 3 to 30 characters is allowed. + </entry> + </row> + <row> + <entry> + Label + </entry> + <entry> + The display name of the group. Any length from 3 to 30 characters is allowed. + </entry> + </row> + <row> + <entry> + Description + </entry> + <entry> + The description about the group. Any length from 3 to 30 characters is allowed. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </step> + <step> + <para> + Fill in the required fields. Only alpha, digit and underscore characters are allowed for the <emphasis role="bold">Group Name</emphasis> field and it must be unique. + </para> + </step> + <step> + <para> + Click the <emphasis role="bold">Save</emphasis> button to accept entered values or the <emphasis role="bold">Cancel</emphasis> button to quit. + </para> + </step> + </procedure> + </section> + + <section id="sect-User_Guide-User_Management-Edit-a-group"> + <title>Edit a group</title> + <procedure> + <step> + <para> + Select the path to the group you want to edit by selecting the groups from list on the left pane. + </para> + </step> + <step> + <para> + Click the edit icon!images/EditIcon1.png! to show the <emphasis role="bold">Edit Group</emphasis> form of the selected group. This form is identical with the <emphasis role="bold">New Group</emphasis> form. + </para> + </step> + <step> + <para> + You can not change the Group Name. Make changes for a <emphasis role="bold">Label</emphasis> or a <emphasis role="bold">Description</emphasis> field and then click the <emphasis role="bold">Save</emphasis> button to accept changes or the <emphasis role="bold">Cancel</emphasis> button to cancel changes and return to the <emphasis role="bold">Group Info</emphasis> form. + </para> + </step> + </procedure> + </section> + + <section id="sect-User_Guide-User_Management-Add_a_new_user_to_the_group"> + <title>Add a new user to the group</title> + <procedure> + <step> + <para> + Select the path to the group you want to edit by selecting the groups from the list on the left pane. The Group's information is displayed including the user list and a form which allows to add a new user. + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/AddMember1.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + </step> + <step> + <para> + Enter the exact user name of the user that you want to add to the selected group or you can enter some characters if you are not sure about the exact spelling. + </para> + <itemizedlist> + <listitem> + <para> + Click the magnifying glass icon!images/MagnifyIcon.png! to select users. + </para> + </listitem> + <listitem> + <para> + After clicking the magnifying icon!images/MagnifyIcon.png! , there will be a list of all existing users : + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/SelectUser.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + </listitem> + <listitem> + <para> + Select the check box of the user (s) that you would like to add to the group. + </para> + </listitem> + <listitem> + <para> + After clicking the <emphasis role="bold">Add</emphasis> button you will see the complete user name(s) in the <emphasis role="bold">Add member</emphasis> form. + </para> + </listitem> + </itemizedlist> + </step> + <step> + <para> + Select the membership for the user in a group from memberships list. The refresh icon!images/RefreshIcon.png! can be used to update the memberships list in case there are any changes. + </para> + </step> + <step> + <para> + Click the <emphasis role="bold">Save</emphasis> button to accept adding the selected user to a specific group with the selected membership type. + </para> + </step> + </procedure> + </section> + + <section id="sect-User_Guide-User_Management-Edit_the_user_membership_in_a_group"> + <title>Edit the user membership in a group</title> + <procedure> + <step> + <para> + Click the edit icon!images/EditIcon.png! corresponding to a specific user with a membership in the <emphasis role="bold">Group Info</emphasis> table to open the <emphasis role="bold">Edit Membership</emphasis> form : + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/EditMember1.png" format="PNG" /> + </imageobject> + </mediaobject> + </step> + <step> + <para> + Change the membership of the selected user by selecting another value in the <emphasis role="bold">Membership</emphasis> field. + </para> + </step> + <step> + <para> + Complete editing the selected user by clicking the <emphasis role="bold">Save</emphasis> button. + </para> + </step> + </procedure> + </section> + + <section id="sect-User_Guide-User_Management-Delete_a_group"> + <title>Delete a group</title> + <procedure> + <step> + <para> + Select the path to the group you want to delete by selecting the groups from list on the left pane. + </para> + </step> + <step> + <para> + Click the trash can !images/DeleteIcon.png! icon in order to delete. + </para> + </step> + <step> + <para> + Click the <emphasis role="bold">OK</emphasis> button on the confirmation message to accept or the <emphasis role="bold">Cancel</emphasis> button to quit without deleting. + </para> + </step> + </procedure> + </section> + + <section id="sect-User_Guide-User_Management-Manage_memberships"> + <title>Manage memberships</title> + <para> + The roles of an user in the specific group are managed in <emphasis role="bold">Membership Management</emphasis> form. Currently there are three membership types: Manager, Member and Validator. By default, Manager has the highest rights in a group. You can add new, edit or delete a membership type. Select the <emphasis role="bold">Membership Management</emphasis> tab in the <emphasis role="bold">Organization</emphasis> portlet. There will be a membership type list and a form to add new/edit: + </para> + <mediaobject> + <imageobject> + <imagedata fileref="images/MembershipManage1.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> + </section> + + <section id="sect-User_Guide-User_Management-Add_a_new_membership_type"> + <title>Add a new membership type</title> + <procedure> + <step> + <para> + In the <emphasis role="bold">Add/Edit Membership</emphasis> form at the bottom, the input value for the membership name field (required) and the description field (optional). Only letters, digits, dots, dashes and underscores are allowed for the membership name. + </para> + </step> + <step> + <para> + Click the <emphasis role="bold">Save</emphasis> button to accept adding the new membership or click <emphasis role="bold">Reset</emphasis> button to clear the entered values. + </para> + </step> + </procedure> + </section> + + <section id="sect-User_Guide-User_Management-Edit_a_membership_type"> + <title>Edit a membership type</title> + <procedure> + <step> + <para> + Click the edit icon!images/EditIcon.png! in the row of the membership type you want to edit. The selected Membership type information is displayed in the Add/Edit Membership form. + </para> + </step> + <step> + <para> + Make changes in this form. + </para> + </step> + <step> + <para> + Click <emphasis role="bold">Save</emphasis> to accept changes. + </para> + </step> + </procedure> + </section> + + <section id="sect-User_Guide-User_Management-Delete_a_membership_type"> + <title>Delete a membership type</title> + <procedure> + <step> + <para> + Click the trash can icon in the row of the membership type that you want to delete. + </para> + </step> + <step> + <para> + Click the <emphasis role="bold">OK</emphasis> button in the confirmation message to accept the deletion. + </para> + </step> + </procedure> + </section> + </section>