2.7.1. Locales configuration

Various languages are available in the portal package. The configuration below will define which languages shown in the "Change Language" section and made available to users.

The portal.war:/WEB-INF/conf/common/common-configuration.xml file of your installation contains the following section:


<component>

  <key>org.exoplatform.services.resources.LocaleConfigService</key>

  <type>org.exoplatform.services.resources.impl.LocaleConfigServiceImpl</type>

  <init-params>

    <value-param>

      <name>locale.config.file</name>

      <value>war:/conf/common/locales-config.xml</value>

    </value-param>

  </init-params>

</component>

This configuration points to the locale configuration file (portal.war:/WEB-INF/conf/common/locales-config.xml) that contains the following code:


<?xml version="1.0" encoding="UTF-8"?>

<locales-config>

  <locale-config>

    <locale>en</locale>

    <output-encoding>UTF-8</output-encoding>

    <input-encoding>UTF-8</input-encoding>

    <description>Default configuration for english locale</description>

  </locale-config>

 

  <locale-config>

    <locale>fr</locale>

    <output-encoding>UTF-8</output-encoding>

    <input-encoding>UTF-8</input-encoding>

    <description>Default configuration for the french locale</description>

  </locale-config>

 

  <locale-config>

    <locale>ar</locale>

    <output-encoding>UTF-8</output-encoding>

    <input-encoding>UTF-8</input-encoding>

    <description>Default configuration for the arabic locale</description>

    <orientation>rt</orientation>

  </locale-config>

</locales-config>

locale: This has to be defined, such as http://ftp.ics.uci.edu-pub-ietf-http-related-iso639.txt. In this example, "ar" is Arabic.
output-encoding: This deals with the character encoding. It is recommended that UTF-8 be used.
input-encoding: In the Java implementation, the encoding parameters will be used for the request response stream. The input-encoding parameter will be used for requesting setCharacterEncoding(..).
description: Brief description of the language.
orientation: The default orientation of text and images is Left-To-Right. GateIn 3.5 supports Right-To-Left orientation. Modifying the text orientation is explained in Section 2.9, “RTL (Right To Left) framework”.