JBoss.org Community Documentation

- Prev
- Next

## Chapter 2. Get started

## 2.1. Glossary

### 2.1.1. Portal

An enterprise portal is a Web application that provides means to aggregate and personalize information via application-specific portlets.

Users and administrators are able to integrate information, people and processes across organizational boundaries via a web-based user interface.

The framework enables aggregation of enterprise content and business applications with flexible management and personalization options.

### 2.1.2. Portlet

A portlet is a small, self-contained web application. Portlets are managed and displayed within a Portal. Typically, a portal page is displayed as a collection of non-overlapping portlet windows, with each portlet window displaying a different portlet. Hence a portlet (or collection of portlets) resembles a web-based application hosted in a portal.

Portlets can be configured to generated differing content and GateIn 3.2 has a number of default portlets that can be used in any portal built in the application.

### 2.1.3. Toolbar

The Toolbar spans the top of the portal application and provides links to user and administrative actions.

This screenshot displays three Navigations referred to in Section 2.1.4, “Navigation” as well as the main Menu button (on the far left of the toolbar) and the name of the current user (on the far right).

In this example the current user is the site administrator, hence the extra "Site Editor" menu.

### 2.1.4. Navigation

Portal navigations are menus that contain hyperlinks to other parts of a Portal. They can help users to visualize the structure of a site. The default navigation menus in GateIn 3.2 are located in the Toolbar (Section 2.1.3, “Toolbar”).

There are three navigation types.

Site

  This navigation links to separate sites of the parent Portal. Each site has only one navigation and it is automatically generated when the site is created.

  This functionality allows different sites to administer some Portal aspects (such as portlets) individually while maintaining other content standardized with the parent Portal.

Group

  The content of this navigation differs depending on the type of account logged in.

  - If a user account in in effect, this navigation holds personal links set up by that user.

  - When using a management account, this navigation contains links to pages for registered users as well as administrative tasks and personal links.

  - In an administrator account the navigation adds further management abilities such as Internationalization and community management.

Dashboard

  Each user has own navigation 'Dashboard' that contains links and portlets (or gadgets) that the user has selected. A user's navigation is created automatically when user is registered. This navigation only can be deleted when the user is deleted.

When logged in as an Administrator, a fourth navigation appears in the Toolbar:

Site/Group Editor

  This navigation appears as either Site Editor or Group Editor depending on the administrator's location within the portal.

  When in areas of the portal displaying content, the navigation shows as Site Editor and in areas of the portal pertaining to users, the navigation shows as Group Editor.

  This navigation contains links to add a new pages to the portal, to edit a page or to change the portal's layout. Administrators can use these links to manage the portal.

### 2.1.5. Gadgets

A gadget is a customizable mini web application that portal users may add to their web pages.

For more information about the gadgets shipped by default with GateIn 3.2, please check out Section 3.3.1, “Using the Dashboard Workspace”

### 2.1.6. Modes

By default GateIn 3.2 offers two access modes:

Public

  This mode is for guest users who are not registered with the Portal. It does not require a log in and restricts the visitor to the public pages in the portal. Visitors can register an account to gain access to the restricted pages. After being registered, they can use the Private mode but must still contact the Portal administrator to get more rights or a group manager to become a member and gain access a group.

Private

  This mode is for registered users only. Users set a username and password during registration which they can then use to sign in. This mode offers users more site privileges. Registered users can manage private resources (creating, editing or deleting private pages), "borrow" pages from other users by creating hyperlinks and change the language for individual needs.

### 2.1.7. Permissions

Permission settings control what users can and cannot do within the portal and are set by portal administrators.

Permission types dictate what a user can do within the portal. Two permission types are available as follows:

Access

  This permission type allows users to utilize portal content, that is; sign in, rearrange portlets, etc. This permission can be set for multiple member groups.

Edit

  This permission type allows users to change portal content. This includes actions such as changing page information, deleting pages etc. The edit permission is set for only one group at a time.

Permission levels dictate where in the portal the user's permission type applies. There are three permission levels:

Portal

  The portal permission level includes all pages within the portal. Therefore, a user with the access permission type can view (but not edit) all the pages within the portal. A user with edit permission at the portal level, can change any page in the portal.

Page

  The page permission level restricts the user to particular pages. Users are only able to see and/or edit (depending on their permission type) pages they have been given access to.

Portlet

  The portlet permission level allows users to create a page by dragging and dropping portlets into a page. Some portlets are only used for administrators while some are used for individuals thus administrators have to set the appropriate access permissions.

Permission types and levels can be used to effectively control who can do what within the portal. For more information on setting permissions refer to Section 4.7, “Manage Permissions”

## 2.2. Accounts

### 2.2.1. Register New Accounts

Unregistered users visiting the portal are limited in the content they can see.

Users who need access to deeper content or who need to perform actions within the portal should register themselves and then contact the portal administrator to gain appropriate access permissions to their account.

Users can quickly and easily register a new account for themselves.

1. Click Register on the Navigation bar.

   The Register New Account page appears:

   The required information includes:

   User Name

     The name used to log in.

   Password

     The password must be between 6 and 30 characters and can contain spaces.

   Confirm Password

     Re-type the password above. The Password and Confirm Password fields must be the same.

   First Name

     The user's first name.

   Last Name

     The user's last name.

   Email Address

     The user's email address. This must be in the appropriate format. For example: `username@abc.com`.

2. Fill in the form.

3. Click the 'find' icon beside the user name field to check whether the chosen username is available.

4. Enter the text next to `verification:` into the text box that appears below it:

5. Click Subscribe to register a new account or Reset to refresh all entered values. You cannot add a new account if one of the following cases occurs:

   - The chosen User name already exists or is invalid.

   - The Password has less than 6 characters or more than 30 characters.

   - The Password and Confirm Password fields are not the same.

   - The Email Address format is not valid.

   - A required field (or fields) is empty.

After adding a new account, you should contact the administrator to set appropriate permissions on your account.

## Note

Be sure you enter your email address carefully. Should you forget your user name or password, you can recover it from this email address.

### 2.2.2. Sign In and Sign Out

In order to enter the portal in private mode, you should use the account previously registered.

To sign in to a portal, users must complete the Sign in form. This form contains the following elements:

User name

  The registered user name.

Password

  The registered password.

Remember My Login

  Check this box to avoid log in every time

Forgot your User Name/Password?

  To follow some steps to get the forgotten user name or password. Please refer [Portal:Account and Password Retrieval] for more details.

Sign in

  To sign into GateIn 3.2 with user name and password.

Discard

  Close the Sign In form without logging in.

#### 2.2.2.1. Sign In

1. Go to your portal by entering the URL into the address bar of your browser (For example http://localhost:8080/portal).

2. Click the Sign in link at the top right of the page if you are current in the Classic portal. The Sign in form appears:

3. Input your registered User name and Password .

4. Select the Remember My Login check box when you sign in GateIn 3.2 at the first time if you want to automatically return to GateIn 3.2 without signing in again. You can see Section 2.2.3, “Remember User Account” for more details.

5. Click the Sign in button to submit the form or Discard to escape.

If the user name does not exist or the user name and/or password is invalid an alert message will appear. To attempt the log in again; click the OK button on the alert message to be returned to the Sign In form. Enter the user name and password again.

After signing in, you will be redirected to the homepage and welcomed with your full name in the top right corner of the page.

#### 2.2.2.2. Sign Out

This feature ends the authenticated session and returns the user to the anonymous portal.

1. In the upper left corner of the screen, hover your cursor over the GateIn 3.2 icon. A drop down menu will appear.

2. Click Sign out :

### 2.2.3. Remember User Account

Users who return to GateIn 3.2 regularly can be automatically authenticated to avoid performing an explicit authentication each time they access the portal.

1. Input your registered user name and password.

2. Select the Remember My Login check box when logging in GateIn 3.2 at the first time.

3. Click the Sign in button to sign in the portal.

Do not sign out when you leave the portal and you will be automatically authenticated next time you visit it.

### 2.2.4. Change Account Settings

To change your account information, click on the account name in the top navigation bar:

The Account Profiles form will appear:

To change your Account Profile information:

1. Select the Account Profiles tab.

2. Your User Name cannot be changed. You can change your: First Name , Last Name and Email.

3. Once the desired changes have been made, click the Save button to submit them.

If you want to change your Password :

1. Select the Change Password tab, it will display the following form:

2. Input your current password to identify that you are the owner of this account.

3. Input your new password, it must have at least 6 characters

4. Re-enter your password in the Confirm New Password field.

5. Click the Save button to accept changes.

### 2.2.5. Account and Password Retrieval

You can recover your username or password should you forget them by following these steps:

1. Click the link 'Forgot your User Name/Password?'

2. This form offers two options:

   - Forgot my password.

   - Forgot my username.

   Select the appropriate option and click Next.

3. You will be prompted to provide identification information depending on which option you selected:

   - If you selected the Forgot my password option you will be prompted for your username:

   - If you selected Forgot my username you will be prompted for your email address.

After you submit the form an email will be send to your email address with the requested information, either your username or password.

If you forgot your password you will be sent a new (temporary) password. Your original password will not be valid after this email is sent. You will be directed to a page to update your password the next time you sign in.

## 2.3. Manage Language

### 2.3.1. Change Interface Language

GateIn 3.2 allows users to pick the language of the user interface.

The priority of the interface language setting follows this hierarchy:

1. User's language

2. Browser's language

3. Portal's language

Note that users should pay attention to this order in order to change the language type appropriately.

You may switch the interface language in various places as follows:

#### 2.3.1.1. Language for the user

You may set the interface language for your account alone and not for the entire Portal as follows:

1. Open up the Start menu and click on Change Language :

2. The Interface Language Setting window lists all available languages installed in the Portal:

3. Click on the desired language. The associated native word is highlighted.

4. Click Apply to save your change. The site should refresh and display its attributes in the language you've just chosen.

#### 2.3.1.2. Set language for a user

There are two modes to set the interface language for a specific user.

Public Mode

  When accessing the portal in Public Mode, the interface language is dictated by the language setting of your web browser.

  If you have set the language of your browser to one that GateIn 3.2 does not support, the displaying language will be the language set at the Portal level (see above).

Private Mode

  The interface language in Private Mode is set when registering each user. See step four of the process to register a new account Section 2.2.1, “Register New Accounts”.

### 2.3.2. Right To Left Support

GateIn 3.2 supports Right to Left (RTL) languages.

##### The Account Portlet

##### The Application Registry Portlet

##### The Organization Portlet:

### 2.3.3. Multi-Language Navigation Nodes

GateIn 3.2 supports a multi-language environment for your portal allowing you to internationalize any menu entry on the navigation.

As the navigation bar is composed of nodes, you have to modify the display names of the nodes to enable this. Instead of entering the display name of the node in a defined language (English, for example) you have to use a language-neutral 'resource key'.

This resource key is then used to define the label that is shown for that node on the navigation bar, the menu and the breadcrumb.

#### 2.3.3.1. Key Format

The resource key format is: #{key}

The resource key can contain any text that you consider appropriate to satisfy your business needs. It should, however, be human-readable and must not contain spaces.

#### 2.3.3.2. Creating Keys

There are two ways to create a key for a node:

1. Section 2.3.3.3, “Creating Keys using Create Page Wizard”

2. Section 2.3.3.4, “Creating/Editing Keys using Navigation Management”

#### 2.3.3.3. Creating Keys using Create Page Wizard

1. Open the Site Editor menu and pick Add New Page.

2. Enter a name for this new page

3. Enter a resource key in the Display Name field.

4. Click Next. On the next screen you may define a page layout out of existing templates.

5. Click Next to finalize the page creation with portlets for instance.

#### 2.3.3.4. Creating/Editing Keys using Navigation Management

1. Click on Site in the Toolbar then Edit Navigation

2. Click on Add Node

3. The Create/Edit node dialog appears. Enter a resource key in the Label field

## Reusing Keys

You can reuse the same resource key in several nodes.

#### 2.3.3.5. Providing translation

To provide a translation for the resource key used as page name, resource bundles must be provided within the web archive.

Property files (or XML resource bundles) must be located in: WEB-INF/classes/locale/navigation/portal/[portalName]_[2letterCode].properties

- PrevChapter 1. Preface
- Top of page
- Front page
- NextChapter 3. Portlets