<?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>
		<para>
			Portlets and gadgets are organized in different categories. Each category contains one or several portlets or gadgets. You can also mix portlets and gadgets into one category. By default all gadgets are placed in the <emphasis>Gadgets</emphasis> category.
		</para>
	
		<section id="sect-User_Guide-Dashboard_Portlet-Display_Gadgets">
		<title>Display Gadgets</title>
		<para>
			You can change the number of columns available in the Dashboard Portlet.
		</para>
		<procedure>
			<step>
				<para>
					Click on <emphasis role="bold">Site Editor</emphasis> : <emphasis role="bold">Edit Page</emphasis>
				</para>
			</step>
			<step>
				<para>
					Click on <emphasis role="bold">Edit Portlet</emphasis> button (which is displayed a pencil icon when you mouse-over the portlet in edit mode). It will show a dialog to change the number of columns to display gadgets.
				</para>
				<mediaobject>
					<imageobject role="html">
						<imagedata fileref="images/Column.png" format="PNG" align="center" scale="110"/>
					</imageobject>
					<imageobject role="fo">
						<imagedata fileref="images/Column.png" format="PNG" align="center"  scalefit="1" contentwidth="120mm" />
					</imageobject>
				</mediaobject>
			</step>
			<step>
				<para>
					Change the number of columns and click the <emphasis role="bold">Save</emphasis> button to accept the changes.
				</para>
			</step>
		</procedure>

	</section>

	<section id="sect-User_Guide-Manage_Portlets_and_Gadgets-Add_a_new_Category">
		<title>Add a new Category</title>
		<para>
			You easily add a new category by following these guides:
		</para>
		<procedure>
			<step>
				<para>
					In the <emphasis role="bold">Group</emphasis> menu, select <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Application Registry</emphasis>.
				</para>
			</step>
			<step>
				<para>
					Click the <emphasis role="bold">Add Category</emphasis> button on the action bar: 
				</para>
				<mediaobject>
					<imageobject role="html">
						<imagedata fileref="images/AddCategory1.png" format="PNG" align="center" scale="110" />
					</imageobject>
					<imageobject role="fo">
						<imagedata fileref="images/AddCategory1.png" format="PNG" align="center"  scalefit="1" contentwidth="150mm" />
					</imageobject>
				</mediaobject>
				<para>
					The <emphasis role="bold">Category Setting</emphasis> tab: includes common information about a category.
				</para>
		
				<variablelist>
					<varlistentry>
						<term>Category name</term>
						<listitem>
							<para>
								The name of the category. This field is required and its length must be between 3 and 30 characters. Only alpha, digit, dash and underscore characters are allowed. 
							</para>
						</listitem>
					</varlistentry>
					<varlistentry>
						<term>Display name</term>
						<listitem>
							<para>
								The display name of the category and its length must be between 3 and 30 characters.
							</para>
						</listitem>
					</varlistentry>
					<varlistentry>
						<term>Description</term>
						<listitem>
							<para>
								A brief description of the category. Any length from 0 to 255 characters is allowed.
							</para>
						</listitem>
					</varlistentry>
				</variablelist>
				<para>
					The <emphasis role="bold">Permission Setting</emphasis> tab provides access to the Permission manager.
				</para>
				<para>The permission criteria are used whenever a user creates or modifies a page. In that case the user can only see and use portlets in those categories on which he or she has access to (as defined by groups and memberships).
				</para>
				<mediaobject>
					<imageobject role="html">
						<imagedata fileref="images/Permission2.png" format="PNG" align="center" scale="110" />
					</imageobject>
					<imageobject role="fo">
						<imagedata fileref="images/Permission2.png" format="PNG" align="center"  scalefit="1" contentwidth="130mm" />
					</imageobject>
				</mediaobject>
			</step>
<!--
			<step>
				<para>
					Enter values for required fields in this form.
				</para>
			</step>
			<step>
				<para>
					Click the <emphasis role="bold">Save</emphasis> button to accept adding a new category into a category list. The new category will be added into a list on the left pane.
				</para>
			</step>
-->
		</procedure>
	</section>
	
	<section id="sect-User_Guide-Manage_Portlets_and_Gadgets-Edit_a_Category">
		<title>Edit a Category</title>
		<procedure>
			<step>
				<para>
					Click the Edit icon located next to the title bar.
				</para>
			</step>
			<step>
				<para>
					Update the category information.
				</para>
			</step>
			<step>
				<para>
					Click the <emphasis role="bold">Save</emphasis> button to apply changes.
				</para>
			</step>
		</procedure>
	</section>
	
	<section id="sect-User_Guide-Manage_Portlets_and_Gadgets-Delete_a_Category">
		<title>Delete a Category</title>
		<procedure>
			<step>
				<para>
					Click the Trash can icon located next to the title bar.
				</para>
			</step>
			<step>
				<para>
					Accept the deletion by clicking  <emphasis role="bold">OK</emphasis>
				</para>
			</step>
		</procedure>
	</section>
	
	<section id="sect-User_Guide-Manage_Portlets_and_Gadgets-Add_PortletsGadgets_to_the_specific_Category">
		<title>Add Portlets/Gadgets to a Category</title>
		<procedure>
			<step>
				<para>
					Click the "Plus" icon located next to the category name to which you want to add portlets/gadgets.  
				</para>
				<mediaobject>
					<imageobject role="html">
						<imagedata fileref="images/AddPortlet2.png" format="PNG" align="center" scale="110" />
					</imageobject>
					<imageobject role="fo">
						<imagedata fileref="images/AddPortlet2.png" format="PNG" align="center"  scalefit="1" contentwidth="160mm" />
					</imageobject>
				</mediaobject>
				<variablelist>
					<varlistentry>
						<term>Display name</term>
							<listitem>
								<para>
									The display name of a portlet/gadget.
								</para>
							</listitem>
					</varlistentry>
					<varlistentry>
						<term>Application Type</term> 
						<listitem>
							<para>
								Either Portlet or Gadget.
							</para>
						</listitem>
					</varlistentry>
				</variablelist>
			</step>
			<step>
				<para>
					Enter the display name and select a type
				</para>
			</step>
			<step>
				<para>
					Select a portlet/gadget by checking the radio button.
				</para>
			</step>
			<step>
				<para>
					Click the <emphasis role="bold">Save</emphasis> button to add the selected portlet/gadget to the category.
				</para>
			</step>
		</procedure>
	</section>
	
	<section id="sect-User_Guide-Manage_Portlets_and_Gadgets-Set_Access_Permission_on_Portlets">
		<title>Set Access Permission on Portlets</title>

		<procedure>
			<step>
				<para>
					In the <emphasis role="bold">Group</emphasis> menu, select <emphasis role="bold">Administration</emphasis> and then <emphasis role="bold">Application Registry</emphasis>.
				</para>
				<mediaobject>
					<imageobject role="html">
						<imagedata fileref="images/PortletPermission.png" format="PNG" align="center" scale="110"/>
					</imageobject>
					<imageobject role="fo">
						<imagedata fileref="images/PortletPermission.png" format="PNG" align="center"  scalefit="1" contentwidth="160mm"/>
					</imageobject>
				</mediaobject>
			</step>
			<step>
				<para>
					Select a category in the Category pane that includes the portlet you want to set permissions on. All portlets of that category will be listed underneath.
				</para>
			</step>
			<step>
				<para>
					To set permission for a portlet: 
				</para>
				<itemizedlist>
					<listitem>
						<para>
							Click the <emphasis role="bold">Add Permission</emphasis> button to add access permissions to more groups.
						</para>
						<mediaobject>
							<imageobject role="html">
								<imagedata fileref="images/AddPermission.png" format="PNG" align="center" scale="110" />
							</imageobject>
							<imageobject role="fo">
								<imagedata fileref="images/AddPermission.png" format="PNG" align="center"  scalefit="1" contentwidth="150mm" />
							</imageobject>
						</mediaobject>
					</listitem>
					<listitem>
						<para>
							Or check <emphasis role="bold">Make it public</emphasis> to allow everyone to access.
						</para>
					</listitem>
				</itemizedlist>
				<para>
					Whenever the user creates or modifies a page, he or she can only see and use gadgets/portlets that fulfill two conditions: the portlet is in a <emphasis role="bold">category</emphasis> which the user has access permission too and the user has access permission on the <emphasis role="bold">portlet</emphasis>
				</para>
			</step>
		</procedure>	
	</section>
	
	<section id="sect-User_Guide-Manage_Portlets_and_Gadgets-View_detail_information_of_the_specific_Portlets">
		<title>View/Edit portlet/gadget information</title>
			<para>
					In the <emphasis role="bold">Group</emphasis> menu, select <emphasis role="bold">Administration</emphasis> then <emphasis role="bold">Application Registry</emphasis>. 
				</para>
				<mediaobject>
					<imageobject role="html">
						<imagedata fileref="images/Org1.png" format="PNG" align="center" scale="110" />
					</imageobject>
					<imageobject role="fo">
						<imagedata fileref="images/Org1.png" format="PNG" align="center"  scalefit="1" contentwidth="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>
									shows detail information about a portlet: Name, Display name, Description and Portlet preferences.
								</para>
							</listitem>
						</varlistentry>
				</variablelist>
				<para>
					To see the details of any portlet select it from the list on the left.
				</para>
				<para>
					To edit a portlet, click the edit button to the right of the portlet's name:
				</para>
				<mediaobject>
					<imageobject role="html">
						<imagedata fileref="images/EditApplication.png" format="PNG" align="center" scale="110" />
					</imageobject>
					<imageobject role="fo">
						<imagedata fileref="images/EditApplication.png" format="PNG" align="center"  scalefit="1" contentwidth="150mm" />
					</imageobject>
				</mediaobject>
				<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" contentwidth="90mm" />
					</imageobject>
				</mediaobject>
	</section>
	
	<section id="sect-User_Guide-Manage_Portlets_and_Gadgets-Add_a_Gadget">
		<title>Add a Gadget</title>
		<para>
			In the <emphasis role="bold">Group</emphasis> menu, select <emphasis role="bold">Administration</emphasis> then <emphasis role="bold">Application Registry</emphasis>. Click on the <emphasis role="bold">Gadget</emphasis> icon.
		</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" contentwidth="150mm" />
			</imageobject>
		</mediaobject>
		<para>
			You may add a remote gadget using its URL or create a brand-new one:
		</para>

			<procedure>
				<title>Add a remote Gadget</title>
					<step>
						<para>
							Click on <emphasis role="bold">Add a remote gadget</emphasis>:
						</para>
						<mediaobject>
							<imageobject>
								<imagedata fileref="images/AddGadgetnew.png" format="PNG" align="center" width="444" />
							</imageobject>
						</mediaobject>
					</step>
					<step>
						<para>
							Enter the url of the remote gadget in the <emphasis role="bold">URL</emphasis> 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" contentwidth="150mm" />
							</imageobject>
						</mediaobject>
					</step>
					<step>
						<para>
							Click <emphasis role="bold">Add</emphasis>. The new remote gadget will be appear in gadget list on left pane of the Dashboard portlet.
						</para>
					</step>
					</procedure>
					<procedure>
						<title>Create a new Gadget</title>
						<step>
							<para>
								Click on <emphasis role="bold">Create a new gadget</emphasis>:
							</para>
						<mediaobject>
							<imageobject role="html">
								<imagedata fileref="images/CreateGadget1.png" format="PNG" align="center" scale="110"/>
							</imageobject>
							<imageobject role="fo">
								<imagedata fileref="images/CreateGadget1.png" format="PNG" align="center"  scalefit="1" contentwidth="150mm"/>
							</imageobject>
						</mediaobject>
						</step>
						<step>
							<para>
								Populate the <literal>Source</literal> field with the xml code of the new gadget.
							</para>
						</step>
					</procedure>
			<para>
				You can edit or refresh a gadget using the icons in the top right of the <emphasis role="bold">Gadget Details</emphasis> pane. 
			</para>
			<para>
				You can delete a local gadget using the trashcan icon to the right of the appropriate gadget in the gadget list.
			</para>
			<mediaobject>
				<imageobject>
					<imagedata fileref="images/ActionGadget.png" format="PNG" align="center" width="444" />
				</imageobject>
			</mediaobject>
	</section>
	
	<section id="sect-User_Guide-Manage_Portlets_and_Gadgets-Add_a_new_Gadget_to_the_Dashboard_Portlet">
		<title>Add a new Gadget to the Dashboard Portlet</title>
			<para>
				See <xref linkend="sect-User_Guide-Dashboard_Portlet-Add_Gadgets"/> for instructions on how to add new gadgets to the dashboard.
			</para>
	</section>
	
	<section id="sect-User_Guide-Manage_Portlets_and_Gadgets-Manage_Gadgets">
		<title>Manage Gadgets</title>

		<section id="sect-User_Guide-Manage_Gadgets-Edit_a_Gadget">
			<title>Edit a Gadget</title>
				<para>
					Click the <emphasis role="bold">Edit Gadget</emphasis> icon located in the header of the <emphasis role="bold">Gadget Details</emphasis> page to display the following window: 
				</para>
				<mediaobject>
					<imageobject>
						<imagedata fileref="images/Source.png" format="PNG" align="center" width="444" />
					</imageobject>
				</mediaobject>
		</section>
		
<!--Covered in section above SM
		<section id="sect-User_Guide-Manage_Gadgets-Refresh_a_Gadget">
			<title>Refresh a Gadget</title>
				<para>
					Click the <emphasis role="bold">Refresh information</emphasis> icon located in the header of the <emphasis role="bold">Gadget Details</emphasis> page to display the following window: 
				</para>

		</section>
		
		<section id="sect-User_Guide-Manage_Gadgets-Delete_a_Gadget">
			<title>Delete a Gadget</title>

				<para>
					Click the trash can icon located next to the name of the gadget. An alert message should pop up asking for confirmation: 
				</para>
				<mediaobject>
					<imageobject>
						<imagedata fileref="images/Delete.png" format="PNG" align="center" />
					</imageobject>
				</mediaobject>
		</section> -->

	</section>

</section>


