<?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_Pages">
  <title>Manage Pages</title>


  <section id="sect-User_Guide-Manage_Pages-Adding_a_new_Page">
    <title>Adding a new Page</title>

    <section id="sect-User_Guide-Page_Creation_Wizard">
      <title>Adding a new Page using Page Creation Wizard</title>
      <para>
        A page creation wizard is available to administrators in order to create and publish portal pages quickly and
        easily.
      </para>
      <procedure>
        <step>
          <para>
            Mouse over
            <emphasis role="bold">Site Editor</emphasis>
            then select <emphasis role="bold">Add New Page</emphasis>.
          </para>
          <mediaobject>
            <imageobject role="html">
              <imagedata fileref="images/Wizard1.png" format="PNG" align="center" scale="110"/>
            </imageobject>
            <imageobject role="fo">
              <imagedata fileref="images/Wizard1.png" format="PNG" align="center" contentwidth="150mm"/>
            </imageobject>
          </mediaobject>
        </step>
        <step>
          <para>
            The wizard window is divided into two sections: the left pane contains the existing page/node hierarchy and
            the right pane displays the <emphasis role="bold">Page Editor</emphasis>.
          </para>

        </step>
        <step>
          <para>
            In the left pane, you can navigate up and down the node/page structure:
          </para>
          <mediaobject>
            <imageobject>
              <imagedata fileref="images/Pagewizard1.png" format="PNG"/>
            </imageobject>
          </mediaobject>

        </step>
        <step>
          <para>
            In the right pane are the required parameters for a new page:
          </para>
          <variablelist>
            <varlistentry>
              <term>
                <emphasis role="bold">Current Selected Page Node</emphasis>
              </term>
              <listitem>
                <para>
                  The path of the selected node to add a new sub page
                </para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term>
                <emphasis role="bold">Node Name</emphasis>
              </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>
                <emphasis role="bold">Display Name</emphasis>
              </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>
                <emphasis role="bold">Visible</emphasis>
              </term>
              <listitem>
                <para>
                  This checkbox toggles the global visibility of this page.
                </para>
                <para>
                  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 depends on the "publication date &amp; time"
                  attribute.
                </para>
                <para>
                  If unchecked the page is not shown under any circumstances, even if the publication period valid.
                </para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term>
                <emphasis role="bold">Publication date &amp;time</emphasis>
              </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>
                <emphasis role="bold">Start Publication Date</emphasis>
              </term>
              <listitem>
                <para>
                  The start date and time to publish the page
                </para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term>
                <emphasis role="bold">End Publication Date</emphasis>
              </term>
              <listitem>
                <para>
                  The end date and time to publish the page.
                </para>
              </listitem>
            </varlistentry>
          </variablelist>
          <note>
            <title>
              <emphasis role="bold">Setting Time and Date</emphasis>
            </title>
            <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>
          -->

        </step>
        <step>
          <para>
            Click
            <emphasis role="bold">Next</emphasis>
            or number '2' of the wizard steps to go to step 2.
          </para>
          <mediaobject>
            <imageobject>
              <imagedata fileref="images/PageWizard2.png" format="PNG" width="444"/>
            </imageobject>
          </mediaobject>
        </step>
        <step>
          <para>
            Select
            <emphasis role="bold">Empty Layout</emphasis>
            or click the icon to see more templates to select.
          </para>
        </step>
        <step>
          <para>
            Click the
            <emphasis role="bold">Next</emphasis>
            button or number '3' of the wizard step to go to step 3. You can drag portlets from the popup panel into the
            main pane to create the content of this page.
          </para>
          <mediaobject>
            <imageobject>
              <imagedata fileref="images/PageWizard3.png" format="PNG" width="444"/>
            </imageobject>
          </mediaobject>
          <variablelist>
            <varlistentry>
              <term>Applications</term>
              <listitem>
                <para>
                  Allows listing all existing portlets
                </para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term>Containers</term>
              <listitem>
                <para>
                  Allows listing all existing containers
                </para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term>Switch View mode</term>
              <listitem>
                <para>
                  Allows viewing a page in preview mode
                </para>
              </listitem>
            </varlistentry>
          </variablelist>
        </step>
        <step>
          <para>
            Click the
            <emphasis role="bold">Show Container</emphasis>
            icon if you want to see the existing containers and re-select the layout of the page. You can click on the
            <emphasis role="bold">Switch</emphasis>
            icon to view the content of this page.
          </para>
        </step>
        <step>
          <para>
            Click
            <emphasis role="bold">Save</emphasis>
            to accept creating a new page,
            <emphasis role="bold">Back</emphasis>
            to return the previous step or
            <emphasis role="bold">Abort</emphasis>
            button to quit without creating a new page.
          </para>
        </step>
      </procedure>
    </section>


    <section id="sect-User_Guide-Manage_Pages-Add_a_new_Page_in_the_Page_List">
      <title>Adding a new Page using Page Management</title>
      <procedure>
        <step>
          <para>
            Mouse over
            <emphasis role="bold">Group</emphasis>
            in the Toolbar, highlight
            <emphasis role="bold">Administration</emphasis>
            then select <emphasis role="bold">Page Management</emphasis>.
          </para>
          <mediaobject>
            <imageobject>
              <imagedata fileref="images/ManagePage.png" format="PNG" align="center" scale="110"/>
            </imageobject>
          </mediaobject>
        </step>
        <step>
          <para>
            Click <emphasis role="bold">Add New Page</emphasis>.
          </para>
        </step>
        <step>

          <mediaobject>
            <imageobject>
              <imagedata fileref="images/PageSetting.png" format="PNG" align="center" scale="110"/>
            </imageobject>
          </mediaobject>
          <variablelist>
            <varlistentry>
              <term>
                <emphasis role="bold">Page Id</emphasis>
              </term>
              <listitem>
                <para>
                  A string that identifies the page. It is automatically generated when you finish creating the page.
                </para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term>
                <emphasis role="bold">Owner type</emphasis>
              </term>
              <listitem>
                <para>
                  If the page
                  <emphasis role="bold">Owner type</emphasis>
                  is
                  <emphasis>portal</emphasis>
                  the page is created for a portal. Therefore only users who have
                  <emphasis>edit</emphasis>
                  permissions on the portal level can create this page type.
                </para>
                <para>
                  The name of the current portal is automatically selected for
                  <emphasis role="bold">Owner id</emphasis>
                  ensuring the edit permissions are assigned to users who can edit the current portal.
                </para>
                <para>
                  If the page
                  <emphasis role="bold">Owner type</emphasis>
                  is
                  <emphasis>group</emphasis>
                  the page is created for a group. Therefore only users who have
                  <emphasis>manager</emphasis>
                  permissions for that group can create this page type.
                </para>
                <mediaobject>
                  <imageobject role="html">
                    <imagedata fileref="images/PageSetting1.png" format="PNG" align="center" scale="110"/>
                  </imageobject>
                  <imageobject role="fo">
                    <imagedata fileref="images/PageSetting1.png" format="PNG" align="center" contentwidth="150mm"/>
                  </imageobject>
                </mediaobject>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term>
                <emphasis role="bold">Owner Id</emphasis>
              </term>
              <listitem>
                <para>
                  The name of the page owner. When the owner type is set to<emphasis>group</emphasis>, a list of groups
                  will allow you to select one user as the 'owner'.
                </para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term>
                <emphasis role="bold">Page Name</emphasis>
              </term>
              <listitem>
                <para>
                  The name of the page. This is a required field and must be unique. Only alphabetical, numerical and
                  underscore characters are allowed to be used for this field and the name must be at least 3 and no
                  more than 30 characters in length.
                </para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term>
                <emphasis role="bold">Page title</emphasis>
              </term>
              <listitem>
                <para>
                  The title of the the page. This is an optional field. If you choose to add a title to the page it must
                  be at least 3 and no more than 30 characters in length.
                </para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term>
                <emphasis role="bold">Show Max Window</emphasis>
              </term>
              <listitem>
                <para>
                  The option allows users to choose whether the page is shown at maximum size or not.
                </para>
              </listitem>
            </varlistentry>
          </variablelist>
        </step>
        <step>
          <para>
            Enter values for fields in the
            <emphasis role="bold">Permission Setting</emphasis>
            tab
          </para>
          <mediaobject>
            <imageobject>
              <imagedata fileref="images/PermissionSetting1.png" format="PNG" align="center" scale="110"/>
            </imageobject>
          </mediaobject>
          <variablelist>
            <varlistentry>
              <term>
                <emphasis role="bold">Access Permission</emphasis>
              </term>
              <listitem>
                <para>
                  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. Therefore, all users having access rights for the type selected in the
                  <emphasis role="bold">Owner type</emphasis>
                  field will appear in this tab. But users can also change the value of this tab.
                </para>
                <para>
                  Check the check box if you want to share access with everyone or click the
                  <emphasis role="bold">Add Permission</emphasis>
                  button to assign permission on group level, then select a group and membership or click the trash can
                  icon to remove a group from the list.
                </para>
                <mediaobject>
                  <imageobject role="html">
                    <imagedata fileref="images/EditPermission1.png" format="PNG" align="center" scale="110"/>
                  </imageobject>
                  <imageobject role="fo">
                    <imagedata fileref="images/EditPermission1.png" format="PNG" align="center" contentwidth="150mm"/>
                  </imageobject>
                </mediaobject>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term>Edit Permission</term>
              <listitem>
                <para>
                  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>
                <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 can only change this value when editing the page.
                </para>
                <mediaobject>
                  <imageobject role="html">
                    <imagedata fileref="images/EditPermission2.png" format="PNG" align="center" width="444"/>
                  </imageobject>
                  <imageobject role="fo">
                    <imagedata fileref="images/EditPermission2.png" format="PNG" align="center" contentwidth="150mm"/>
                  </imageobject>
                </mediaobject>
              </listitem>
            </varlistentry>
          </variablelist>
        </step>
        <step>
          <para>
            Click <emphasis role="bold">Save</emphasis>.
          </para>
        </step>
      </procedure>
    </section>
  </section>

  <section id="sect-User_Guide-Manage_Pages-Edit_a_Page">
    <title>Edit a Page</title>
    <para>To edit page properties, you have to open
      <emphasis role="bold">Page Properties</emphasis>
      page.
    </para>
    <procedure>
      <step>
        <para>Open
          <emphasis role="bold">Page Properties</emphasis>
          page by following one of the two ways:
        </para>
        <formalpara>
          <title>The first way:</title>
          <itemizedlist>
            <listitem>
              <para>Open the
                <emphasis role="bold">Navigation Management</emphasis>
                form by doing the steps in
                <xref linkend="proc-User_Guide-Manage_Portals-Edit_Navigation"/>
              </para>
            </listitem>
            <listitem><para>Right-click your desired node and select Edit Node's Page in the drop-down menu:</para>
            </listitem>
          </itemizedlist>
          <mediaobject>
            <imageobject role="html">
              <imagedata fileref="images/EditNodePage.png" format="PNG" align="center" scale="110"/>
            </imageobject>
            <imageobject role="fo">
              <imagedata fileref="images/EditNodePage.png" format="PNG" align="center" contentwidth="150mm"/>
            </imageobject>
          </mediaobject>
        </formalpara>
        <formalpara>
          <title>The second way:</title>
          <itemizedlist>
            <listitem>
              <para>Mouse over
                <emphasis role="bold">Group</emphasis>
                in the Toolbar. Highlight
                <emphasis role="bold">Administration</emphasis>
                and then click <emphasis role="bold">Page Management</emphasis>.
              </para>
            </listitem>
            <listitem>
              <para>Click the edit icon on the row of page you want to edit in the existing page list.</para>
            </listitem>
          </itemizedlist>
        </formalpara>
        <para>The edit page will be displayed in the
          <emphasis role="bold">Page Properties</emphasis>
          window:
        </para>
        <mediaobject>
          <imageobject role="html">
            <imagedata fileref="images/PageEditor.png" format="PNG" align="center" scale="1" contentwidth="70"/>
          </imageobject>
          <imageobject role="fo">
            <imagedata fileref="images/PageEditor.png" format="PNG" align="center" contentwidth="100mm"/>
          </imageobject>
        </mediaobject>
      </step>
      <step>
        <para>
          The properties presented in the
          <emphasis role="bold">Page Properties</emphasis>
          window are the same as those outlined in<xref
                linkend="sect-User_Guide-Manage_Pages-Add_a_new_Page_in_the_Page_List"/>.
        </para>
        <variablelist>
          <varlistentry>
            <term>Permission Setting</term>
            <listitem>
              <para>
                This form is supported for pages with
                <emphasis>group</emphasis>
                or
                <emphasis>portal</emphasis>
                ownership types. Because a user page is private, no user, other than the creator, can access or edit it.
              </para>
              <para>
                Permission on each page is set in two levels:
                <emphasis role="bold">Access right</emphasis>
                and <emphasis role="bold">Edit right</emphasis>.
              </para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>Access right</term>
            <listitem>
              <para>
                The page
                <emphasis role="bold">Access right</emphasis>
                can be set to specific user groups or set to everyone (this includes unregistered users).
              </para>
              <para>
                Current access permissions on page are listed and you can remove permissions (by clicking the delete
                icon) or add further permission (by click the
                <emphasis role="bold">Add Permission</emphasis>
                button).
              </para>
              <para>
                Populating the
                <emphasis role="bold">Make it public</emphasis>
                check box will allow all users (registered or unregistered) to access the page.
              </para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>Edit right</term>
            <listitem>
              <para>
                The
                <emphasis role="bold">Edit right</emphasis>
                allows users to change information on a page.
                <emphasis role="bold">Edit right</emphasis>
                only is set for a group of users.
              </para>
              <para>
                <emphasis role="bold">Edit right</emphasis>
                can be set for one specific membership type within a particular group (
                <emphasis role="bold">*</emphasis>
                allows every membership type in a group). If you want to re-assign this right to another group, click
                <emphasis role="bold">Select Permission</emphasis>
                to choose another one.
              </para>
            </listitem>
          </varlistentry>
        </variablelist>
      </step>
      <step>
        <variablelist>
          <varlistentry>
            <term>Editing page container layout</term>
            <listitem>
              <para>
                Click the Show Container 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 the current layout, select a layout type from the list on the left pane, then drag
                the template you want into the right pane. The new container will be displayed on the right pane.
              </para>
              <para>
                You can change the position of the current container by dragging it to another place on the right pane
                or remove it completely by clicking the delete icon in the right corner.
              </para>
            </listitem>
          </varlistentry>
        </variablelist>
      </step>
      <step>
        <variablelist>
          <varlistentry>
            <term>Editing page portlet layout</term>
            <listitem>
              <para>
                Click the Show Portlet icon to show current portlet layout of page.
              </para>
              <para>
                If you want to change the current layout, select a layout type from the list on the left pane, then drag
                it into the right pane. The new portlet will be added and displayed in the right pane. You can change
                the position of the current portlet by dragging it to the place you want on the right pane, or remove it
                completely by clicking the delete icon.
              </para>
            </listitem>
          </varlistentry>
        </variablelist>
      </step>
    </procedure>
  </section>

  <section id="sect-User_Guide-Manage_Pages-View_a_Page">
    <title>View a Page</title>
    <para>
      View any page in the existing pages list by clicking on the
      <emphasis role="bold">View</emphasis>
      icon corresponding to the page you want to view.
    </para>
  </section>

  <section id="sect-User_Guide-Manage_Pages-Delete_a_Page">
    <title>Delete a Page</title>
    <procedure>
      <step>
        <para>
          Go to
          <emphasis role="bold">Group</emphasis>
          in the Toolbar. Highlight
          <emphasis role="bold">Administration</emphasis>
          and then click <emphasis role="bold">Page Management</emphasis>. You will be presented with a list of all
          existing pages.
        </para>
      </step>
      <step>
        <para>
          Click the trash can icon in the row of the page you want to delete. It will display the confirmation message.
        </para>
        <mediaobject>
          <imageobject>
            <imagedata fileref="images/http.png" format="PNG" align="center"/>
          </imageobject>
        </mediaobject>
      </step>
      <step>
        <para>
          Click the
          <emphasis role="bold">OK</emphasis>
          button to complete the deletion or
          <emphasis role="bold">Cancel</emphasis>
          button to quit without deleting the page.
        </para>
      </step>
    </procedure>
  </section>

  <section id="sect-User_Guide-Drag_and_Drop_the_Page_Body">
    <title>Drag and Drop the Page Body</title>
    <para>
      To assist administrators to modify or personalize their portal &PRODUCT; allows you to easily drag and drop page
      content within the page.
    </para>
    <procedure>
      <step>
        <para>
          Go to
          <emphasis role="bold">Site Editor</emphasis>
          in the toolbar and click
          <emphasis role="bold">Edit Layout</emphasis>
          It will display:
        </para>
        <mediaobject>
          <imageobject>
            <imagedata fileref="images/DragPage1.png" format="PNG" width="444"/>
          </imageobject>
        </mediaobject>
      </step>
      <step>
        <para>
          Click the <emphasis role="bold">Portal Page</emphasis>, drag and drop within the portal page.
        </para>
        <mediaobject>
          <imageobject>
            <imagedata fileref="images/DragPage3.png" format="PNG" width="444"/>
          </imageobject>
        </mediaobject>
      </step>
    </procedure>
  </section>


</section>


