<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
        <!ENTITY % BOOK_ENTITIES SYSTEM "../../User_Guide.ent">
        %BOOK_ENTITIES;
        ]>
<section id="sect-User_Guide-Manage_Portlets_and_Gadgets">
  <title>Manage portlets and gadgets</title>
  <section id="sect-User_Guide-Manage_Portlets_and_Gadgets-Add_Portlet_Gadget_to_Application_list">
    <title>Add portlets/gadgets to the Application list</title>
    <para>This section shows you how to add a portlet/gadget to the <guilabel>Application</guilabel> list on the left pane
      of the <guilabel>Manage Application</guilabel> page.</para>
    <procedure>
      <step><para>Click <guilabel>Portlets</guilabel>/<guilabel>Gadgets</guilabel> on the <guilabel>Tab</guilabel> bar to open a list of
        portlets/gadgets respectively.</para>
      <mediaobject>
      <imageobject role="html">
        <imagedata fileref="images/List_of_portlet.png" format="PNG" align="center" scale="110"/>
      </imageobject>
      <imageobject role="fo">
        <imagedata fileref="images/List_of_portlet.png" format="PNG" align="center" scalefit="1"
                   width="80mm"/>
      </imageobject>
    </mediaobject>
      </step>
      <step><para>Click the portlet/gadget which you want to add to the <guilabel>Application</guilabel> list.</para>
      <para>The information of the portlet/gadget is displayed.</para>
      <mediaobject>
      <imageobject role="html">
        <imagedata fileref="images/AddPortletToCategory.png" format="PNG" align="center" scale="110"/>
      </imageobject>
      <imageobject role="fo">
        <imagedata fileref="images/AddPortletToCategory.png" format="PNG" align="center" scalefit="1"
                   width="150mm"/>
      </imageobject>
    </mediaobject>
      </step>
      <step><para>Click the <guilabel>Click here to add this portlet to a category</guilabel> link to open a form which allows you
      to select a category for the portlet.</para>
      <mediaobject>
      <imageobject role="html">
        <imagedata fileref="images/Form_Add_Portlet.png" format="PNG" align="center" scale="110"/>
      </imageobject>
      <imageobject role="fo">
        <imagedata fileref="images/Form_Add_Portlet.png" format="PNG" align="center" scalefit="1"
                   width="90mm"/>
      </imageobject>
    </mediaobject>
      </step>
      <step><para>Click <guibutton>Save</guibutton> to accept adding the portlet/gadget to the <guilabel>Application</guilabel> list.</para></step>

    </procedure>
    <note><para>In case, the portlet/gadget was already added to the <guilabel>Application</guilabel> list, there will be no the <guilabel>Click here to add this portlet to a category</guilabel>
    link.</para></note>
  </section>
  <section id="sect-User_Guide-Dashboard_Portlet-Activate_Import_Applications_function">
    <title>Activate the Import Applications function</title>
    <note>
      <para>You can perform this action only when you are a member of the <emphasis>/platform/administrators</emphasis> group.</para>
    </note>
    <para>By default, the
      <guilabel>Import Applications</guilabel>
      function is hidden. To activate it, you can do as follows:
    </para>
    <procedure>
      <step>
        <para>Go to the
          <menuchoice>
            <guimenu><link linkend="GoToManageApplicationsPage">Manage Applications page</link></guimenu>
            <guisubmenu>Edit</guisubmenu>
            <guisubmenu>Page</guisubmenu>
            <guimenuitem>Layout</guimenuitem>
          </menuchoice>
          on the
          <guilabel>Administration</guilabel>
          bar.
        </para>
      </step>
      <step>
        <para>Hover your cursor over the
          <guilabel>Application Registry</guilabel>
          portlet, then click
          <inlinemediaobject>
            <imageobject>
              <imagedata fileref="images/Edit_portlet_icon.png" format="PNG" scalefit="1" width="4mm"/>
            </imageobject>
          </inlinemediaobject>
          at the upper left corner of that portlet.
        </para>
        <para>
          The
          <guilabel>Edit</guilabel>
          form will be displayed.
          <mediaobject>
            <imageobject role="html">
              <imagedata fileref="images/Edit_Mode_Application_Registry.png" format="PNG" align="center" scale="110"/>
            </imageobject>
            <imageobject role="fo">
              <imagedata fileref="images/Edit_Mode_Application_Registry.png" format="PNG" align="center" scalefit="1"
                         width="150mm"/>
            </imageobject>
          </mediaobject>
        </para>
      </step>
      <step>
        <para>Tick the
          <guilabel>Change Show Import</guilabel>
          checkbox, then click
          <guibutton>Save</guibutton>
          to accept the changes.
        </para>
      </step>
      <step>
        <para>Click
          <guibutton>Close</guibutton>
          to close the
          <guilabel>Edit</guilabel>
          form, then click
          <inlinemediaobject>
            <imageobject>
              <imagedata fileref="images/Finish_icon.png" format="PNG" scalefit="1" width="4mm"/>"
            </imageobject>
          </inlinemediaobject>
          to quit the
          <guilabel>Page Editor</guilabel>
          page.
        </para>
        <para>The
          <guilabel>Import Applications</guilabel>
          button is displayed on the
          <guilabel>Manage Applications</guilabel>
          page.
        </para>
        <mediaobject>
          <imageobject role="html">
            <imagedata fileref="images/Activate_import_application_button.png" format="PNG" align="center" scale="110"/>
          </imageobject>
          <imageobject role="fo">
            <imagedata fileref="images/Activate_import_application_button.png" format="PNG" align="center" scalefit="1"
                       width="150mm"/>
          </imageobject>
        </mediaobject>
      </step>
    </procedure>
  </section>
  <section id="sect-User_Guide-Manage_Portlets_and_Gadgets-Import_Gadget_Portlet">
    <title>Import portlets and gadgets</title>
    <para>This feature enables you to import default portlets and gadgets into different categories as follows:</para>
    <procedure>
      <step>
        <para>Click
          <inlinemediaobject>
            <imageobject>
              <imagedata fileref="images/ImportApplicationsbutton.png" format="PNG" scalefit="1" width="17mm"/>"
            </imageobject>
          </inlinemediaobject>
          at the right corner on the
          <guilabel>Action</guilabel>
          bar.
        </para>
      </step>
      <step>
        <para>Click
          <guibutton>OK</guibutton>
          in the confirmation message to accept importing portlets and gadgets automatically.
        </para>
        <para>All portlets and gadgets of all categories will be imported and listed on the left pane.</para>
      </step>
    </procedure>
    <note>
      <para>You can see <inlinemediaobject>
            <imageobject>
              <imagedata fileref="images/ImportApplicationsbutton.png" format="PNG" scalefit="1" width="17mm"/>"
            </imageobject>
          </inlinemediaobject> only when the <link linkend="sect-User_Guide-Dashboard_Portlet-Activate_Import_Applications_function">
       Import Applications function
          </link> is activated. </para>
    </note>
  </section>
  <section id="sect-User_Guide-Dashboard_Portlet-View_Information">
    <title>View/Edit detailed information of a portlet/gadget</title>
    <para>To view details of a portlet/gadget, simply select one portlet/gadget in the left pane. The
      details of that portlet will be shown on the right pane.
    </para>
    <mediaobject>
      <imageobject role="html">
        <imagedata fileref="images/InformationPortlet.png" format="PNG" align="center" scale="110"/>
      </imageobject>
      <imageobject role="fo">
        <imagedata fileref="images/InformationPortlet.png" format="PNG" align="center" scalefit="1"
                   width="150mm"/>
      </imageobject>
    </mediaobject>
    <variablelist>
      <varlistentry>
        <term>
          <emphasis role="bold">Left pane</emphasis>
        </term>
        <listitem>
          <para>
            All portlets and gadgets grouped by categories.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <emphasis role="bold">Right pane</emphasis>
        </term>
        <listitem>
          <para>
            Details of a portlet: <guilabel>Name, Display Name, Description</guilabel>.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
	<citetitle>
    <para xml:id="sect-User_Guide-Dashboard_Portlet-View_Information-Edit_portlet"><emphasis role="bold">Edit a portlet</emphasis></para>
	</citetitle>
      <procedure>
        <step>
          <para>Click
      <inlinemediaobject>
        <imageobject>
          <imagedata fileref="images/edit-icon.png" format="PNG" scalefit="1" width="4mm"/>"
        </imageobject>
      </inlinemediaobject>
      on the top corner of right pane. 
      </para>
      <para>The <guilabel>Edit Application Information</guilabel> form will appear.
    <mediaobject>
      <imageobject role="html">
        <imagedata fileref="images/EditApplicationInformation.png" format="PNG" align="center" scale="110"/>
      </imageobject>
      <imageobject role="fo">
        <imagedata fileref="images/EditApplicationInformation.png" format="PNG" align="center" scalefit="1"
                   width="100mm"/>
      </imageobject>
    </mediaobject>
    </para>
    </step>
    <step>
    <para>Make changes on these fields, except <guilabel>Application Name</guilabel>.
    </para>
    </step>
    </procedure>
  </section>

  <section id="sect-User_Guide-Dashboard_Portlet-Edit_Specific_Portlet">
    <title>Edit a specific portlet</title>
    <para>
      This section tells you how to access the edit mode of a portlet and edit it. 
    </para>
    <procedure>
      <step>
        <para>Define your desired portlet to check if this portlet has been existing in the portal or page. If not, drag and drop it from <emphasis role="bold">Edit Inline Composer</emphasis> to the main portal body while <link linkend="proc-User_Guide-Manage_Portals-Edit_Layout">editing the portal's layout,</link> or from <emphasis role="bold">Page Editor</emphasis> to the main page body in the <link linkend="sect-User_Guide-Page_Creation_Wizard-Rearrange_Page_Layout_and_Portlets">Step 3 while creating a page</link> and/or while <link linkend="sect-User_Guide-Manage_Pages-Edit_a_Page">editing a page.</link>
        </para> 
      </step>
	  <step>
		<para>Hover your cursor over your desired portlet, then click 
          <inlinemediaobject>
            <imageobject>
              <imagedata fileref="images/Edit_portlet_icon.png" format="PNG" scalefit="1" width="4mm"/>
            </imageobject>
          </inlinemediaobject>
          at the upper left corner of that portlet.
        </para>
        <para>
          The <guilabel>Edit</guilabel> form will be displayed.
        <mediaobject>
          <imageobject role="html">
            <imagedata fileref="images/Edit_portlet_form.png" format="PNG" align="center" scale="110"/>
          </imageobject>
          <imageobject role="fo">
            <imagedata fileref="images/Edit_portlet_form.png" format="PNG" align="center" scalefit="1"
                       width="150mm"/>
          </imageobject>
        </mediaobject>
		</para>
		  <para>
          Normally, a portlet has four tabs:
          <guilabel>Window Settings, Select Icon, Decoration Themes</guilabel>
          and <guilabel>Access Permission.</guilabel> However, some portlets may also have
          <guilabel>Edit Mode</guilabel> and <guilabel>Preferences</guilabel> tabs.
          For example, IFrame and Dashboard portlets have the <guilabel>Edit Mode</guilabel> tab where administrators can define the interface details.
        </para>
		</step>
		<step>
		<para>Make changes on fields in the various tabs. 
		</para>
		<itemizedlist>
		<listitem>
		<para>
        The <guilabel>Window Settings</guilabel> tab allows you to change values related to settings of your selected portlet.
		</para>
		<para><emphasis role="bold">Details:</emphasis>
		</para>
		<table>
        <tgroup cols="2">
          <thead>
            <row>
              <entry>
                Field
              </entry>
              <entry>
                Description
              </entry>
            </row>
          </thead>
          <tbody>
           <row>
              <entry>
                <guilabel>Display Name</guilabel>
              </entry>
              <entry>
                The display name of portlet which cannot be changed.
              </entry>
            </row>
            <row>
              <entry>
                <guilabel>Window Title</guilabel>
              </entry>
              <entry>
               The portlet title with the length between 3 and 60 characters.
              </entry>
            </row>
             <row>
              <entry>
                <guilabel>Width</guilabel>
              </entry>
              <entry>
              The portlet's vertical size. The value of this field must be in numeric format.
              </entry>
            </row>
            <row>
              <entry>
                <guilabel>Height</guilabel>
              </entry>
              <entry>
                The portlet's horizontal size. The value of this field must be in numeric format.
              </entry>
            </row>
            <row>
            <entry><guilabel>Show Info Bar</guilabel>
            </entry>
            <entry>
             The option enables the information bar to be shown or hidden. If the <guilabel>Show Info Bar</guilabel> checkbox is not selected, portlet mode and window state will not be displayed in that portlet.
            </entry>
            </row>
              <row>
              <entry>
                <guilabel>Show Portlet Mode</guilabel>
              </entry>
              <entry>
                  The option enables the portlet mode to be shown or hidden.
				</entry>
            </row>
			<row>
              <entry>
                <guilabel>Show Window State</guilabel>
              </entry>
              <entry>
                The option enables the portlet's window state to be shown or not.
              </entry>
            </row>
              <row>
              <entry>
                <guilabel>Description</guilabel>
              </entry>
              <entry>
                The brief information of the portlet. The length must be between 0 and 255 characters.
              </entry>
            </row>
         </tbody>
        </tgroup>
      </table>
	  </listitem>
	  <listitem>
	  <para>The <guilabel>Select Icon</guilabel> tab allows you to select an icon for the portlet. By clicking <guilabel>Get Default,</guilabel> you do not have to select any icon from the list, the suitable icon will be got automatically.
	  </para>
	  </listitem>
	  <listitem>
	  <para>
	  The <guilabel>Decoration Themes</guilabel> tab allows you to select a theme for the portlet from the themes list. By clicking <guilabel>Get Default,</guilabel> you do not have to choose any theme, it will be automatically set.
	  </para>
	  </listitem>
	  <listitem>
	  <para>
	  The <guilabel>Access Permission</guilabel> tab allows you to set the access permission on the portlet. The portlet can be made public to everyone or restricted to specific groups.
	  </para>
	  <note>
	  <para>See the <link linkend="sect-User_Guide-Manage_Permission-Set_the_Access_Permission_on_a_Portlet">Set Access permission on a portlet</link> section for details on how to assign the access permission on a portlet.
	  </para>
	  </note>
	  </listitem>
	  </itemizedlist>
      </step>
      <step>
        <para>
          Click
          <guibutton>Save And Close</guibutton> to accept your changes.
        </para>      
      </step>
    </procedure>
  </section>
  <section id="sect-User_Guide-Manage_Portlets_and_Gadgets-Add_a_Gadget">
    <title>Add a gadget</title>
    <para>
      To add a gadget, you first need to turn into the
      <emphasis role="bold">Gadget</emphasis>
      page by selecting
      <guilabel>Gadget</guilabel> on the tab bar of the <emphasis role="bold">Manage Applications</emphasis> page.
    </para>
    <mediaobject>
      <imageobject role="html">
        <imagedata fileref="images/Gadgetnew.png" format="PNG" align="center" scale="110"/>
      </imageobject>
      <imageobject role="fo">
        <imagedata fileref="images/Gadgetnew.png" format="PNG" align="center" scalefit="1" width="150mm"/>
      </imageobject>
    </mediaobject>
    <para>
      You can add a remote gadget using its URL or create a new gadget into the list.
    </para>
	<citetitle>
    <para xml:id="sect-User_Guide-Manage_Portlets_and_Gadgets-Add_a_Gadget-Add_remote_gadget"><emphasis role="bold">Add a remote gadget</emphasis></para>
	</citetitle>
    <procedure>
      <step>
        <para>
          Click the <guilabel>Add a Remote Gadget</guilabel> link.
        </para>
      </step>
      <step>
        <para>
          Enter the link of your desired gadget which is in the <emphasis>.xml</emphasis> format in the
          <guilabel>Gadget URL</guilabel> field.
        </para>
        <mediaobject>
          <imageobject role="html">
            <imagedata fileref="images/AddGadgetnewUrl.png" format="PNG" align="center" scale="110"/>
          </imageobject>
          <imageobject role="fo">
            <imagedata fileref="images/AddGadgetnewUrl.png" format="PNG" align="center" scalefit="1"
                       width="80mm"/>
          </imageobject>
        </mediaobject>
      </step>
      <step>
        <para>
          Click
          <guilabel>Add</guilabel>
          to accept your inputted URL.
        </para>
        <para>
          The selected gadget will be added to the gadgets list in the left pane with its details in the right pane.
        </para>
      </step>
    </procedure>
	<citetitle>
    <para xml:id="sect-User_Guide-Manage_Portlets_and_Gadgets-Add_a_Gadget-Create_new_gadget"><emphasis role="bold">Create a new gadget</emphasis></para>
	</citetitle>
    <procedure>
      <step>
        <para>
          Click the <guilabel>Create a New Gadget</guilabel> link.
        </para>
      </step>
      <step>
        <para>
          Enter values in the form. 
        </para>
        <para>
      For example:
        <mediaobject>
          <imageobject role="html">
            <imagedata fileref="images/Add_new_gadget.png" format="PNG" align="center" scale="110"/>
          </imageobject>
          <imageobject role="fo">
            <imagedata fileref="images/Add_new_gadget.png" format="PNG" align="center" scalefit="1"
                       width="150mm"/>
          </imageobject>
        </mediaobject>
       </para>
      </step>
      <step>
        <para>
          Click
          <guibutton>Save</guibutton>
          to accept creating your new gadget.
        </para>
      </step>
    </procedure>
    <note>
      <para>
        To add the newly added remote gadget to a specific category, simply click the "Click here to add into categories" link at
        the bottom of the right pane. The table listing all categories will appear that allows you to select your desired
        category.
      </para>
      <para>
        To update information of the added gadget, simply click
        <inlinemediaobject>
          <imageobject>
            <imagedata fileref="images/Refresh_button.png" format="PNG" scalefit="1" width="4mm"/>
          </imageobject>
        </inlinemediaobject>
        to refresh information.
      </para>
    </note>
	<itemizedlist>
	<listitem>
    <para>
      You can delete a local gadget using 
      <inlinemediaobject>
            <imageobject>
              <imagedata fileref="images/Delete_icon.png" format="PNG" scalefit="1" width="4mm"/>
            </imageobject>
      </inlinemediaobject> corresponding to each gadget in the left gadgets list.
    </para>
	</listitem>
	</itemizedlist>
  </section>
  <section id="sect-User_Guide-Manage_Portlets_and_Gadgets-Add_a_new_Gadget_to_the_Dashboard_Portlet">
    <title>Add a new gadget from Dashboard</title>
    <para>
      See the <link linkend="sect-User_Guide-Dashboard_Portlet-Add_Gadgets">Add more external gadgets from Dashboard</link> section for instructions on how to add new gadgets from the dashboard.
    </para>
  </section>
  <section id="sect-User_Guide-Manage_Gadgets-Edit_a_Gadget">
    <title>Edit a gadget</title>
    <para>
      Click <inlinemediaobject>
            <imageobject>
              <imagedata fileref="images/edit_icon.png" format="PNG" scalefit="1" width="4mm"/>
            </imageobject>
          </inlinemediaobject>  
      located at the header of the
      <emphasis role="bold">Gadget Details</emphasis>
      page to display the following window.
    </para>
    <mediaobject>
      <imageobject role="html">
        <imagedata fileref="images/Source.png" format="PNG" align="center" width="150mm"/>
      </imageobject>
        <imageobject role="fo">
        <imagedata fileref="images/Source.png" format="PNG" align="center" scalefit="1" width="150mm"/>
      </imageobject>
    </mediaobject>
  </section>
</section>