Enable users to set a language preference

Enable users to set a language preference

By default, the Connections user interface (UI) is displayed in the language identified in the locale settings of the web browser being used. We can set it up to allow users to explicitly select the language in which the product is displayed.

Before you begin this procedure, determine which subset of supported languages to support. For a full list of the languages supported by IBM Connections, see Supported languages.

After performing this procedure, users can select a language from the language selector in the product's menu bar.
We can also use this configuration to force the user interface to be displayed in only a single language. For example, to display the user interface in French only, we can use the following settings: enabled=true, defaultLanguage=fr, and make sure that no language elements are defined. To enable users to set their language preference:
Start the wsadmin client from the following directory of the system where you installed the deployment manager:
app_server_root/profiles/Dmgr01/bin

Start the client from this directory or subsequent commands that you try to run will not execute properly. See Start the wsadmin client topic.

Use the wsadmin client to access and check out the Connections configuration files.

Access the Connections configuration file: execfile("connectionsConfig.py")
If we are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, we must select the node where the file is stored. This information is not used by the wsadmin client when we are making configuration changes.

Check out Connections configuration files:
LCConfigService.checkOutConfig("/tmp","cell_name")

where:

/tmp is the temporary working directory to which configuration files are copied. The files are kept in this working directory while you edit them.

With Windows, use a forward slash for the directory. For example: "/tmp".

To determine: print AdminControl.getCell()

Navigate to the working directory specified in the previous step and open LotusConnections-config.xml in a text editor.
Find the <languageSelector> element, and then make the following changes:
Change the value of the enabled attribute from false to true.

By default, the defaultLanguage attribute is blank and the product user interface is displayed in the language specified as the preferred language by each user's web browser. We can use the defaultLanguage attribute to define a fallback language in which to display the user interface if the preferred language is not one that is supported by IBM Connections. The language specified here is displayed in the language selector in the product's navigation bar. Specify the language using the exact strings listed in the following example.
Use the language code iw to specify Hebrew.

The default cookie name is lcLang. To change it, specify a name in the cookieName attribute.

No cookie domain is used by default, but we can specify a domain by adding the domain name of the deployment as the value of the cookieDomain attribute. The domain name must be a valid, fully qualified domain name of the server where the cookie resides. For example: .acme.com. Note the domain name begins with a period (.). When you provide this value for the cookie domain property, you enable the language setting to work across multiple servers, such as both profiles.acme.com and activities.acme.com.

By default, the cookie persists for the duration of the web browser session. To create a persistent cookie that has an expiry date of ten years from the date it was created, set the usePermanentCookie to true.
Within the <languageSelector> element, add one <language> element for each language you want users to be able to select from the language selector list in the product menu bar. Include a lang attribute that specifies the ISO country code associated with the language. Provide the language name as it should be displayed in the list as the value of the language element. Specify non-Latin characters in JavaScript-escaped unicode format. We can only specify languages the product supports. For a list of languages, see Supported languages.
Also, remove any of the language elements included in the languageSelector element by default if you do not want them to be displayed from the drop-down list of language options in the product menu bar. They are English, French, Chinese, and Arabic. For example:
<languageSelector 
 enabled="true" 
 defaultLanguage="" 
 cookieName="conxnsCookie"
 cookieDomain=".acme.com" 
 usePermanentCookie="true">
  <language lang="en">English</language>
  <language lang="zh">\u4e2d\u6587\uff08\u7b80\u4f53\uff09</language>
  <language lang="zh_tw">\u4e2d\u6587 (\u7e41\u9ad4)</language>
  <language lang="ja">\u65e5\u672c\u8a9e</language>
  <language lang="ko">\ud55c\uad6d\uc5b4</language>
  <language lang="fr">Fran\u00e7ais</language>
  <language lang="de">Deutsch</language>
  <language lang="it">Italiano</language>
  <language lang="es">Espa\u00f1ol</language>
  <language lang="pt_br">Portugu\u00eas (Brasil)</language>
  <language lang="cs">\u010ce\u0161tina</language>
  <language lang="da">Dansk</language>
  <language lang="nl">Nederlands</language>
  <language lang="fi">suomi</language>
  <language lang="el">\u0395\u03bb\u03bb\u03b7\u03bd\u03b9\u03ba\u03ac</language>
  <language lang="hu">Magyar</language>
  <language lang="no">Norsk (Bokm\u00e5l)</language>
  <language lang="pl">polski</language>
  <language lang="pt">Portugu\u00eas (Portugal)</language>
  <language lang="ru">\u0420\u0443\u0441\u0441\u043a\u0438\u0439</language>
  <language lang="sl">slovenščina</language>
  <language lang="sv">Svenska</language>
  <language lang="tr">T\u00fcrk\u00e7e</language>
  <language lang="iw">\u05e2\u05d1\u05e8\u05d9\u05ea</language>
  <language lang="ar">\u200f\u0627\u0644\u0639\u0631\u0628\u064a\u0629\u200f</language>
  <language lang="ca">Catal\u00e0</language>
  <language lang="kk">\u049a\u0430\u0437\u0430\u049b\u0448\u0430</language>
  <language lang="th">\u0e44\u0e17\u0e22</language>
  <language lang="in">Bahasa Indonesia</language> <!-Indonesian-> 
  <language lang="bg">\u0431\u044A\u043B\u0433\u0430\u0440\u0441\u043A\u0438</language> <!-Bulgarian->
  <language lang="ro">Rom\u00E2n\u0103</language> <!-Romanian->
  <language lang="sk">Sloven\u010Dina</language> <!-Slovak->
  <language lang="hr">Hrvatski</language> <!-Croatian-> 
</languageSelector>
The following table identifies the languages based on the lang property value:

Lang property value Language
ar Arabic
bg Bulgarian
ca Catalan
cs Czech
da Danish
de German
en English
el Greek
es Spanish
fi Finnish
fr French
hr Croatian
hu Hungarian
in Indonesian
it Italian
iw Hebrew
ja Japanese
kk Kazakh
ko Korean
nl Dutch
no Norwegian
pl Polish
pt Portuguese
pt_br Brazilian Portuguese
ro Romanian
ru Russian
sk Slovak
sl Slovene
sv Swedish
th Thai
tr Turkish
zh New Chinese
zh_tw Traditional Chinese
Save the changes to LotusConnections-config.xml.

After making changes, check the configuration files back in and we must do so during the same wsadmin session in which you checked them out for the changes to take effect. See Applying common configuration property changes for information about how to save and apply the changes.
Parent topic:
Customize the deployment

Related:

Supported languages
Index settings

Related:

Start the wsadmin client
Apply common configuration property changes
Enable users to specify email notification preferences

Lang property value	Language
ar	Arabic
bg	Bulgarian
ca	Catalan
cs	Czech
da	Danish
de	German
en	English
el	Greek
es	Spanish
fi	Finnish
fr	French
hr	Croatian
hu	Hungarian
in	Indonesian
it	Italian
iw	Hebrew
ja	Japanese
kk	Kazakh
ko	Korean
nl	Dutch
no	Norwegian
pl	Polish
pt	Portuguese
pt_br	Brazilian Portuguese
ro	Romanian
ru	Russian
sk	Slovak
sl	Slovene
sv	Swedish
th	Thai
tr	Turkish
zh	New Chinese
zh_tw	Traditional Chinese