Add New Language UWC

From MsgServerDocWiki

[edit] How to translate Communications Express (UWC) into another language

Because Sun dos not provide additional localizations beyond those already supplied, you need to create your own translations.

UWC appears to be a single application, once you lift the hood you notice that is cobbled together with code from three separate applications. You have a UWC/calendar component, a webmail component and an addressbook component.

When Communications Express is installed conform application defaults the active deployment is placed in /var/opt/SUNWuwc all file locations mentioned in this section are relative to that.

Many of the changes require a restart of the application (container) to take effect.

Sun publishes quite extensive documentation, covering more then you need, and sometimes missing some details as well. These pages just describe the steps I've taken to localize Communications Express.

Start by copying (again I'm most confortable with translating from English to Dutch) the orginal english localization files for UWC:

mkdir ./WEB-INF/domain/nl
cp ./WEB-INF/domain/en/i18n.js ./WEB-INF/domain/nl/i18n.js

Translate ./WEB-INF/domain/nl/i18n.js into Dutch.

Edit the file uwcdomainconfig.properties and add Dutch to the list of supported languages:

vi  ./WEB-INF/domain/uwcdomainconfig.properties
...
  supportedLanguages=en;nl
...

The name for "nl" localization is most likely not present the ./WEB-INF/domain/[LANG]/i18n.js files. Add

...
   uwc-common-options-preferredLanguage-nl=Dutch
...

(localized) to languages you're going to support.

Don't forget the help/manual pages:

cp -r ./help/en ./help/nl

Now the main application is translated. When you restart the webserver or the application server you'll notice that the webmail part isn't translated yet, nor is the addressbook.

In the older versions of UWC the webmail component was passed trough to Messenger Express. Then translating Messenger Express was required to get localized webmail pages in UWC. In the more recent releases the webmail has been "integrated" into UWC. It looks very much like the engineers simply copied the code from messenger express and now deploy it as their own. But you still need to localize the webmail components seperately from UWC.

cp -r ./webmail/en ./webmail/nl

Translate the file ./webmail/nl/i18n.js If you have already made a translation of Messenger Express, this one is virtually identical.

The last component that needs to be translated is the online address book.

cp ./WEB-INF/ui/html/abs/dictionary-en.xml ./WEB-INF/ui/html/abs/dictionary-nl.xml 

If you use UWC "Hosted Domain Support" you can have modified localization files for each of the domains you configure. That allows you to fi modify the banner text from "Welcome Username" to "Welcome Username to Company extranet".

mkdir ./WEB-INF/domain/domainname.com
cp -r ./WEB-INF/domain/en ./WEB-INF/domain/domainname.com/en
vi ./WEB-INF/domain/domainname.com/en/i18h.js
...
uwc-common-welcome=Welcome {0} to Company extranet
...