JBoss.orgCommunity Documentation

Chapter 5. Portal Administration

5.1. Toolbar
5.1.1. User Actions in the Toolbar
5.1.2. Administration Actions in the Toolbar
5.2. Manage Portals
5.2.1. Create a New Portal
5.2.2. Edit a Portal
5.2.3. Edit Layout
5.2.4. Edit Navigation
5.2.5. Edit Properties
5.2.6. Delete a Portal
5.2.7. Change Portal Skins
5.2.8. Switching between Portals
5.3. Manage Navigation Nodes
5.3.1. Add a new node
5.3.2. Edit a node
5.3.3. Copy a node
5.3.4. Clone nodes
5.3.5. Cut a node
5.3.6. Delete a node
5.3.7. Change Node Order
5.4. Manage Pages
5.4.1. Adding a new Page
5.4.2. Edit a Page
5.4.3. View a Page
5.4.4. Delete a Page
5.4.5. Drag and Drop the Page Body
5.5. Manage Users and Groups
5.5.1. Manage users
5.5.2. Manage groups
5.5.3. Manage memberships
5.6. Manage Permissions
5.6.1. Set Portal Permissions
5.6.2. Set Page Permission
5.6.3. Set Access Permission on a Category
5.6.4. Set Access Permission on a Portlet

The Toolbar offers a convenient way for users and administrators to execute tasks within the portal quickly and easily.

If you are the portal administrator (or the administrator has granted you the appropriate permission privileges) you can execute all actions related to portal nodes. These actions include adding new nodes or editing, copying, moving, deleting or cloning existing nodes.

  1. Click on Site then click on Edit Navigation of the portal you want to modify.

  2. Select a node from list (to create a new node like sub-node of the selected node) or click the Up icon to create a new node at the root level of the portal.

  3. Right-click on the selected navigation or node and select Add new Node option. The Add new node form appears:

    The Page Node Setting tab includes:

    In the Page Selector tab, you can select a page or not for this node.

    You do not have to enter values in these fields. They are automatically populated after selecting an existing page by clicking the Search and Select Page button.

    The Select Page form appears:

    This window lists all existing pages of Portal or Group with basic information for each page.

    To select a page for creating a node, simply select a page from the list or search for a specific page as follows:

After selecting a page, the details of this page will be displayed in the Page Selector form.

After configuring the page node settings, the page selector and the node's icon, click the Save button to accept or the Cancel button to quit without creating a new node.

A page creation wizard is available to administrators in order to create and publish portal pages quickly and easily.

  1. Mouse over Site Editor then select Add New Page.

  2. The wizard window is divided into two sections: the left pane contains the existing page/node hierarchy and the right pane displays the Page Editor.

  3. In the left pane, you can navigate up and down the node/page structure:

  4. In the right pane are the required paramters for a new page:

  5. Click Next or number '2' of the wizard steps to go to step 2.

  6. Select Empty Layout or click the icon to see more templates to select.

  7. Click the Next button or number '3' of the wizard step to go to step 3. You can drag portlets from the popup panel into the main pane to create the content of this page.

  8. Click the Show Container icon if you want to see the existing containers and re-select the layout of the page. You can click on the Switch icon to view the content of this page.

  9. Click Save to accept creating a new page, Back button to return the previous step or Abort button to quit without creating a new page.

  1. Mouse over Group in the Toolbar, highlight Administration then select Page Management.

  2. Click on Add New Page.

  3. Enter values for fields in the Permission Setting tab

  4. Click Save.

  1. Mouse over Group in the Toolbar. Highlight Administration and then click on Page Management.

  2. Click the edit icon on the row of page you want to edit in the existing page list.

    Click the edit icon to show a form to edit page properties.

  3. The properties presented in the Page Properties window are the same as those outlined in Section 5.4.1.2, “Adding a new Page using Page Management”.

    Permission Setting

    This form is supported for pages with group or portal ownership types. Because a user page is private, no user, other than the creator, can access or edit it.

    Permission on each page is set in two levels: Access right and Edit right.

    Access right

    The page Access right can be set to specific user groups or set to everyone (this includes unregistered users).

    Current access permissions on page are listed and you can remove permissions (by clicking the delete icon) or add further permission (by click the Add Permission button).

    Populating the Make it public check box will allow all users (registered or unregistered) to access the page.

    Edit right

    The Edit right allows users to change information on a page. Edit right only is set for a group of users.

    Edit right can be set for one specific membership type within a particular group (* allows every membership type in a group). If you want to re-assign this right to another group, click Select Permission to choose another one.

  4. Editing page container layout

    Click the Show Container icon to show current container layout of selected page on your right and all the container layouts list on the left pane.

    If you want to change the current layout, select a layout type from the list on the left pane, then drag the template you want into the right pane. The new container will be displayed on the right pane.

    You can change the position of the current container by dragging it to another place on the right pane or remove it completely by clicking the delete icon in the right corner.

  5. Editing page portlet layout

    Click the Show Portlet icon to show current portlet layout of page.

    If you want to change the current layout, select a layout type from the list on the left pane, then drag it into the right pane. The new portlet will be added and displayed in the right pane. You can change the position of the current portlet by dragging it to the place you want on the right pane, or remove it completely by clicking the delete icon.

Several tools are offered to assist Administrators manage users, groups and memberships easily and effectively.

Mouse over Group on the Toolbar. Highlight Organization and select Users and Groups Management

Administrators can see all existing registered users and search, edit or even delete them. Each user's groups and memberships (roles) in these groups are also available. You can not add users to a group but you can remove them from the group.

Mouse over Group on the Toolbar. Highlight Organization and select Users and Groups Management

Select the tab Group Management

By default, all existing groups will be displayed on the left pane. This tab is used to add new, edit or delete a group. The right pane shows information about the selected group including information about the members in the specific group along with a small form to add a new user to a group.

  1. Find the group in the existing tree and click on its label. Existing group memberships are listed on the left hand side along with the Add Member window.

  2. Click on the magnify glass to open up the User selector.

    Refer to Section 5.5.1.2, “Search for users” for instructions on how to locate a user.

    Check the box next to the user name then click Add

  3. Select the membership appropriate for this user. If the desired membership does not appear you may try to click on the refresh icon to get the latest list.

  4. Click Save

Permissions play an important part in accessing and performing actions in the Portal. Depending on these permissions assigned by an administrator, users gain access to various components and actions such as edit portals, pages or portlets.

Details about permission types and levels can be found in Section 2.7, “Permissions”