<?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_Portals">
    <title>Manage Portals</title>


<section id="sect-User_Guide-Create_a_New_Portal">
	<title>Create a New Portal</title>
	<para>
		Creating a new portal requires access credentials that only an administrator may set up.
	</para>
	<procedure>
		<step>
			<para>
				Click on <emphasis role="bold">Site</emphasis> in the toolbar then click the <emphasis role="bold">Add New Portal</emphasis> button.
			</para>
			<mediaobject>
				<imageobject role="html">
					<imagedata fileref="images/AddPortal.png" format="PNG" align="center" scale="110" />
				</imageobject>
				<imageobject role="fo">
					<imagedata fileref="images/AddPortal.png" format="PNG" align="center" contentwidth="150mm" />
				</imageobject>
			</mediaobject>
		</step>
		<step>
			<para>
				 This opens the <emphasis role="bold">Create New Portal</emphasis> window which contains the <emphasis role="bold">Portal Templates</emphasis> tab. By default, the template used in new portals is 'Classic'.
				<mediaobject>
					<imageobject role="html">
						<imagedata fileref="images/PortalTemplate.png" format="PNG" align="center" scale="100" />
					</imageobject>
					<imageobject role="fo">
						<imagedata fileref="images/PortalTemplate.png" format="PNG" align="center" contentwidth="150mm" />
					</imageobject>
				</mediaobject>
			</para>
			<para>
				 Select the <emphasis role="bold">Portal Setting</emphasis> tab.
			</para>
				<mediaobject>
					<imageobject role="html">
						<imagedata fileref="images/PortalSetting2.5.png" format="PNG" align="center" scale="100" />
					</imageobject>
					<imageobject role="fo">
						<imagedata fileref="images/PortalSetting2.5.png" format="PNG" align="center" contentwidth="150mm" />
					</imageobject>
				</mediaobject>

		</step>
		<step>
			<para>
				Enter a string for the <emphasis role="bold">Portal Name</emphasis> field. This field is required and must be unique. Only alphabetical, numerical and underscore characters are allowed for this field and the name must have at least 3 characters.
			</para>
		</step>
		<step>
			<para>
				Select the default display language for the portal.
			</para>
		</step>
		<step>
			<para>
				Select a skin for a portal by selecting one from the skin list.
			</para>
		</step>
        <step>
            <para>
                Click on the
                <emphasis role="bold">Properties</emphasis>
                tab to set the properties of a portal.
            </para>
            <mediaobject>
                <imageobject role="html">
                    <imagedata fileref="images/show-info-bar.png" format="PNG" align="center" scale="100"/>
                </imageobject>
                <imageobject role="fo">
                    <imagedata fileref="images/show-info-bar.png" format="PNG" align="center" contentwidth="150mm"/>
                </imageobject>
            </mediaobject>
            <para><guilabel>Keep session alive</guilabel>: keeps the working session for a long time to avoid the working time out. There are 3 options: </para>
            <itemizedlist>
                <listitem>
                    <para><guilabel>Never</guilabel>: The session will never timeout, even if an application requests it.</para>
                </listitem>
                <listitem>
                    <para><guilabel>On-demand</guilabel>: The session will timeout if an application requests it.</para>
                </listitem>
                <listitem>
                    <para><guilabel>Always</guilabel>: The session will time out after a set period. </para>
                </listitem>
            </itemizedlist>
            <para><guilabel>Show info bar by default</guilabel>: The checkbox is ticked, it means that the info bar of the porlet is shown by default when the portlet is used in a page of the portal.</para>
		</step>
		<step>
			<para>
				Click on the <emphasis role="bold">Permission Setting</emphasis> tab and set the permissions for the Portal.
			</para>
			<para>
				The access permissions list for the portal is empty by default. You have to select at least one or tick on the <emphasis role="bold">Make it public</emphasis> check box to assign access permission to everyone.
			</para>
		</step>
		<step>
			<para>
				Click <emphasis role="bold">Save</emphasis>
			</para>
		</step>
	</procedure>
	<para>
		You also can edit or delete a portal. See <xref linkend="sect-User_Guide-Manage_Portals-Edit_a_Portal" /> or <xref linkend="sect-User_Guide-Manage_Portals-Delete_a_Portal" /> for more details.
	</para>
</section>


     <section id="sect-User_Guide-Manage_Portals-Edit_a_Portal">
		<title>Edit a Portal</title>
		<para>
			An administrator can chagne many aspects of a portal:
		</para>
		<para>
			Click <emphasis role="bold">Site</emphasis> on the Toolbar. A list of active portals will appear:
		</para>
		<mediaobject>
			<imageobject role="html">
				<imagedata fileref="images/ActivePortals.png" format="PNG" align="center" scale="110" />
			</imageobject>
			<imageobject role="fo">
				<imagedata fileref="images/ActivePortals.png" format="PNG" align="center" contentwidth="150mm" />
			</imageobject>
		</mediaobject>		
		
        </section>
	<section id="proc-User_Guide-Manage_Portals-Edit_Layout">
		<title>Edit Layout</title>
			<para>
				To edit the layout of a portal, click the <emphasis>Edit Layout</emphasis> key beside the active portal you wish to edit:
			</para>
		<mediaobject>
			<imageobject role="html">
				<imagedata fileref="images/EditLayout.png" format="PNG" align="center" scale="110" />
			</imageobject>
			<imageobject role="fo">
				<imagedata fileref="images/EditLayout.png" format="PNG" align="center" contentwidth="150mm" />
			</imageobject>
		</mediaobject>
		<para>
			New applications, containers or gadgets can be dragged from the <emphasis role="bold">Edit Inline Composer</emphasis> window (inset on the right of the screen) onto the main portal body.
		</para>
		<mediaobject>
			<imageobject role="html">
				<imagedata fileref="images/EditLayout2.png" format="PNG" align="center" scale="110" />
			</imageobject>
			<imageobject role="fo">
				<imagedata fileref="images/EditLayout2.png" format="PNG" align="center" contentwidth="150mm" />
			</imageobject>
		</mediaobject>
		<para>
			Elements already in place in the portal body can be rearranged or removed as required. Use the relevent button in the overlay that appears when you mouse-over each element:
		</para>
		<mediaobject>
			<imageobject role="html">
				<imagedata fileref="images/EditLayout3.png" format="PNG" align="center" scale="110" />
			</imageobject>
			<imageobject role="fo">
				<imagedata fileref="images/EditLayout3.png" format="PNG" align="center" contentwidth="150mm" />
			</imageobject>
		</mediaobject>
	</section>

	
	<section id="proc-User_Guide-Manage_Portals-Edit_Navigation">
		<title>Edit Navigation</title>
			<para>
				The portal navigation can be edited by clicking <emphasis role="bold">Site</emphasis> in the <emphasis role="bold">Toolbar</emphasis> and selecting the <emphasis>Edit Navigation</emphasis> link next to the portal you wish to edit:
			</para>
			<mediaobject>
				<imageobject role="html">
					<imagedata fileref="images/EditNavigation1.png" format="PNG" align="center" scale="110" />
				</imageobject>
				<imageobject role="fo">
					<imagedata fileref="images/EditNavigation1.png" format="PNG" align="center" contentwidth="150mm" />
				</imageobject>
			</mediaobject>
			<para>
				The <emphasis>Navigation Management</emphasis> window appears:
			</para>		
			<mediaobject>
				<imageobject role="html">
					<imagedata fileref="images/NavigationManagement.png" format="PNG" align="center" scale="100" />
				</imageobject>
				<imageobject role="fo">
					<imagedata fileref="images/NavigationManagement.png" format="PNG" align="center" contentwidth="150mm" />
				</imageobject>
			</mediaobject>
			<para>
				More information about actions possible in this window can be found in <xref linkend="sect-User_Guide-Manage_Navigation_Nodes"/>
			</para>
	</section>

	<section id="proc-User_Guide-Manage_Portals-Edit_Properties">
		<title>Edit Properties</title>
		<para>
			Portal properties such as language, description, label, skin and permissions can be set by clicking on <emphasis role="bold">Site</emphasis> in the <emphasis role="bold">Toolbar</emphasis> and selecting the <emphasis>Edit Portal Properties</emphasis> link for the portal you wish to edit:
		</para>
		<mediaobject>
			<imageobject role="html">
				<imagedata fileref="images/PortalProperties.png" format="PNG" align="center" scale="110" />
			</imageobject>
			<imageobject role="fo">
				<imagedata fileref="images/PortalProperties.png" format="PNG" align="center" contentwidth="150mm" />
			</imageobject>
		</mediaobject>
		<para>
			The various tabs available in the edit properties window give access to the properties that can be edited for the chosen portal:
		</para>
		<mediaobject>
			<imageobject role="html">
				<imagedata fileref="images/EditPortal2.6New.png" format="PNG" align="center" scale="110" />
			</imageobject>
			<imageobject role="fo">
				<imagedata fileref="images/EditPortal2.6New.png" format="PNG" align="center" contentwidth="150mm" />
			</imageobject>
		</mediaobject>
		<para>
			Click on <emphasis role="bold">Save</emphasis> or <emphasis role="bold">Cancel</emphasis> to either set or discard any changes you have made in the portal.
		</para>
	</section>

	<section id="sect-User_Guide-Manage_Portals-Delete_a_Portal">
		<title>Delete a Portal</title>
		<procedure>
			<step>
				<para>
					To delete a portal click on the Delete icon beside the portal you no longer require.
				</para>
				<para>
					The confirmation message will appear:
				</para>
				<mediaobject>
					<imageobject role="html">
						<imagedata fileref="images/SureDelete.png" format="PNG" align="center" scale="100" />
					</imageobject>
					<imageobject role="fo">
						<imagedata fileref="images/SureDelete.png" format="PNG" align="center" contentwidth="100mm" />
					</imageobject>
				</mediaobject>
			</step>
			<step>
				<para>
					Click <emphasis role="bold">OK</emphasis>
				</para>
			</step>
		</procedure>
	</section>

        <section id="sect-User_Guide-Change_Portal_Skins">
		<title>Change Portal Skins</title>
			<para>
				Skins are graphic styles used to provide an attractive user interface. Each skin has its own characteristics with different backgrounds, icons, and other visual elements.
			</para>
			<para>
				Skins can be changed temporarily (and are reset at log-out) or permanently.
			</para>
				<variablelist>
					<varlistentry>
						<term><emphasis role="bold">Change the skin temporarily</emphasis></term>
							<listitem>
								<procedure>
									<step>
										<para>
											Mouse over the Start menu and click on <emphasis role="bold">Change Skin</emphasis>.
										</para>
										<mediaobject>
											<imageobject role="html">
												<imagedata fileref="images/StarPortlet.png" format="PNG" align="center" scale="110" />
											</imageobject>
											<imageobject role="fo">
												<imagedata fileref="images/StarPortlet.png" format="PNG" align="center" contentwidth="150mm" />
											</imageobject>
										</mediaobject>
									</step>
									<step>
										<para>
											Select a new skin from the Skin list. By clicking on the skin name a picture will appear in the preview pane.
										</para>
										<mediaobject>
											<imageobject role="html">
												<imagedata fileref="images/SkinSet1.png" format="PNG" scale="100"/>
											</imageobject>
											<imageobject role="fo">
												<imagedata fileref="images/SkinSet1.png" format="PNG" contentwidth="120mm" />
											</imageobject>
										</mediaobject>
									</step>
									<step>
										<para>
											Click <emphasis role="bold">Apply</emphasis> to apply to the portal. 
										</para>
									</step>
								</procedure>
							</listitem>
					</varlistentry>
					<varlistentry>
						<term><emphasis role="bold">Change the skin permanently</emphasis></term>
							<listitem>
								<procedure>
									<step>
										<para>
											Click on <emphasis role="bold">Site</emphasis>, then <emphasis role="bold">Edit Portal's Properties</emphasis>.
										</para>
									</step>

									<step>
										<para>
											In the <emphasis role="bold">Portal Setting</emphasis> tab, select another skin <emphasis role="bold">Skin</emphasis> list
										</para>
									<mediaobject>
											<imageobject role="html">
												<imagedata fileref="images/Skin1.png" format="PNG" scale="100"/>
											</imageobject>
											<imageobject role="fo">
												<imagedata fileref="images/Skin1.png" format="PNG" contentwidth="120mm"/>
											</imageobject>
										</mediaobject>
									</step>
									<step>
										<para>
											Click <emphasis role="bold">Save</emphasis> to finish your change.
										</para>
									</step>
								</procedure>
							</listitem>
					</varlistentry>
				</variablelist>
				<para>
					More information about adding skins to a portal can be found in the Reference Guide for this product.
				</para>

	</section>

        <section id="sect-User_Guide-Switching_between_Portals">
		<title>Switching between Portals</title>
		<para>
			Mouse over <emphasis role="bold">Site</emphasis> on the Toolbar for a list all portals in which you have at least access rights:
		</para>
		<mediaobject>
			<imageobject role="html">
				<imagedata fileref="images/SitePortlet.png" format="PNG" align="center" scale="110" />
			</imageobject>
			<imageobject role="fo">
				<imagedata fileref="images/SitePortlet.png" format="PNG" align="center" scalefit="1" contentwidth="150mm" />
			</imageobject>
		</mediaobject>
		<para>
			Users switch between Portals by clicking on the desired portal. Please wait a few seconds for the change to take effect.
		</para>
	</section>


</section>


