Skip Headers
Oracle® Fusion Middleware User's Guide for Oracle WebCenter Portal: Spaces
11g Release 1 (11.1.1.7.0)

Part Number E10149-12
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

27 Working with Multilanguage Portals

If your portal will be viewed by users in more than one country, you can configure it to display localized content based on the user's selected language and locale. For example, if you know your page will be viewed in Italy, you can localize your page so that when Italian is selected (in browser, user preferences, space, or application settings), text strings in the page will appear in Italian.

Additionally, locale selection applies special formatting considerations applicable to the selected locale. For example, whether information is typically viewed from left to right or right to left, how numbers are depicted (such as monetary information), and the like.

This chapter includes the following sections:

27.1 What You Should Know About Languages in Spaces

There are three main types of information that are displayed in Spaces:

Each type of information is handled differently when it comes to translation:

For information on translating information and more information for supporting multi-language portals, see Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter Portal.

27.1.1 Display Language Precedence

The display language controls the language in which translated information is rendered in your browser.

On the Internet, browser settings normally control the display language used for the various web sites a user visits. However, Spaces provides additional controls for language selection at the application, space, and user levels. The order of precedence for Spaces display language settings from weakest to strongest is as follows:

  • Browser setting—This is the language selected in the user's browser preferences. Browser documentation describes how to change this setting.

  • Public cookie—This is the session language a public user—that is, a user who is not logged in to Spaces—can select on your portal's Welcome page. A session language is retained for the life of the cookie. If the user clears the browser cookies, the session language is also cleared.

  • Application setting—This is the application default language configured by your Spaces administrator (for more information, see Section 5.2, "Choosing a Default Display Language").

  • User preference setting—This is the language the user selects through the personal Preferences settings (for more information, see Section 38.2, "Choosing Your Preferred Display Language").

  • Current scope—This is the language the space moderator sets for a given space (for more information, see Section 53.4.15, "Setting a Space Display Language").

Note:

If the server on which Spaces is running does not support the character set of the language preference set in Spaces, the output information related to spaces becomes garbled or displays as question marks.

To work around this issue, users can change the session language or their personal language preference to English. This creates new log file information. The log file is typically located at $WC_DOMAIN/servers/WLS_Spaces/logs.

27.1.2 Languages Supported Out-of-the-Box by Spaces

Spaces provides runtime translations for 27 languages and 100 different locales.

Table 27-1 Languages Available for Spaces

A to Fi Fr to No P to T

Arabic

French

Polish

Brazilian Portuguese

German

Portuguese

Chinese (Simplified)

Greek

Romanian

Chinese (Traditional)

Hebrew

Russian

Czech

Hungarian

Slovak

Danish

Italian

Spanish

Dutch

Japanese

Swedish

English

Korean

Thai

Finnish

Norwegian

Turkish


The list in Table 27-1 includes all the languages available to Spaces out-of-the-box. Users can also select locales associated with particular languages. For example, a user can change the language to Arabic and, within that language group, select from 20 different locales, including Algeria, Bahrain, Djibouti, and so on.

Note:

The administrative tier that offers services to Spaces, including such tools as Oracle Enterprise Manager, provides a subset of the languages available to Spaces. These include:

  • English

  • Brazilian Portuguese

  • Chinese (Simplified)

  • Chinese (Traditional)

  • French

  • German

  • Italian

  • Japanese

  • Korean

  • Spanish

The Discussions service uses the Jive application. Out-of-the-box, the Jive application bundled with WebCenter Portal supports English and Spanish. It does not support other languages listed in Table 27-1. However, Jive is open to your own translation files. For more information, refer to the Jive documentation site. This information is explicit to the Jive application user interface.

27.2 Configuring Language Options

This section describes how to configure the language options available in Spaces. It includes the following sections:

27.3 Enabling Users to Choose a Language

This section describes how to enable users to choose a language by adding a Change Language component to a page. It includes the following sections:

27.3.1 Adding a Change Language Task Flow to a Page

You can add the Change Language task flow to any page (in the Home space, in a space, or a business role page) to allow users to choose the language in which to display the UI.

To add a Change Language task flow to a page:

  1. Go to the page where you want to add the task flow, and open the page in edit mode.

    See Also:

    For more information, see Section 18.1, "Entering and Exiting Composer."

  2. Click Add Content to open the Resource Catalog.

  3. Locate the Change Language task flow in the Resource Catalog.

    Note:

    For more information, see Chapter 16, "Working with Resource Catalogs", specifically Section 16.3.1.2, "Adding Resources" (in the Add Resource Catalog Item dialog, select Web Development, then scroll to Change Language).

  4. Click Add next to the Change Language task flow, then Close the Resource Catalog.

  5. Click Save, then Close.

27.3.2 Setting Change Language Task Flow Properties

The Change Language task flow has associated properties, which users with sufficient privileges can access through the Component Properties dialog in Composer (Figure 27-4).

Figure 27-4 Change Language Task Flow - Component Properties

Change Language task flow component properties

For information about accessing the Component Properties dialog, see Section 18.6.2, "Setting Properties on a Component."

The following sections provide information about properties of the Change Language task flow and describe the properties on the Parameters tab:

27.3.2.1 What You Should Know About the Change Language Task Flow Properties

The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of the parameters on this tab, see Section 27.3.2.2, "Change Language Task Flow Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For information about wiring pages and components, see Chapter 22, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow. These properties are common to all task flows. For more information, see Section 18.6.4, "Working with Component Display Options" and Section 18.6.6, "Working with Style and Content Style Properties."

The contents of the Events tab depend on the events supported by the task flow. For more information, see Section 18.6.7, "Working with Component Contextual Events."

All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language (EL) Expressions."

Note:

Wherever you enter EL on the generic Display Options tab in the Component Properties dialog, the entry is automatically validated. If the EL syntax is invalid, an error appears and the value is neither applied nor saved. Generic Display Options are those cataloged in Table 18-1.

EL validation is not performed on non-generic display options.

27.3.2.2 Change Language Task Flow Parameters

Table 27-1 describes the parameters that are unique to the Change Language task flow.

Table 27-2 Change Language Task Flow Parameters

Parameter Description

Display Detailed List

Display a detailed list of languages, including locales.

Default: Not selected

Persist Change to Preferences

Persist the user's language choice to the user's preferences.

Default: Not selected

Scope

The name or GUID of the scope to which you want this language selection to apply.

By default, the language selection is applied to the current scope. This means that a Change Language component placed on a page in the Home space affects the entire application, and a Change Language component placed in a particular space affects just that space.

To limit the language selection to a space other than the current space, set this to the intended space's GUID. For information about obtaining a space's GUID, see Section 51.6, "Viewing Information About a Space."