<?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
          <emphasis role="bold">Dashboard</emphasis>
          in the toolbar to access the Dashboard portlet.
        </para>
      </step>
      <step>
        <para>
          Click
          <emphasis role="bold">Add Gadgets</emphasis>
          to open the Dashboard Workspace.
        </para>
      </step>

    </procedure>
    <para>
      The active Dashboard can be individually named by clicking 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>
    <title>Change gadget preferences</title>
    <para>The edit icon on gadgets only displays when the gadget has some gadget preferences. This icon enables users to
      display the edit form and change preferences of gadget.
    </para>
    <mediaobject>
      <imageobject role="html">
        <imagedata fileref="images/ChangGadget.png" format="PNG" align="center" scale="50" contentwidth="50"/>
      </imageobject>
      <imageobject role="fo">
        <imagedata fileref="images/ChangGadget.png" format="PNG" align="center" scalefit="1"
                   contentwidth="120mm"/>
      </imageobject>
    </mediaobject>
    <para>To change preferences of a gadget, for example RSS gadget, do as follows:</para>
    <procedure>
      <step>
        <para>Click the edit icon to open the edit form of RSS gadget:</para>
        <mediaobject>
          <imageobject role="html">
            <imagedata fileref="images/RSSGatein.png" format="PNG" align="center" scale="110"/>
          </imageobject>
          <imageobject role="fo">
            <imagedata fileref="images/RSSGatein.png" format="PNG" align="center" scalefit="1"
                       contentwidth="120mm"/>
          </imageobject>
        </mediaobject>
      </step>
      <step>
        <para>Enter your preferred RSS into the
          <guilabel>FEED URL</guilabel>
          field and one numeric character (from 1 to 100) in the
          <guilabel>Items</guilabel>
          field. The numeric character you entered is the number of items displayed in the RSS gadget.
        </para>
      </step>
      <step>
        <para>Click
          <guibutton>Save</guibutton>
          to accept your changes, or
          <guibutton>Close</guibutton>
          to close the edit form without any changes.
        </para>
      </step>
    </procedure>
  </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 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
          <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 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>


