[portal-commits] JBoss Portal SVN: r12323 - in docs/enterprise/trunk: en-US and 1 other directory.

Author: smeehan Date: 2008-11-30 20:02:31 -0500 (Sun, 30 Nov 2008) New Revision: 12323 Removed: docs/enterprise/trunk/Makefile docs/enterprise/trunk/en-US/Administration_CMS_Portlet.xml docs/enterprise/trunk/en-US/Author_Group.xml docs/enterprise/trunk/en-US/Book_Info.xml docs/enterprise/trunk/en-US/Dynamicity.xml docs/enterprise/trunk/en-US/JBoss_Portal_Basics.xml docs/enterprise/trunk/en-US/Portal_User_Guide.ent docs/enterprise/trunk/en-US/Portal_User_Guide.xml docs/enterprise/trunk/en-US/Preface.xml docs/enterprise/trunk/en-US/Revision_History.xml docs/enterprise/trunk/en-US/User_Role.xml docs/enterprise/trunk/en-US/images/ Log: JBPORTAL-2198 - moved files Deleted: docs/enterprise/trunk/Makefile =================================================================== --- docs/enterprise/trunk/Makefile 2008-12-01 00:55:48 UTC (rev 12322) +++ docs/enterprise/trunk/Makefile 2008-12-01 01:02:31 UTC (rev 12323) @@ -1,13 +0,0 @@ -#Makefile for Portal_User_Guide - -XML_LANG = en-US -BRAND = JBoss - -#OTHER_LANGS = as-IN bn-IN de-DE es-ES fr-FR gu-IN hi-IN it-IT ja-JP kn-IN ko-KR ml-IN mr-IN or-IN pa-IN pt-BR ru-RU si-LK ta-IN te-IN zh-CN zh-TW - -# Extra Parameters start here - -# Extra Parameters stop here -COMMON_CONFIG = /usr/share/publican -include $(COMMON_CONFIG)/make/Makefile.common - Deleted: docs/enterprise/trunk/en-US/Administration_CMS_Portlet.xml =================================================================== --- docs/enterprise/trunk/en-US/Administration_CMS_Portlet.xml 2008-12-01 00:55:48 UTC (rev 12322) +++ docs/enterprise/trunk/en-US/Administration_CMS_Portlet.xml 2008-12-01 01:02:31 UTC (rev 12323) @@ -1,475 +0,0 @@ -<?xml version='1.0'?> -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ - ]> - -<chapter id="Portal_User_Guide-Test-Administration_CMS_Portlet"> - <title>Administration CMS Portlet</title> - -<section id="Portal_User_Guide-Administration_CMS_Portlet-Administration_-_Content_Management_System"> - <title>Administration - Content Management System</title> - <para> - Test of a section - </para> -</section> - -<section id="Portal_User_Guide-Administration_-_Content_Management_System-Introduction"> - <title>Introduction</title> - - - <para> - The CMSAdmin Portlet allows control over the content management system. - </para> - - <para> - Viewing the CMSAdmin Portlet is accomplished by logging in as an admin (admin/admin) and navigating to the admin portal and then the CMS Page tab. - </para> - - <para> - You should then be presented with a page that is similar to this: - </para> - - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/cms_adminpage.png" format="PNG"/> - </imageobject> - </mediaobject> -</section> - -<section id="Portal_User_Guide-Administration_-_Content_Management_System-Actions"> - <title>Actions</title> - - - <para> - This section describes common actions an administrator can perform from within the AdminCMS Portlet. All - actions are available using the flyout menu. Note that the Pending Items action is only available if the - workflow mechanism has been activated. - - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/actions_menu.png" format="PNG"/> - </imageobject> - </mediaobject> - </para> - - - <section id="Portal_User_Guide-Actions-Viewing-Directories"> - - <title>Viewing Directories</title> - - <para> - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/ss_viewfile.png" format="PNG"/> - </imageobject> - </mediaobject> - - A user can list directory contents by either clicking on the folder name or selecting "view" from the Action - dropdown and clicking "go". - </para> - </section> - - <section id="Portal_User_Guide-Actions-Viewing_File_Properties"> - - <title>Viewing File Properties</title> - - <para> - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/ss_viewfile.png" format="PNG"/> - </imageobject> - </mediaobject> - Clicking on the "Name" of a file brings up the File Properties page. - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/fileproperties.png" format="PNG"/> - </imageobject> - </mediaobject> - <para> - The File Properties window displays all the possible actions available to perform on a file. - </para> - - <para> - Version and Locale Information are also contained on this screen. Note that any version labeled with the - - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/live.png" format="PNG"/> - </imageobject> - </mediaobject> - - is the current "live" version shown to users. - </para> - -</section> - - <section id="Portal_User_Guide-Actions-Copying_Files"> - - <title>Copying Files/Directories</title> - - <para> - Clicking on the "Copy" action, displays the copy file/directory dialog window. - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/resourcecopy.png" format="PNG"/> - </imageobject> - </mediaobject> - - <para> - The copy resource window allows a user to copy files to any folder on the system, as well as copy whole directory trees to any directory on the system. A user can select which - destination directory to copy the resource to, by using the directory browser. Clicking the - - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/plus.png" format="PNG"/> - </imageobject> - </mediaobject> - - icon expands the directory tree. Clicking on the name of the directory within the tree, sets it as the destination directory for the copied resource. - - </para> -</section> - - - <section id="Portal_User_Guide-Actions-Moving_Files"> - <title>Moving Files/Directories</title> - - - <para> - Clicking on the "Move" action, displays the move file/directory dialog window. - </para> - - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/resourcemove.png" format="PNG"/> - </imageobject> - </mediaobject> - - <para> - The move resource window allows a user to move files to any folder on the system, as well as move whole directory trees to any directory on the system. A user can select which destination directory to move the resource to, by using the directory browser. Clicking the - - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/plus.png" format="PNG"/> - </imageobject> - </mediaobject> - - icon expands the directory tree. Clicking on the name of the directory within the tree, sets it as the destination directory for the moved resource. - - </para> - -</section> - - <section id="Portal_User_Guide-Actions-Deleting_Files"> - <title>Deleting Files/Directories</title> - - - <para> - Clicking on the "Delete" action, displays the delete file/directory confirmation window. - </para> - - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/resourcedelete.png" format="PNG"/> - </imageobject> - </mediaobject> - - <para> - The delete resource confirmation window allows a user to delete a file, or a directory on the system. Note that deleting a directory, will delete the entire tree, so all directories under the deleted one, will also be deleted. - - </para> - - <warning> - <para> - Currently, there is no way to retrieve deleted files/directories! Deleting a file or directory is permanent! - </para> - </warning> -</section> - - <section id="Portal_User_Guide-Actions-Creating_Directories"> - - <title>Creating Directories</title> - - <para> - Clicking on the "Create Folder" action, displays the create directory dialog window. - </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/createdirectory.png" format="PNG"/> - </imageobject> - </mediaobject> - - <para> - The create directory resource window allows a user to create a directory under chosen path. On this window, a user can specify a name for the new empty directory and assign it a description. - </para> -</section> - - <section id="Portal_User_Guide-Actions-Creating_Text"> - - <title>Creating Text/HTML Files</title> - - <para> - Clicking on the "Create File" action, displays the create file dialog window with the embedded WYSIWYG editor and directory browser. - </para> - - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/createhtml.png" format="PNG"/> - </imageobject> - </mediaobject> - - <para> - The create file window allows a user to create a text or HTML file using the embedded WYSIWYG HTML editor. The editor is a fully-functional HTML editor with a myriad of HTML functions. It also includes a preview - - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/editorpreview.png" format="PNG"/> - </imageobject> - </mediaobject> - - button and a source view - - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/editorsource.png" format="PNG"/> - </imageobject> - </mediaobject> - - button. - </para> - - <para> - An in-depth walk-through of the editor is beyond the scope of this document. However, the editor does contain help pages within it, that can be accessed by clicking the - - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/editorhelp.png" format="PNG"/> - </imageobject> - </mediaobject> - - icon. - </para> - <note> - <para> - It is important to note here that when creating links to images or other resources within the system, as user must use the relative file path to that resource. ie: images/hello.gif. Keep in mind at all times that the document base is http://localhost/portal/ by default!</para> - </note> - - <para> - Additionally, a user can set a title for the file that will be used in the portlet title bar, and a language for the file, used in serving localized content. - </para> -</section> - - <section id="Portal_User_Guide-Actions-Uploading_Files"> - - <title>Uploading Files</title> - - <para> - Clicking on the "Upload File" action, displays the upload file dialog window. - </para> - - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/resourceupload.png" format="PNG"/> - </imageobject> - </mediaobject> - - <para> - The upload file window allows a user to upload files to any directory on the system. The upload process will work on files up to 1GB and of all types. A user can select which destination directory to upload the resource to, by using the directory browser. Clicking the - - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/plus.png" format="PNG"/> - </imageobject> - </mediaobject> - - icon expands the directory tree. Clicking on the name of the directory within the tree, sets it as the destination directory for the uploaded resource. Additionally, a user can set a title for the file that will be used in the portlet title bar, and a language for the file, used in serving localized content. - </para> -</section> - - <section id="Portal_User_Guide-Actions-Uploading-Archives"> - - <title>Uploading Archives</title> - - <para> - Clicking on the "Upload Archive" action, displays the upload archive dialog window. - </para> - - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/resourceuploadarchive.png" format="PNG"/> - </imageobject> - </mediaobject> - - <para> - The upload archive window allows a user to upload archives to any directory on the system. The system will then explode the archive, create versions, and place all the files in the repository. A user can select which destination directory to upload the resource to, by using the directory browser. Clicking the - - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/plus.png" format="PNG"/> - </imageobject> - </mediaobject> - - icon expands the directory tree. Clicking on the name of the directory within the tree, sets it as the destination directory for the uploaded resource. Additionally, a user can set a language for the archive files, used in serving localized content. - - </para> - -</section> - - <section id="Portal_User_Guide-Actions-Exportig_Folders"> - <title>Exporting folders</title> - - - <para> - Clicking on the "Export Folder" action, displays the export archive dialog window. - </para> - - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/ss_exportarchive.png" format="PNG"/> - </imageobject> - </mediaobject> - - <para> - The export folder window allows a user to export entire directory structures as zip files. The system will aggregate all contents of a specific directory, and present to the user to download it. - A user can select which source directory to export the resources from, by using the directory browser. Clicking the - - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/plus.png" format="PNG"/> - </imageobject> - </mediaobject> - - icon expands the directory tree. Clicking on the name of the directory within the tree, sets it as the source directory for the export resource. Additionally, a user can set a language for the files to be exported. - </para> - - <note> - <para> - Version information is not exported. Only versions labeled "Live" are exported! - </para> - </note> - -</section> - - - <section id="Portal_User_Guide-Actions-Editing_Text"> - <title>Editing Text/HTML Files</title> - - <para> - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/fileproperties.png" format="PNG"/> - </imageobject> - </mediaobject> - - Clicking on the "text/html"link, displays the edit file dialog window with the embedded WYSIWYG editor and directory browser. - </para> - - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/editfile.png" format="PNG"/> - </imageobject> - </mediaobject> - - <para> - The edit file window allows a user to edit a text or HTML file using the embedded WYSIWYG HTML editor. The editor is a fully-functional HTML editor with a myriad of HTML functions. It also includes a preview - - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/editorpreview.png" format="PNG"/> - </imageobject> - </mediaobject> - - button and a source view - - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/editorsource.png" format="PNG"/> - </imageobject> - </mediaobject> - - button. - - </para> - - <para> - A user may specify at this point if he would like to make the new edit "live", or available in production. Additionally, a user can set a title for the file that will be used as the portlet window title. - </para> -</section> - - <section id="Portal_User_Guide-Actions-Securing_Resources"> - - <title>Securing Resources</title> - - <para> - Administrators are able to apply permissions settings to any folder or file in the CMS. These permissions on a specific node, can be applied on a per-Role and/or per-User basis. - </para> - - <para> - The security dialogue is accessed by navigating to the node you want to secure and selecting <emphasis>Secure</emphasis> - . - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/secure_menu.png" format="PNG"/> - </imageobject> - </mediaobject> - </para> - <para> - You should then be presented with a screen that allows you to assign read, write, and manage priviledges on the selected node for selected Roles or specific Users. - - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/secure_node.png" format="PNG"/> - </imageobject> - </mediaobject> - - There are three main security settings for every node in the CMS. - <itemizedlist> - <listitem> - <para><emphasis role="bold">Read Permissions:</emphasis> - Assigned roles/users can view the resource.</para> - </listitem> - <listitem> - <para> - <emphasis role="bold">Write Permissions:</emphasis> Assigned roles/users are able to edit the resource, or create nodes within it (as is the case for folders)</para> - - </listitem> - <listitem> - <para> - <emphasis role="bold">Manage Permissions:</emphasis> These permissions include: copy, move, delete, and exporting.</para> - </listitem> - </itemizedlist> - - Adminsitrating and assigning permissions on a selected node is as simple as selecting which Roles and/or Users you want to allow to have a specific permission. - - </para> -</section> - <section id="Portal_User_Guide-Actions-Workflow"> - - <title>Content Publish/Approval Workflow</title> - - <para> - When the Publish/Approval Workflow service is activated on the CMS, any requests for publishing new content or making updates to existing content requires an Approval process before going "Live". You can specify a list of Portal Roles that can act as Approvers who can authorize/deny the publishing of content in the CMS. - </para> - <para> - When a content is created in the CMS, the screen should show an Pending Queue of Approvals for that particular content as shown below in the screen. The content waiting in this queue is not accessible for "Live" usage. - - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/workflow_file_view.png" format="PNG"/> - </imageobject> - </mediaobject> - </para> - <para> - The user's who are designated as Approvers can view the CMS pending queue by clicking the <emphasis role="bold">Pending Items</emphasis> link in the flyout menu. The Pending Queue screen is as follows: - - <mediaobject> - <imageobject> - <imagedata fileref="images/admincms/workflow_pending_items.png" format="PNG"/> - </imageobject> - </mediaobject> - </para> -</section> -</section> -</chapter> - Deleted: docs/enterprise/trunk/en-US/Author_Group.xml =================================================================== --- docs/enterprise/trunk/en-US/Author_Group.xml 2008-12-01 00:55:48 UTC (rev 12322) +++ docs/enterprise/trunk/en-US/Author_Group.xml 2008-12-01 01:02:31 UTC (rev 12323) @@ -1,42 +0,0 @@ -<?xml version='1.0'?> -<!DOCTYPE authorgroup PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ -]> - -<authorgroup> - <author> - <firstname>Roy</firstname> - <surname>Russo</surname> - <affiliation> - <orgname>JBoss</orgname> - <orgdiv>Best Div in the place</orgdiv> - </affiliation> - <email&gt;roy(a)jboss.org&lt;/email&gt; - </author> - - <author> - <firstname>Chris</firstname> - <surname>Laprun</surname> - <affiliation> - <orgname>JBoss</orgname> - <orgdiv>Best Div in the place</orgdiv> - </affiliation> - <email&gt;chris.laprun(a)jboss.com&lt;/email&gt; - </author> - <author> - <firstname>Emanuel</firstname> - <surname>Muckenhuber</surname> - <affiliation> - <orgname>JBoss</orgname> - <orgdiv>Best Div in the place</orgdiv> - </affiliation> - <email&gt;emuckenh(a)redhat.com&lt;/email&gt; - </author> - - - -</authorgroup> - - - - - \ No newline at end of file Deleted: docs/enterprise/trunk/en-US/Book_Info.xml =================================================================== --- docs/enterprise/trunk/en-US/Book_Info.xml 2008-12-01 00:55:48 UTC (rev 12322) +++ docs/enterprise/trunk/en-US/Book_Info.xml 2008-12-01 01:02:31 UTC (rev 12323) @@ -1,38 +0,0 @@ -<?xml version='1.0'?> -<!DOCTYPE bookinfo PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ -]> - -<bookinfo id="Portal_User_Guide-Documentation"> - <title>Portal User Guide</title> - <subtitle>short descriptor</subtitle> - <productname>JBoss</productname> - <productnumber>0.1</productnumber> - <edition>0</edition> - <pubsnumber>0</pubsnumber> - <abstract> - <para>This document is intended for those using JBoss Portal as End-Users. This is a "Where do I Click?" Guide.</para> - <para> - For Portlet developers, Portal administrators, and those wishing to implement/extend the JBoss - Portal framework, there is a Reference Guide available from our - <ulink url="http://labs.jboss.com/portal/jbossportal/docs/index.html"&... page</ulink> - . -</para> - </abstract> - <corpauthor> - <inlinemediaobject> - <imageobject> - <imagedata format='SVG' fileref="Common_Content/images/title_logo.svg" /> - </imageobject> - <textobject><phrase>Logo</phrase></textobject> - </inlinemediaobject> - </corpauthor> - <copyright> - <year>&YEAR;</year> - <holder>&HOLDER;</holder> - </copyright> - <xi:include href="Common_Content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="Author_Group.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> -</bookinfo> - - - Deleted: docs/enterprise/trunk/en-US/Dynamicity.xml =================================================================== --- docs/enterprise/trunk/en-US/Dynamicity.xml 2008-12-01 00:55:48 UTC (rev 12322) +++ docs/enterprise/trunk/en-US/Dynamicity.xml 2008-12-01 01:02:31 UTC (rev 12323) @@ -1,604 +0,0 @@ -<?xml version='1.0'?> -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ -]> - -<chapter id="Portal_User_Guide-Dynamicity"> - <title>Administration - Portal Object Management (Dynamcity)</title> - - <para> - This is a test paragraph - </para> - <section id="Portal_User_Guide-Dynamacity-Introduction"> - <title>Introduction</title> - - <note> - <para> - Viewing the Management Portlet is accomplished by logging in as an admin (admin/admin) and navigating to the Admin portal (see linkcommentedout <!-- <xref linkend="adminportal"/> -->).</para> - </note> - - <para> - - The concept of dynamicity refers to the fact all portal objects can be dynamically modified at runtime, - eliminating the need to struggle with large xml files, or restarting the application server for changes to take - effect. In the scope of dynamicity, Portal objects are defined and can be altered as follows: - - <itemizedlist> - <listitem> - <para>Portal Instances: Multiple Portal instances can be launched at any time, secured, and skinned.</para></listitem> - <listitem><para>Pages: Multiple pages, composed of windows, can coexist inside a portal instance, secured and each - could have its own theme applied, if desired.</para></listitem> - <listitem><para>Portlets: Can be hot-deployed and will instantly register with the portal, appearing in the - management portlet.</para></listitem> - <listitem><para>Portlet Instances: Instances can be created/destroyed. Their preference variables can be modified - at runtime, instances assigned to windows and secured.</para></listitem> - <listitem><para>Windows: Windows can be secured, created/destroyed, and assigned to specific pages.</para></listitem> - <listitem><para>Themes/Layouts: Can be hot-deployed and will register with the portal, appearing the management - portlet, allowing for dynamic customization of any of the above components.</para> - </listitem> - </itemizedlist> - </para> - <!-- - <note> - Many of the operations that can be done via the Management portlet are done in the context of the current - user session. In order to see the changes on the affected pages, please log out and log back in. - </note> - --> - - </section> - - <section id="Portal_User_Guide-Dynamicity-Management_Portlet"> - <title>Management Portlet</title> - - - <note> - <para> - For the remainder of this chapter, the term <emphasis role="bold">object</emphasis> will be used to mean - Portal, Page, Portlet, or Window indifferently. - </para> - </note> - <para> - The management portlet provides a two-part interface: tabs, at the top, corresponding to the different sections - that can be managed; and the main area under it, displaying the current information for the selected tab. - - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/adminportal.png" format="PNG" scalefit="1"/> - </imageobject> - </mediaobject> - </para> - <para> - The tabs are: - - <itemizedlist> - <listitem> - <para><emphasis>Portal Objects</emphasis> gathering operations pertaining to managing portal objects - (portal instances, pages, windows and their respective configuration information). This is the most - complex part of the interface.</para> - </listitem> - <listitem><para><emphasis>Portlet Instances</emphasis> giving access to all the Portlet instances that have been - configured.</para> - </listitem> - <listitem><para><emphasis>Portlet Definitions</emphasis> giving access to the currently available portlet - providers as well as the Portlets that each provider publishes.</para> - </listitem> - <listitem> - <para><emphasis>Dashboards</emphasis> allowing administrators to configure how Dashboards should behave.</para> - </listitem> - </itemizedlist> - - We will look at each of these tabs and their functionality in the following sections. - - </para> - - - - <section id="Portal_User_Guide-Management_Portlet-Managing_Portal_Objects"> - <title>Magaging Portal Objects</title> - - - - - <section id="Portal_User_Guide-Managing_Portal_Objects-Portals_Operations"> - <title>Portals Operations</title> - - - <mediaobject> - <imageobject> - <imagedata fileref="images/management/portals.png" format="PNG" scalefit="1"/> - </imageobject> - </mediaobject> - - <para> - The <literal>Portal Objects</literal> brings the administrator to a page showing the list of the - available portal instances defined for this Portal server. Several points are of particular interest. First, a - navigation indicator or "breadcrumbs" is located right beneath the tabs. This provides context as to - where in the hierarchy of portal objects the current screen is located as some of the screens can be - found at several levels of the hierarchy. If you are lost, take a look at the breadcrumbs for context! - When you first click on the <literal>Portal Objects</literal> tab, the context is the list of portals - as shown in the picture above. - </para> - - <para> - A link to access server-wide portal properties is located right beneath the breadcrumbs. This allows - the administrator to set server-wide property and configure how errors should be handled: - - <mediaobject> - <imageobject> - <imagedata fileref="images/management/portals_properties.png" format="PNG" scalefit="1"/> - </imageobject> - </mediaobject> - - Please refer to the - - - <ulink url="http://docs.jboss.com/jbportal/v2.6/reference-guide/en/html/err... - handling chapter</ulink> of the Reference Guide for more information on this point. - </para> - - <para> - A form allowing administrator to create new portal instances is located beneath the - <literal>Properties</literal> link. Enter the name of the new portal (which, of course, should be - different from any of the already existing one) and click on <literal>Create portal</literal> and the - portal instances list will be refreshed to display the newly created portal instance. - </para> - - <para> - The last element at this level is a table listing - all the available portal instances along with possible actions on them. Clicking on the portal name - will display a screen showing the information for this given portal instance, thus drilling down the - hierarchy of available portal objects. Clicking on an action name will execute the specified action - on the associated portal instance. These actions are available on each individual portal screen as we - shall see. The notable exception is the <literal>Make Default/Default</literal> action which is only - available in this listing as it is more of an action across portals than specific to a portal thus - benefiting from being seen at this level. This action allows users to specify which portal instance - is displayed when Portal is first being accessed. Clicking on <literal>Make Default</literal> will - specify that the associated portal will be displayed to users by default. The portal list will be - refreshed and the selected portal status will be refreshed, its action now showing its - <literal>Default</literal> status. - </para> - - <para> - In the next sections we will demonstrate the functionality of the management portlet by drilling - progressively further down this hierarchy to look at the default portal, one of its pages, show - how to configure content on a page and, finally, look at a specific window information. - </para> -</section> - - <section id="Portal_User_Guide-Managing_Portal_Objects-Portal_instance_configuration"> - <title>Looking at portal instance information</title> - - <para> - If you click on the <literal>default</literal> portal in the list of available portal instances on the - top-level <literal>Portal Objects</literal> page, you'll be taken to a page showing the information - for the portal instance named "default", as shown below: - - <mediaobject> - <imageobject> - <imagedata fileref="images/management/default_portal.png" format="PNG" scalefit="1"/> - </imageobject> - </mediaobject> - - Note the breadcrumbs at the top of the screen indicating where in the hierachy you currently are. - In this case, we are looking at the <literal>default</literal> portal. - </para> - - <para> - Links to more information and operations that - affect this portal instance are located beneath the breadcrumbs. We will look at them in turn later, - excluding the <literal>Destroy</literal> operation, which as its name implies, allows an - administrator to destroy the current portal instance. Note that these links mirror the links that were - available in the portal instances list on the top level page, <literal>Make Default/Default</literal> - excepted. - </para> - - <para> - It is possible to create new pages using the page creation form located under the portal-wide - operation links. Enter the new page name and click on <literal>Create page</literal> and the new page - will appear in the pages list, ready to be configured. - </para> - - <para> - Finally, a table displaying the list of available pages for this portal instance is located at the - bottom of this screen. The first column shows the page name, which you can click to drill down the - hierachy and display the information specific to that particular page. The second column, on the other - hand, provides a list of action links on the associated page. These links - will be also appearing on individual page screens, as we shall see, just like portal action links - appearing in the portal instances list also appeared on individual portal pages. Once again, the - <literal>Make Default/Default</literal> action, which behaves as its portal counterpart, only appears - in this list: this is where you specify which page should be the default one when users first access - the portal instance. - </para> - - <para> - Let's now look at the default portal's <literal>Security</literal> information screen. This can be - accessed by clicking the <literal>Security</literal> action link on the portal page. Here, an - administrator can configure the default policy for security on objects for this portal instance: - - <mediaobject> - <imageobject> - <imagedata fileref="images/management/default_portal_security.png" format="PNG"/> - </imageobject> - </mediaobject> - - Please refer to the - <ulink - url="http://docs.jboss.com/jbportal/v2.6/reference-guide/en/html/sec... - </ulink> - - chapter of the Reference Guide for more information about how to secure portal objects. - </para> - - <para> - The <literal>Properties</literal> action link displays the currently configured properties for this - portal instance and allows you to modify them, as well as configure the error handling strategy: - - <mediaobject> - <imageobject> - <imagedata fileref="images/management/default_portal_properties.png" format="PNG" scalefit="1"/> - </imageobject> - </mediaobject> - </para> - - <para> - The <literal>Theme</literal> action link displays a screen where the administrator can configure theme, - layout and render set for this portal instance: - - <mediaobject> - <imageobject> - <imagedata fileref="images/management/default_portal_theme.png" format="PNG" scalefit="1"/> - </imageobject> - </mediaobject> - - Please refer to the - - <ulink url="http://docs.jboss.com/jbportal/v2.6/reference-guide/en/html/the... - and Themes</ulink> - - chapter of the Reference Guide for more information about themes and layouts. - - </para> - - <para> - The <literal>Display Name</literal> action link displays a screen where the administrator can configure - different names for different languages: - - <mediaobject> - <imageobject> - <imagedata fileref="images/management/display_names.png" format="PNG"/> - </imageobject> - </mediaobject> - - The different names will be used as page display names for the preferred locale of the logged-in user. - This is used by the default tab navigation of the default layouts. - </para> - - <para> - Now that we have looked at portal level information, let's drill down the hierachy again and look at - a page, more precisely the <literal>default</literal> page, by clicking its name in the pages list. - </para> - </section> - -<section id="Portal_User_Guide-Managing_Portal_Objects-Page_configuration"> - <title>Looking at a page configuration</title> - - - - <para> - - <mediaobject> - <imageobject> - <imagedata fileref="images/management/default_page.png" format="PNG" scalefit="1"/> - </imageobject> - </mediaobject> - - The layout of this screen should start feeling familiar. The information for a page looks a lot like the - information for a portal instance. Note the breadcrumbs indicating that you are indeed looking at a - page. Again, we find the action links at the top of the page, mirroring the ones that were available - for each page in the pages list of the portal instance screen. Once again, you can configure the page's - security, theme and properties. You can also destroy it if so desired. - - </para> - - <para> - Similarly to other screens in the portal objects hierarchy, a page configuration screen also provides - a list of all windows for that page. This list contains two columns: the first one contains the - name of the window, while the second one provides a list of action links for that specific window. - As usual, clicking on a window name will display information about that window. - </para> - - <para> - Just like a portal instance can contain several pages, a page can contain several subpages. As such - a page defines means to create subpages and set which subpage to display when a user is first directed - to the page. These operations work similarly to the same operations at the portal instance level. - </para> - - <para> - You can also rename the page if desired: - - <mediaobject> - <imageobject> - <imagedata fileref="images/management/default_page_rename.png" format="PNG"/> - </imageobject> - </mediaobject> - - </para> - - <para> - Of specific interest, though, is the <literal>Page Layout</literal> link. This is where you need to - go to configure which portlet instance will be displayed in which window on which region on the page. - Let's take a look at this screen and how it works: - - <mediaobject> - <imageobject> - <imagedata fileref="images/management/default_page_layout.png" format="PNG" scalefit="1"/> - </imageobject> - </mediaobject> - - This screen is structured in two parts, flowing from left to right, following the natural process - involved in displaying content on a page. First, you need to identify which content you want to - display: this is what the <literal>Content Definition</literal> section is for. Then, you need to - figure out where on the page should this content be displayed, hence the <literal>Page Layout</literal> - section. - </para> - - <para> - Let's add a window named <literal>test</literal> displaying the content of the portlet instance - named <literal>NewsPortletInstance</literal> to the center region, beneath the already existing - <literal>CMSWindow</literal>. - First, we need to enter our new window name in the <literal>Window name</literal> field and select - the <literal>portlet</literal> content type from the drop down menu: - - <mediaobject> - <imageobject> - <imagedata fileref="images/management/layout_content.png" format="PNG"/> - </imageobject> - </mediaobject> - - Once this is done, we can select the portlet instance by clicking its name in the instances list: - - <mediaobject> - <imageobject> - <imagedata fileref="images/management/layout_instance.png" format="PNG"/> - </imageobject> - </mediaobject> - - Note that this displays some information about the portlet instance. - Finally, we can add our window to the center region of the page by clicking on <literal>Add</literal> - button located left to the windows list for the region: - - <mediaobject> - <imageobject> - <imagedata fileref="images/management/layout_region.png" format="PNG"/> - </imageobject> - </mediaobject> - - Note that we could move the window up or down in the region by selecting it in the list and using the - button to the right of the list, or even destroy it if desired. - </para> - - <para> - We can repeat this process to add content of different types. Let's add a window using a Google widget - game. First, give a name to your window (we'll use "google" here) - and select <literal>widget/google</literal> from the content type drop-down menu: - - <mediaobject> - <imageobject> - <imagedata fileref="images/management/layout_google1.png" format="PNG"/> - </imageobject> - </mediaobject> - - Note how the instances list is replaced by a list of Google widgets. The widget we want to use is - located in the <literal>Fun &amp; Games</literal> category, so select it from the category drop-down menu: - - <mediaobject> - <imageobject> - <imagedata fileref="images/management/layout_google2.png" format="PNG" scalefit="1"/> - </imageobject> - </mediaobject> - - Press <literal>Search Gadgets</literal> and the widget list will be refreshed. The widget we want is - <literal>Bejeweled</literal>: - - <mediaobject> - <imageobject> - <imagedata fileref="images/management/layout_google3.png" format="PNG"/> - </imageobject> - </mediaobject> - - You can now add the new window to the desired region. - </para> - - <para> - Let's repeat this process again, this time with content from CMS. Enter a new window name (we'll - use "cms" here) and select <literal>cms</literal> from the content type drop-down menu: - - <mediaobject> - <imageobject> - <imagedata fileref="images/management/layout_cms1.png" format="PNG"/> - </imageobject> - </mediaobject> - - Once again, the instances list was replaced by a directory listing showing the available content roots. - Click on <literal>default</literal> and select <literal>project.html</literal>: - - <mediaobject> - <imageobject> - <imagedata fileref="images/management/layout_cms2.png" format="PNG"/> - </imageobject> - </mediaobject> - - You can now add the window to the desired region. - </para> - - <para> - - We've added three new windows to the default page using different content types. We added a window - displaying the content of a portlet (displaying the content of an RSS feed in this case). Another one - displaying a Google widget and yet another one some CMS-issued content. We decided to remove the - existing <literal>CMSWindow</literal>, add the <literal>cms</literal> window below the - <literal>test</literal> one in the center region, while the window showing the Google widget was added - to the left region, below the existing content: - - <mediaobject> - <imageobject> - <imagedata fileref="images/management/layout_final.png" format="PNG"/> - </imageobject> - </mediaobject> - - If all went well, logging out of the Admin portal, you should see: - - <mediaobject> - <imageobject> - <imagedata fileref="images/management/default_page_after.png" format="PNG" scalefit="1"/> - </imageobject> - </mediaobject> - - </para> - - <para> - You can read more about - - <ulink url="http://docs.jboss.com/jbportal/v2.6/reference-guide/en/html/con... - Integration - </ulink> - - in the Reference Guide. More details on how to setup content roots in CMS are available in linkcommentedout <!-- <xref linkend="cmsadmin"/> -->. - </para> - -</section> - - -<section id="Portal_User_Guide-Managing_Portal_Objects-Window_configuration"> - <title>Looking at windows of a given page</title> - - <para> - Window operations are similar to the same operations at other level of the hierachy of portal objects. - The only information displayed when a window name is clicked in the windows list of a portal page - information screen is information about the content, similar to the one that is displayed in the - page layout screen. Thus, for the <literal>google</literal> window that we created in the previous - section: - - <mediaobject> - <imageobject> - <imagedata fileref="images/management/google_window.png" format="PNG"/> - </imageobject> - </mediaobject> - - Note, once again, the breadcrumbs... :) - </para> -</section> -</section> - - <section id="Portal_User_Guide-Management_Portlet-Managing_Portlet_Instances"> - <title>Managing Portlet Instances</title> - - <para> - The <literal>Portlet Instances</literal> tab brings the administrator to the list of instances created - in the running portal. On this page, the user can either modify the security constraints for the portlet - (to grant access only to certain roles), destroy an instance or override the portlet definition preferences - for a specific instance if there is any overridable preference. - - <mediaobject> - <imageobject> - <imagedata fileref="images/management/instances.png" format="PNG"/> - </imageobject> - </mediaobject> - - </para> -</section> - - <section id="Portal_User_Guide-Management_Portlet-Managing_Portlet_Definitions"> - <title>Managing Portlet Definitions</title> - - <para> - The <literal>Portlet Definitions</literal> tab brings the administrator to the list of portlet - definitions, formatted as a table displaying name, description, whether the portlet is remote (i.e. accessed - via WSRP from a remote producer) or if it is remotable (i.e. if it is exposed to WSRP consumers by Portal's - producer). - </para> - - <para> - Portlet definitions can be made available by different providers. You can select the provider you want to - browse by selecting it in the drop-down menu and clicking <literal>View portlets</literal>. - By default, two providers are available: - - <itemizedlist> - <listitem> - <para><emphasis>local</emphasis>: this is Portal's portlet container. Any successfully deployed portlet will - appear in the list of available portlet definitions for this provider.</para> - </listitem> - <listitem> - <para><emphasis>self</emphasis>: this is Portal's default WSRP consumer configured to consume portlets - published by Portal's own WSRP producer. This doesn't have much practical interest apart from allowing - a quick test of the WSRP functionality of Portal.</para> - </listitem> - </itemizedlist> - - More providers can be added to this list. In particular, any active, properly configured WSRP consumer will - also appear in the drop-down menu. Please refer to the - - <ulink url="http://docs.jboss.com/jbportal/v2.6/reference-guide/en/html/wsr... - remote WSRP portlets in JBoss Portal - </ulink> - chapter of the Reference Guide for more information on this topic. - - <mediaobject> - <imageobject> - <imagedata fileref="images/management/portlets.png" format="PNG" scalefit="1"/> - </imageobject> - </mediaobject> - </para> - - <para> - Clicking on a portlet name in the list will display the portlet definition title, description, supported - languages and keywords. - - <mediaobject> - <imageobject> - <imagedata fileref="images/management/portlet_details.png" format="PNG"/> - </imageobject> - </mediaobject> - - The <literal>Preferences</literal> action (when available) is used to edit preferences at the portlet - definition level as explained in the JSR-168 specification. - </para> - -</section> - -<section id="Portal_User_Guide-Management_Portlet-Managing_Dashboards"> - <title>Managing Dashboards</title> - - <para> - The <literal>Dashboards</literal> tab allows the administrator to configure parameters for all user dashboards. - It also allows her to configure the error pages and theme properties as for the other portal objects. - </para> -</section> - -<section id="Portal_User_Guide-Management_Portlet-Wizard_mode"> - <title>Wizard mode</title> - - - <para> - The wizard mode is a fast and easy way to create a new window on a page backed by a portlet instance. - The user just needs to define which portlet definition to use, where should the instance be located - (portal / page / location on the page) and the wizard will automatically create a new instance of - the portlet, create a window for it and add that window to the specified region on the page - defined by the user. - - <mediaobject> - <imageobject> - <imagedata fileref="images/management/wizard.png" format="PNG"/> - </imageobject> - </mediaobject> - - </para> - - - - - </section> - - </section> - -</chapter> - Deleted: docs/enterprise/trunk/en-US/JBoss_Portal_Basics.xml =================================================================== --- docs/enterprise/trunk/en-US/JBoss_Portal_Basics.xml 2008-12-01 00:55:48 UTC (rev 12322) +++ docs/enterprise/trunk/en-US/JBoss_Portal_Basics.xml 2008-12-01 01:02:31 UTC (rev 12323) @@ -1,752 +0,0 @@ -<?xml version='1.0'?> -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ -]> - -<chapter id="Portal_User_Guide-JBoss_Portal_Basics"> - <title>JBoss Portal Basics</title> - <para> - This is a test paragraph - </para> - - <section id="Portal_User_Guide-JBoss_Portal_Basics-Portal_Concepts"> - <title>Portal Concepts - Illustrated</title> - - <para> - This section will introduce the reader to some basic portal concepts and terms, used within JBoss Portal and this document. - - </para> - - - <section id="Portal_User_Guide-Portal_Concepts-Portal_Instances"> - <title>Portal Instances</title> - - <para> - JBoss Portal supports multiple portal instances running within one container. A portal instance can be viewed as a 'bucket', containing portal objects such as, Portal Pages, Themes, Layouts, and Portlet Windows. It also manages the relationship between the user and the portal itself. The hierarchy of portal objects is depicted as follows: - - <mediaobject> - <imageobject> - <imagedata fileref="images/management/tree.gif" format="GIF" scalefit="1"/> - </imageobject> - </mediaobject> - - </para> - - <para> - A portal instance is - reachable by the url format - <emphasis>http://[domain]/[context]/portal/[portal_name]</emphasis>. In a default/local install, the - <emphasis>default</emphasis> - portal instance can be reached at - <ulink url="http://localhost:8080/portal/portal/default">http://localhost:8080/portal/portal/default</ulink> - . - </para> - - <note> - <para> Consult your portal administrator for information on the available portal instances - some of which may have restricted logins, not found in others. - </para> - </note> - -</section> - - <section id="Portal_User_Guide-Portal_Concepts-Portal_Images"> - <title>Pages</title> - <para> - A Portal Page is an aggregator of Portlet Windows. It is generated by the portal, during the reponse phase. During this phase, the portal aggregates all of the HTML markup created the individual portlets, decorates them with window controls, and presents them to the user as a consolidated page. - </para> - - <para> - A portal page is reachable by the url format - <emphasis>http://[domain]/[context]/portal/[portal_name]/[page_name]</emphasis>. In a default/local install, the - <emphasis>default</emphasis> - page can be reached at - <ulink url="http://localhost:8080/portal/portal/default"> - http://localhost:8080/portal/portal/default/default - </ulink> - . Likewise, the News Page in a default install can be reached at - <ulink url="http://localhost:8080/portal/portal/default/News"> - http://localhost:8080/portal/portal/default/News - </ulink> - </para> - - <para> - More, on navigating the portal pages and what they contain can be found in, - linkcommentedout <!-- <xref linkend="contents_pages"/> --> - </para> - </section> - -<section id="Portal_User_Guide-Portal_Concepts-Portlet_Windows"> - - <title>Portlet Windows</title> - <para> - Portlet Windows are found on Portal Pages and contain the HTML markup for a specific portlet instance. - - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/window.jpg" format="JPG" scalefit="1"/> - </imageobject> - </mediaobject> - - The diagram above, shows the default JBoss Portal page with certain window-related items highlighted (in red). - - Lets look at these items: - - <itemizedlist> - <listitem> - <para> - <emphasis role="bold">Window Title:</emphasis> - Defines the content and purpose of the individual portlet window. - </para> - </listitem> - <listitem> - <para> - <emphasis role="bold">Window Fragment:</emphasis> - Generated HTML markup produced by the portlet on the server-side. - </para> - </listitem> - <listitem> - <para> - <emphasis role="bold">Window Controls:</emphasis> - Window controls are divided into two categories and control different aspects of how the user can - impact the generated markup. Each window control can be clicked on to interact with the window in - specific ways. <emphasis role="bold">Window State</emphasis> icons control how much room the window - will take on the page and how much markup will be shown. - <emphasis role="bold">Portlet Mode</emphasis> icons, on the other hand, control the mode in which - the portlet operates, thus impacting the type of generated markup. Note that not all portlets - support all defined window states and/or portlet modes. - <itemizedlist> - <listitem> - <para> - <emphasis role="bold">Window State icons and their meaning:</emphasis> - <itemizedlist> - <listitem> - <para> - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/ico_16_normal.gif" format="GIF"/> - </imageobject> - </mediaobject> - <emphasis role="bold">(Normal)</emphasis> - - Normal window state, is the most common state for portlets (portlets in the - above image are in the normal window state). The portlet window will occupy only - enough space to show the portlet content on the page. - </para> - </listitem> - <listitem> - <para> - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/ico_16_minimize.gif" format="GIF"/> - </imageobject> - </mediaobject> - <emphasis role="bold">(Minimized)</emphasis> - - The portlet is instructed to render minimal-to-no markup. - </para> - </listitem> - <listitem> - <para> - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/ico_16_maximize.gif" format="GIF"/> - </imageobject> - </mediaobject> - <emphasis role="bold">(Maximized)</emphasis> - - The portlet window can occupy as much space of real estate on the page. - </para> - </listitem> - </itemizedlist> - </para> - </listitem> - <listitem> - <para> - <emphasis role="bold">Portlet Modes and their meaning:</emphasis> - Portlet modes are not always available (it depends on the portlet support for a given mode). - Moreover, the Edit mode is only available to logged-in users, as in this mode, the portlet - preferences can be modified to be individually suited to a particular user's needs. - <itemizedlist> - <listitem> - <para> - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/ico_edit.gif" format="GIF"/> - </imageobject> - </mediaobject> - <emphasis role="bold">(Edit)</emphasis> - - Only visible to logged-in users. Allows a logged-in user to customize the - portlet's preferences. - </para> - </listitem> - <listitem> - <para> - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/ico_cancel.gif" format="GIF"/> - </imageobject> - </mediaobject> - <emphasis role="bold">(Return to View mode)</emphasis> - - The button labeled 'Cancel' is only visible when a user is logged in and the - portlet associated to the current window is in the Edit mode. This replaces the - Edit button so the user understands that by clicking yhe user will leave the - "Edit Mode" and reverting back to "View Mode". Portlets are by default in View - mode. - </para> - </listitem> - <listitem> - <para> - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/ico_16_help.gif" format="GIF"/> - </imageobject> - </mediaobject> - <emphasis role="bold">(Help)</emphasis> - - Allows a user to access helpful information about the portlet, if it provides - it (which is recommended). - </para> - </listitem> - </itemizedlist> - </para> - </listitem> - </itemizedlist> - </para> -</listitem> -</itemizedlist> -</para> - -</section> -</section> - -<section id="Portal_User_Guide-JBoss_Portal_Basics-Contents_Pages"> - <title>Default Portal installation</title> - - <para> - This section will take a quick look at the default Portal installation and the pages and portlets that come - with it. - </para> - -<section id="Portal_User_Guide-Contents_Pages-Default_Portal_Pages"> - <title>Default Portal Pages</title> - - <para> - Three pages are available in the default Portal: Home, News and Weather. You can access pages either by - entering the page URL in your browser location bar, as shown in linkcommentedout <!-- <xref linkend="intro_portal_pages"/> -->, or - by clicking the tab associated to the page in the Navigation Tabs at the top of the page. - - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/tabs.png" format="PNG"/> - </imageobject> - </mediaobject> - - </para> - - <note> - <para> - Navigation tabs support sub-page navigation as well. By hovering over a tab with child Pages, it will display a flyout menu for those subpages: - - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/nav_sub.gif" format="GIF"/> - </imageobject> - </mediaobject> - - There are no pages with subpages in the default Portal installation.</para> - </note> - <para> - While you can use a Portal anonymously, it is much more interesting to do so while logged in, as you get the - opportunity to customize the content you want to see or even create your own personal Dashboard, as - explained in linkcommentedout <!-- <xref linkend="dashboard"/> -->. - </para> -</section> - -<section id="Portal_User_Guide-Contents_Pages-Logging_In"> - <title>Logging in to the Portal</title> - - <para> - Logging in to the portal is accomplished by clicking the - <emphasis>Login</emphasis> link at the top-right of the portal page. Portal will present you with a logging - screen where you can enter your credentials: - - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/login_ss.png" format="PNG"/> - </imageobject> - </mediaobject> - - The default Portal installation - defines two users: a regular user with no special privileges - (login: <literal>user</literal>, password: <literal>user</literal>) and an - administrator user who can alter Portal's content (login: <literal>admin</literal>, password: - <literal>admin</literal>). - - </para> - <para> - Once logged in, the top-right menu will change so you can then navigate to your personal dashboard or log - out. If you have access to other portal instances, they will be shown here as well. - - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/logged.png" format="PNG"/> - </imageobject> - </mediaobject> - </para> - <note> - <para> - If you login as an administrator, you will also be presented with a link to the <emphasis>Admin</emphasis> portal. - </para> - </note> - -</section> -</section> - - <section id="Portal_User_Guide-Contents_Pages-Home_Page"> - <title>Home Page</title> - - - - <section id="Portal_User_Guide-Home_Page-Intro_greetings_portlet"> - <title>Greetings Portlet</title> - - <para> - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/greetings.png" format="PNG"/> - </imageobject> - </mediaobject> - - Displays hard-coded links to downloading JBoss Portal, downloading portlets from <ulink url="http://www.portletswap.com">PortletSwap</ulink>, and the live online JBoss Portal demo. It also contains default authentication information on loging in, as well as a link to the official Portal documentation. - </para> -</section> - - <section id="Portal_User_Guide-Home_Page-Intro_user_portlet"> - <title>Identity User Portlet</title> - - <note> - <para> - Administrators should view linkcommentedout <!-- <xref linkend="useradmin"/> --> for managing the portal user base. Only user - operations are covered in this section...</para> - </note> - <para> - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/user_portlet.png" format="PNG" align="center" - valign="middle"/> - </imageobject> - </mediaobject> - </para> - <para> - Once successfully logged in, the user will have additional functionality at his disposal, that - is covered in the following sections. - - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/user_portlet_loggedin.png" format="PNG" align="center" - valign="middle"/> - </imageobject> - </mediaobject> - - The Identity User Portlet allows a user to: - <itemizedlist> - <listitem> - <para> - <emphasis role="bold">Create a new account</emphasis> - </para> - <para> - Create a new account by clicking on the <emphasis>"Register"</emphasis> - link in the navigation of the portlet, when not logged. A User can then fill in the necessary - information to create an account on the system: - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/user_portlet_create.png" format="PNG" align="center" - valign="middle"/> - </imageobject> - </mediaobject> - </para> - </listitem> - <listitem> - <para> - <emphasis role="bold">Lost password</emphasis> - </para> - <para> - Already registered users can request a new password by clicking on the <emphasis>"Lost password"</emphasis> link - in the navigation of the portlet. Therfore the user needs to fill in his user name to receive an e-mail with his new - login credentials. - </para> - <para> - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/user_portlet_lost.png" format="PNG" align="center" - valign="middle"/> - </imageobject> - </mediaobject> - </para> - </listitem> - <listitem> - <para> - <emphasis role="bold">View profile</emphasis> - </para> - <para> - The default page after login is the view profile, which shows a summary of the most important properties of a user. - </para> - </listitem> - <listitem> - <para> - <emphasis role="bold">Edit personal information</emphasis> - </para> - <para>A user has the ability to edit his personal information, change his password and e-mail address at any time by clicking on the - <emphasis>"Edit profile"</emphasis> link, when logged in. - </para> - </listitem> - </itemizedlist> - </para> - -</section> - -<section id="Portal_User_Guide-Home_Page-Intro_CMS_portlet"> - <title>CMS Portlet</title> - - <para> - - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/cms_portlet.png" format="PNG" scalefit="1"/> - </imageobject> - </mediaobject> - - Portal includes a basic Content Management System (CMS). Portal provides a CMS portlet which allows users - to navigate the CMS content (static html, images, binary files, etc.). - </para> - <para> - Displaying content is done by the portal using a path mapper. For example, if we wanted to display a zip - file, located in <emphasis>/default/foo/bar.zip</emphasis>, we would type in the URL - <emphasis>http://localhost:8080/content/default/foo/bar.zip</emphasis>. - <emphasis - role="bold">Notice how the path to the content, is prefixed with the '/content' term.</emphasis> - Although in this example we are describing binary content retrieval, the same is to be said for text/html - files. Keep in mind, however, that binary files are displayed outside of the portal pages, but text/html - are displayed inside the CMSPortlet Window. - </para> - <para> - <emphasis role="bold">Serving Logic:</emphasis> - The CMS Portlet now serves content based on the user's locale setting. For example: if a user's locale is - set to Spanish in his browser, and he requests URL: default/index.html , the CMSPortlet will first try - and retrieve the Spanish version of that file. If a Spanish version is not found, it will then try and - retrieve the default language version set for the CMSPortlet (set to English, by default). - </para> - <note> - <para> - Administrators should read linkcommentedout <!-- <xref linkend="admincmsPortlet"/> --> for managing the data in the CMS. - </para> - </note> - </section> - </section> - -<section id="Portal_User_Guide-Contents_Pages-News_Page"> - <title>News Page</title> - - <para> - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/newspage.png" format="PNG" scalefit="1"/> - </imageobject> - </mediaobject> - - The News Page contains 2 portlets displaying news from common internet feeds. An open internet - connection on the server-side is therefore required for them to operate. ;-) - </para> - -<section id="Portal_User_Guide-News_Page-News_Portlet"> - <title>News Portlet</title> - <para> - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/newsportlet.png" format="PNG" scalefit="1"/> - </imageobject> - </mediaobject> - - The News Portlet retrieves an RSS news feed from a URL and displays it as HTML to the user. - </para> - <para> - Additionally, a logged-in user is able to modify her preference in RSS feed source by using the - Portlet's Edit Mode (click - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/ico_edit.gif" format="GIF"/> - </imageobject> - </mediaobject> - ). Once the form is submitted, this property will be saved - in the user's preference, so she will always see the same news source, when logged in. - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/newsportlet_edit.png" format="PNG"/> - </imageobject> - </mediaobject> - </para> - <note> - <para> - This portlet is capable of handling most RSS 1.0 and RSS 2.0 feeds. - </para> - </note> - -</section> -</section> - -<section id="Portal_User_Guide-Contents_Pages-Weather_Page"> - <title>Weather Page</title> - - <para> - This page contains a portlet displaying the weather forecast for a specific location. - </para> - -<section id="Portal_User_Guide-Weather_Page-Weather_Portlet"> - <title>Weather Portlet</title> - - <para> - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/weatherportlet.gif" format="GIF"/> - </imageobject> - </mediaobject> - - The Weather Portlet retrieves an RSS weather feed, based on a key (commonly a US Postal Code), and - displays it as HTML to the user. - </para> - <para> - Additionally, a logged-in user is able to modify her preference in location by using the Portlet's Edit Mode (click - - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/ico_edit.gif" format="GIF"/> - </imageobject> - </mediaobject> - - ). Any valid US Postal Code can be input here. Once the form is submitted, this property will be saved - in the user's preference, so she will always see the same weather data for her location, when logged in. - - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/weatherportlet_edit.gif" format="GIF" align="center" - valign="middle"/> - </imageobject> - </mediaobject> - </para> - <para> - - <emphasis role="bold">Not in the United States?</emphasis> - Follow these steps to configure the Weather portlet to display information for your area. - <orderedlist> - <listitem> - <para>Go to - <ulink url="http://weather.yahoo.com/">http://weather.yahoo.com/<... - </para> - </listitem> - <listitem> - <para> - Enter your city name in the location field, found on the page: - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/weather_config1.png" format="PNG" align="center" - valign="middle"/> - </imageobject> - </mediaobject> - </para> - </listitem> - <listitem> - <para> - Find your location on the list under the form and click on it (<emphasis>Marseille, France</emphasis>, in this case): - - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/weather_config2.gif" format="GIF" align="center" - valign="middle"/> - </imageobject> - </mediaobject> - - </para> - </listitem> - <listitem> - <para> - Copy the location digits from the address bar in your browser (<emphasis>FRXX0059</emphasis> in this case): - - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/weather_config3.gif" format="GIF" align="center" - valign="middle"/> - </imageobject> - </mediaobject> - - </para> - </listitem> - <listitem> - <para> - Paste these numbers in to the weather portlet edit form (<emphasis>FRXX0059</emphasis> in this case): - - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/weather_config4.png" format="PNG" align="center" - valign="middle"/> - </imageobject> - </mediaobject> - - Hit <emphasis>submit</emphasis>... - - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/weather_config5.png" format="PNG" align="center" - valign="middle"/> - </imageobject> - </mediaobject> - </para> - </listitem> - </orderedlist> - </para> - - </section> - </section> - -<section id="Portal_User_Guide-JBoss_Portal_Basics-Dashboard"> - <title>Personal Dashboard</title> - - <para> - Once logged in, all users/administrations of the portal can access a personal dashboard by clicking the - <emphasis>Dashboard</emphasis> link at the top-right of the portal page. Note how the links changed. - - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/dashboard.png" format="PNG" scalefit="1"/> - </imageobject> - </mediaobject> - - The personal dashboard allows users to customize their portal pages however they like, and all changes will be - persisted... so the next time the user logs in to his dashboard, he will see the previous changes he made. - While navigating any of the dashboard pages, a user will be able to drag and drop portlet windows to any - location, if the administrator allows this functionality. Changes made in this fashion will also be persisted. - </para> - <para> - - It is also possible to copy the content of a shared page to your dashboard so you can customize it to your - liking. Just click the <emphasis>'Copy to my dashboard'</emphasis> link at the top right of the page. - This will clone the page and add it to your personal dashboard as a page with the same name. - - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/dashboard_copy_to.png" format="PNG" scalefit="1"/> - </imageobject> - </mediaobject> - </para> - - -<section id="Portal_User_Guide-Dashboard-Dashboard_Configure"> - <title>Configuring your personal dashboard</title> - - <para> - You can configure your dashboard by using the top-right menu item labeled <emphasis>'Configure dashboard'</emphasis>: - - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/dashboard_configure.png" format="PNG" scalefit="1"/> - </imageobject> - </mediaobject> - </para> -</section> - -<section id="Portal_User_Guide-Dashboard_Configure-Dashboard_Operations"> - <title>Dashboard-wide operations</title> - - <para> - You can select a theme and layout for your dashboard by selecting from the available ones and then - clicking on select in the <emphasis>Theme and Layout</emphasis> form. - </para> - <para> - You can also create new pages that will be added to your dashboard by simply entering the name of the new - page in the <emphasis>Create New Page</emphasis> form at the top left of the screen. - <note> - <itemizedlist> - <listitem> - <para> - Page names must be unique. - </para> - </listitem> - <listitem> - <para> - Page names cannot be blank. - </para> - </listitem> - </itemizedlist> - - </note> - Upon creating a new page, the screen will refresh and allow a user to customize the new page. - </para> - <para> - You may delete dashboard pages at any time, by first selecting the page you want to delete using the - popup menu at the top of the screen and then clicking the <emphasis>Delete this page</emphasis> button - at the bottom of the screen. We will note that users are not able to delete the default dashboard page. - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/dashboard_deletepage.png" format="PNG" scalefit="1"/> - </imageobject> - </mediaobject> - <warning> - <para> - Deleted pages are NOT recoverable. This change is permanent! - </para> - </warning> - </para> -</section> - - - <section id="Portal_User_Guide-Dashboard_Configure-Dashboard_Assignportlets"> - <title>Managing Portlets on a page</title> - - <para> - You can add, remove and reorder portlets on a dashboard page to adapt your environment to your liking. - To do so, just select the page you want to modify using the page popup selector and use the portlet - management form. We will not explain how to use it here as it is similar to the page layout functionality - of the Admin portal, which we will look at in linkcommentedout <!-- <xref linkend="page_configuration"/> --> - - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/dashboard_assignportlets.png" format="PNG" scalefit="1"/> - </imageobject> - </mediaobject> - </para> - </section> -</section> - -<section id="Portal_User_Guide-JBoss_Portal_Basics-Admin_Portal"> - <title>Admin Portal</title> - - - <para> - <note> <para> - You <emphasis role="bold">must be</emphasis> logged in as an administrator, or have proper privileges - to see this portal.</para> - </note> - <mediaobject> - <imageobject> - <imagedata fileref="images/intro/adminportal.png" format="PNG" scalefit="1"/> - </imageobject> - </mediaobject> - The Admin Portal's purpose is to allow an administrator to manage all aspects of the portal. Follow the links for in-depth reviews of these functions: - <itemizedlist> - <listitem> - <para> - Users/Roles (See: linkcommentedout <!-- <xref linkend="useradmin"/> -->, linkcommentedout <!-- <xref linkend="roleadmin"/> -->)</para></listitem> - <listitem><para>Content Management System (See: linkcommentedout <!-- <xref linkend="admincmsPortlet"/> -->)</para></listitem> - <listitem><para>Portal Objects (themes, layouts, portal instances, pages, windows, security, and deployed - portlets) (See: linkcommentedout <!-- <xref linkend="dynamicity"/> -->)</para></listitem> - <listitem><para>WSRP (See the - <ulink url="http://docs.jboss.com/jbportal/v2.6/reference-guide/en/html/wsr... chapter</ulink> - in the Reference Guide for more information)</para> - </listitem> - </itemizedlist> - </para> - - - - -</section> - - - - -</chapter> - Deleted: docs/enterprise/trunk/en-US/Portal_User_Guide.ent =================================================================== --- docs/enterprise/trunk/en-US/Portal_User_Guide.ent 2008-12-01 00:55:48 UTC (rev 12322) +++ docs/enterprise/trunk/en-US/Portal_User_Guide.ent 2008-12-01 01:02:31 UTC (rev 12323) @@ -1,5 +0,0 @@ -<!ENTITY PRODUCT "Documentation"> -<!ENTITY BOOKID "Portal_User_Guide"> -<!ENTITY YEAR "2008"> -<!ENTITY HOLDER "YOUR NAME GOES HERE 'Portal_User_Guide.ent'"> - Deleted: docs/enterprise/trunk/en-US/Portal_User_Guide.xml =================================================================== --- docs/enterprise/trunk/en-US/Portal_User_Guide.xml 2008-12-01 00:55:48 UTC (rev 12322) +++ docs/enterprise/trunk/en-US/Portal_User_Guide.xml 2008-12-01 01:02:31 UTC (rev 12323) @@ -1,15 +0,0 @@ -<?xml version='1.0'?> -<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ -]> - -<book> - <xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="JBoss_Portal_Basics.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="Dynamicity.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="Administration_CMS_Portlet.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="User_Role.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <index /> -</book> - Deleted: docs/enterprise/trunk/en-US/Preface.xml =================================================================== --- docs/enterprise/trunk/en-US/Preface.xml 2008-12-01 00:55:48 UTC (rev 12322) +++ docs/enterprise/trunk/en-US/Preface.xml 2008-12-01 01:02:31 UTC (rev 12323) @@ -1,13 +0,0 @@ -<?xml version='1.0'?> -<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ -]> - -<preface id="Portal_User_Guide-Preface"> - <title>Preface</title> - <xi:include href="Common_Content/Conventions.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude"> - <xi:fallback xmlns:xi="http://www.w3.org/2001/XInclude"> - <xi:include href="Common_Content/Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - </xi:fallback> - </xi:include> -</preface> Deleted: docs/enterprise/trunk/en-US/Revision_History.xml =================================================================== --- docs/enterprise/trunk/en-US/Revision_History.xml 2008-12-01 00:55:48 UTC (rev 12322) +++ docs/enterprise/trunk/en-US/Revision_History.xml 2008-12-01 01:02:31 UTC (rev 12323) @@ -1,26 +0,0 @@ -<?xml version='1.0'?> -<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ -]> - -<appendix id="appe-Publican-Revision_History"> - <title>Revision History</title> - <simpara> - <revhistory> - <revision> - <revnumber>1.0</revnumber> - <date></date> - <author> - <firstname></firstname> - <surname></surname> - <email></email> - </author> - <revdescription> - <simplelist> - <member></member> - </simplelist> - </revdescription> - </revision> - </revhistory> - </simpara> -</appendix> - Deleted: docs/enterprise/trunk/en-US/User_Role.xml =================================================================== --- docs/enterprise/trunk/en-US/User_Role.xml 2008-12-01 00:55:48 UTC (rev 12322) +++ docs/enterprise/trunk/en-US/User_Role.xml 2008-12-01 01:02:31 UTC (rev 12323) @@ -1,284 +0,0 @@ -<?xml version='1.0'?> -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ -]> - -<chapter id="Portal_User_Guide-User_Role"> - <title>Administration - Users and Roles</title> - <para> - - This chapter covers the administrator functions made available by the User management portlet. For end-user operation, see: - linkcommentedout <!-- <xref linkend="intro_user_portlet"/> -->. Administrative functions are available once you are logged in with the proper - credentials (admin/admin), then going to the linkcommentedout <!-- <xref linkend="adminportal"/> --> and then the Members Page tab. You can change between - user and role management by clicking on the corresponding links in the top of the portlet. - </para> - - - - <section id="Portal_User_Guide-User_Role-Managing_Users"> - <title>Managing Users</title> - - <para> - This section covers the user management of the IdentityUserManagementPortlet which is displayed by default. - For role management please see linkcommentedout <!-- <xref linkend="roleadmin"/> -->. - - <mediaobject> - <imageobject> - <imagedata fileref="images/role/memberspage.png" format="PNG" scalefit="1"/> - </imageobject> - <caption> - <para> - The Members page in the linkcommentedout <!-- <xref linkend="adminportal"/> -->. - </para> - </caption> - </mediaobject> - </para> - - <section id="Portal_User_Guide-Managing_Users-Actions"> - <title>Actions</title> - - <para> - The first page of the user management portlet displays some user related actions (eg. Search users, Create new user account) and some additional information (e.g. Registered users and Subscription mode). The registered users represent the count of all registered users and the subscription mode describes the required tasks for registering a user (i.e. first e-mail validation and then approval by the administrator). - The <emphasis>Subscription mode</emphasis> symbolizes the mode used in the User portlet. The <emphasis>Admin subscription mode</emphasis> represents - the mode used in the User management portlet. - - <mediaobject> - <imageobject> - <imagedata fileref="images/role/user_management.png" format="PNG" scalefit="1"/> - </imageobject> - <caption> - <para> - The User management portlet. - </para> - </caption> - </mediaobject> - - </para> -<section id="Portal_User_Guide-Actions-Searching_for_Users"> - <title>Searching for Users</title> - <para> - For searching users click on the link <emphasis>Search users</emphasis> and then type a partial username in the form text field, to search for usernames matching that - criteria. - - <mediaobject> - <imageobject> - <imagedata fileref="images/role/user_su.png" format="PNG" scalefit="1"/> - </imageobject> - <caption> - <para> - The search users page. - </para> - </caption> - </mediaobject> - </para> - - </section> - -<section id="Portal_User_Guide-Actions-Updating_User_Profiles"> - <title>Updating User Profiles</title> - <para> - Clicking on the - <emphasis>Edit user</emphasis> - link on the search page will allow you to edit a user's profile data, and even reset his password. - - <mediaobject> - <imageobject> - <imagedata fileref="images/role/edit_profile.png" format="PNG" scalefit="1"/> - </imageobject> - <caption> - <para> - Editing a users profile. - </para> - </caption> - </mediaobject> - </para> -</section> - - -<section id="Portal_User_Guide-Actions-Updating_User_Roles"> - <title>Updating User Roles</title> - - - <para> - Clicking on the - <emphasis>Roles</emphasis> - link in the search page allows you to modify the roles a specific user belongs to. - - <mediaobject> - <imageobject> - <imagedata fileref="images/role/assign_roles.png" format="PNG" scalefit="1"/> - </imageobject> - <caption> - <para> - Assign roles to a user. - </para> - </caption> - </mediaobject> - </para> - -</section> - -<section id="Portal_User_Guide-Actions-Creating_Users"> - <title>Creating Users</title> - <para> - Clicking on the - <emphasis>Create User Account</emphasis> - link on the main UserPortlet view, allows administrators to instantly create new users. - - <mediaobject> - <imageobject> - <imagedata fileref="images/role/create_user.png" format="PNG" scalefit="1"/> - </imageobject> - <caption> - <para> - Creating a user in the User management portlet. - </para> - </caption> - </mediaobject> - - </para> - - </section> - -<section id="Portal_User_Guide-Actions-Pending_Users"> - <title>Pending Users</title> - - - <para> - Click on the <emphasis>Show pending registrations</emphasis> link to show all registrations with validated e-mail addresses. - You can approve or reject each user by clicking on the corresponding action or click on <emphasis>select all</emphasis> - to approve or reject all selected users. - </para> - - <para> - - <mediaobject> - <imageobject> - <imagedata fileref="images/role/user_pending.png" format="PNG" scalefit="1"/> - </imageobject> - <caption> - <para> - Approve or reject pending registrations. - </para> - </caption> - </mediaobject> - - </para> - <note> - <para> - By default the subscription modes are set to <emphasis>automatic</emphasis> and users will be created automatically. Furthermore the - link to <emphasis>Show pending registrations</emphasis> will only be displayed if a user needs to be approved by the administrator. - </para> - </note> -</section> -</section> -</section> - - - -<section id="Portal_User_Guide-User_Role-Managing_Roles"> - <title>Managing Roles</title> - - <para> - The User management portlet is also responsible to create and edit roles and it is accessible once logged in - as described in previously - when clicking on the <emphasis>role management</emphasis> - link in the User management portlet. - </para> - -<section id="Portal_User_Guide-Managing_Roles-Introduction"> - <title>Introduction</title> - - <para> - A role will be used to grant different permission levels to different portlets, pages, or portal instances. A user can have several roles. - </para> - <para> - <mediaobject> - <imageobject> - <imagedata fileref="images/role/role_management.png" format="PNG" scalefit="1"/> - </imageobject> - <caption> - <para> - Role management. - </para> - </caption> - </mediaobject> - </para> -</section> - -<section id="Portal_User_Guide-Managing_Roles-Actions"> - <title>Introduction</title> - - <para> - The User management portlet also provides several actions related to role management, which are described in the following sections. - - </para> - - -<section id="Portal_User_Guide-Actions-Creating_Roles"> - <title>Creating Roles</title> - - <para> - Creating new roles, is accomplished by first clicking on the - <emphasis>Create new role</emphasis> - link in the portlet. - <mediaobject> - <imageobject> - <imagedata fileref="images/role/create_role.png" format="PNG" scalefit="1"/> - </imageobject> - <caption> - <para> - Create a new role. - </para> - </caption> - </mediaobject> - - To create a new role, you need to define a short name that will be used for - reference, and a display name for displaying to the user, for example - <literal>admin</literal> - would be a good name for the display name - <literal>Administrators</literal> - , changing the display name will not affect the - security rules. - </para> -</section> - -<section id="Portal_User_Guide-Actions-Editing_Role_Members"> - <title>Editing Role Members</title> - - <para> - Editing role members, is accomplished by first clicking the - <emphasis>Members</emphasis> - link at the role management page for the role you would like to modify. - - <mediaobject> - <imageobject> - <imagedata fileref="images/role/role_members.png" format="PNG" scalefit="1"/> - </imageobject> - <caption> - <para> - Show the members of an existing role. - </para> - </caption> - </mediaobject> - - Allows for an administrator to search and modify the members' assigned roles. - </para> - -</section> - -<section id="Portal_User_Guide-Actions-Deleting_Roles"> - <title>Deleting Roles</title> - - <para> - Deleting roles is accomplished by clicking the - <emphasis>Delete</emphasis> - link for the role you would like to remove. - </para> - - - - -</section> -</section> -</section> - -</chapter> -