<?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-Dashboard_Portlet">
	<title>Dashboard Portlet</title>
	<para>
		The Dashboard portlet is used for hosting mini applications known as gadgets. The Dashboard uses a variety of graphical effects for displaying, opening and using gadgets.
	</para>
	<para>
		Gadgets within the Dashboard portlet can be moved and rearranged. New gadgets can be created and unnecessary ones deleted. More than one instance of the same gadget can be opened at the same time and each instance of the same gadget can have different settings. The gadgets instances are completely independent.
	</para>
	<mediaobject>
		<imageobject role="html">
			<imagedata fileref="images/Dashboard1.png" format="PNG" align="center" scale="110" />
		</imageobject>
		<imageobject role="fo">
			<imagedata fileref="images/Dashboard1.png" format="PNG" align="center"  scalefit="1" contentwidth="90mm" />
		</imageobject>
	</mediaobject>

	<section id="sect-User_Guide-Dashboard_Portlet-Using_the_Dashboard_Workspace">
		<title>Using the Dashboard Workspace</title>
		<procedure>
			<step>
				<para>
					Click on <emphasis role="bold">Dashboard</emphasis> in the toolbar to access the Dashboard portlet.
				</para>
			</step>
			<step>
				<para>
				 	Click on <emphasis role="bold">Add Gadgets</emphasis> to open the Dashboard Workspace.
				</para>
			</step>
			
		</procedure>
		<para>
			The active Dashboard can be individually named by clicking on the default name ("<emphasis>Click and Type Page Name</emphasis>")...
		</para>
		<mediaobject>
			<imageobject role="html">
				<imagedata fileref="images/Dashname.png" format="PNG" align="center" scale="150"/>
			</imageobject>
			<imageobject role="fo">
				<imagedata fileref="images/Dashname.png" format="PNG" align="center" scalefit="1" contentwidth="120mm"/>
			</imageobject>
		</mediaobject>
		<para>
			...and entering a new name:
		</para>
		<mediaobject>
			<imageobject role="html">
				<imagedata fileref="images/Dashname1.png" format="PNG" align="center" scale="150"/>
			</imageobject>
			<imageobject role="fo">
				<imagedata fileref="images/Dashname1.png" format="PNG" align="center" scalefit="1" contentwidth="120mm"/>
			</imageobject>
		</mediaobject>

		<para>
			The Dashboard Workspace lists all available gadgets. Four gadgets are provided by default with &PRODUCT;, however you can add many more.
		</para>
		<mediaobject>
			<imageobject role="html">
				<imagedata fileref="images/Dash2.png" format="PNG" align="center" scale="110"/>
			</imageobject>
			<imageobject role="fo">
				<imagedata fileref="images/Dash2.png" format="PNG" align="center" scalefit="1" contentwidth="150mm"/>
			</imageobject>
		</mediaobject>

		<variablelist id="vari-User_Guide-Using_the_Dashboard_Workspace-Default_Gadgets">
			<title>Default Gadgets:</title>
			<varlistentry>
				<term><emphasis role="bold">Calendar</emphasis></term>
				<listitem>
					<para>
						The calendar gadget allows users to switch easily between daily, monthly and yearly view and, is customizable to match your portal's theme.
					</para>
					<mediaobject>
						<imageobject role="html">
							<imagedata fileref="images/Calendar.png" format="PNG" align="center" scale="110"/>
						</imageobject>
						<imageobject role="fo">
							<imagedata fileref="images/Calendar.png" format="PNG" align="center" scalefit="1"  contentwidth="70mm"/>
						</imageobject>
					</mediaobject>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term><emphasis role="bold">ToDo</emphasis></term>
				<listitem>
					<para>
						This application helps you organize your day and work group. It is designed to keep track of your tasks in a convenient and transparent way. Tasks can be highlighted with different colors.
					</para>
					<mediaobject>
						<imageobject role="html">
							<imagedata fileref="images/Todo.png" format="PNG" align="center" scale="110"/>
						</imageobject>
						<imageobject role="fo">
							<imagedata fileref="images/Todo.png" format="PNG" align="center" scalefit="1"  contentwidth="70mm"/>
						</imageobject>
					</mediaobject>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term><emphasis role="bold">Calculator</emphasis></term>
				<listitem>
					<para>
						This mini-application lets you perform most basic arithmetic operations and can be themed to match the rest of your portal.
					</para>
					<mediaobject>
						<imageobject role="html">
							<imagedata fileref="images/Calculator.png" format="PNG" align="center" scale="110"/>
						</imageobject>
						<imageobject role="fo">
							<imagedata fileref="images/Calculator.png" format="PNG" align="center" scalefit="1"  contentwidth="70mm"/>
						</imageobject>
					</mediaobject>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term><emphasis role="bold">RSS Reader</emphasis></term>
				<listitem>
					<para>
						An RSS reader, or aggregator, collates content from various, user-specified feed sources and displays them in one location. This content can include, but isn't limited to, news headlines, blog posts or email. The RSS Reader gadget displays this content in a single window on your Portal page.
					</para>
					<mediaobject>
						<imageobject role="html">
							<imagedata fileref="images/RSSReader.png" format="PNG" align="center" scale="110"/>
						</imageobject>
						<imageobject role="fo">
							<imagedata fileref="images/RSSReader.png" format="PNG" align="center" scalefit="1"  contentwidth="70mm"/>
						</imageobject>
					</mediaobject> 
				</listitem>
			</varlistentry>
			<varlistentry>
				<term><emphasis role="bold">More Gadgets</emphasis></term>
				<listitem>
					<para>
						Many more gadgets can be found at <ulink type="http" url="http://www.google.com/ig/directory?synd=open">Google Gadgets</ulink>. &PRODUCT; is compatible with most of the gadgets available there.
					</para>
					<mediaobject>
						<imageobject role="html">
							<imagedata fileref="images/GoogleGadgets.png" format="PNG" align="center" scale="110"/>
						</imageobject>
						<imageobject role="fo">
							<imagedata fileref="images/GoogleGadgets.png" format="PNG" align="center" scalefit="1"  contentwidth="160mm"/>
						</imageobject>
					</mediaobject>				
				</listitem>
			</varlistentry>
		</variablelist>
	</section>
		
	<section id="sect-User_Guide-Dashboard_Portlet-Add_Gadgets">
		<title>Add Gadgets</title>
		<para>
			To add more gadgets from external sources:
		</para>
		<procedure>
			<step>
				<para>
					Obtain the URL (.xml or .rss) of the gadget you wish to add from the gadget source.
				</para>				
				<para>
					The gadgets available at <ulink type="http" url="http://www.google.com/ig/directory?synd=open">Google Gadget</ulink> provide a link to <emphasis role="bold">View source</emphasis>. Clicking on this link will open a page showing the gadget's XML source. Use the URL of this page in the Dashboard Workspace. The URL should end with <literal>.xml</literal>
				</para>
				<para>
					For example:
				</para>
				<mediaobject>
					<imageobject role="html">
						<imagedata fileref="images/XMLURL.png" format="PNG" align="center" scale="110"/>
					</imageobject>
					<imageobject role="fo">
						<imagedata fileref="images/XMLURL.png" format="PNG" align="center" scalefit="1"  contentwidth="160mm"/>
					</imageobject>
				</mediaobject>
				<note>
					<title>URL Types</title>
					<para>
						Remote gadgets can be only created using an .xml link or RSS URL. However, if you use a link that generates an RSS feed (for example: <ulink type="http" url="http://feeds.feedburner.com/gatein">http://feeds.feedburner.com/gatein</ulink>), a new RSS reader gadget will be created automatically even if the URL does not end with <literal>.rss</literal>.
					</para>
				</note>
			</step>
			<step>
				<para>
					Return to your portal and click <emphasis role="bold">Dashboard</emphasis> in the toolbar.
				</para>
<!--
				<mediaobject>
					<imageobject role="html">
						<imagedata fileref="images/DashboardLink.png" format="PNG" align="center" scale="110"/>
					</imageobject>
					<imageobject role="fo">
						<imagedata fileref="images/DashboardLink.png" format="PNG" align="center" scalefit="1"  contentwidth="150mm"/>
					</imageobject>
				</mediaobject>
-->				
			</step>
			<step>
				<para>
					Click on <emphasis role="bold">Add Gadgets</emphasis> in the Dashboard to open the Dashboard Workspace.
				</para>
					<mediaobject>
						<imageobject role="html">
							<imagedata fileref="images/Dashboard1.png" format="PNG" align="center" scale="110"/>
						</imageobject>
						<imageobject role="fo">
							<imagedata fileref="images/Dashboard1.png" format="PNG" align="center" scalefit="1"  contentwidth="90mm"/>
						</imageobject>
					</mediaobject>
			</step>
			<step>
				<para>
					The Dashboard Workspace dialog appears: 
					<mediaobject>
						<imageobject role="html"> 
							<imagedata fileref="images/EnterLink.png" format="PNG" align="center" scale="110"/>
						</imageobject>
						<imageobject role="fo"> 
							<imagedata fileref="images/EnterLink.png" format="PNG" align="center" scalefit="1"  contentwidth="50mm"/>
						</imageobject>
					</mediaobject>
				</para>
			</step>
			<step>
				<para>
					Paste the URL obtained in step 1 into the text box above the gadget list.
				</para>
				<mediaobject>
					<imageobject role="html">
						<imagedata fileref="images/CodePaste.png" format="PNG" align="center" scale="110"/>
					</imageobject>
					<imageobject role="fo">
						<imagedata fileref="images/CodePaste.png" format="PNG" align="center" scalefit="1"  contentwidth="100mm" />
					</imageobject>
				</mediaobject>
				
			</step>
			<step>
				<para>
					Click on the <emphasis role="bold">plus</emphasis> icon to add the new gadget to the page.
				</para>
				<mediaobject>
					<imageobject role="html">
						<imagedata fileref="images/NewGadget.png" format="PNG" align="center" scale="110"/>
					</imageobject> 
					<imageobject role="fo">
						<imagedata fileref="images/NewGadget.png" format="PNG" align="center" scalefit="1"  contentwidth="150mm"/>
					</imageobject> 
				</mediaobject>
				
			</step>
		</procedure>

	</section>

</section>


