Language Support

Many of the messages or strings in Profound UI are configurable for different languages or cultures.  You can customize these strings yourself, or even define new languages with configuration options.

Configuring a Language

For example, to set your language to "English, USA" you would code the following:

pui["language"] = "en_US";

The following languages are provided with Profound UI:

  • en_US = English, USA  (default)

  • en_GB = English, Great Britain.  Prior to Profound UI 6 fix pack 8.0, the code en_UK should be used instead.

  • de_DE = German, Germany

  • pt_PT = Portuguese, Portugal

  • pt_BR = Portuguese, Brazil

  • es_ES = Spanish, Spain

  • es_MX = Spanish, Mexico

  • fr_FR = French, France

  • fr_CA = French, Canada

  • it_IT = Italian, Italy

  • nl_NL = Dutch, Netherlands

  • zh_HK = Chinese (Traditional) Hong Kong

Setting pui["language"] is all that's necessary for Profound UI to provide text or messages in the language of your choice.

Starting with Profound UI version 6 fix pack 8.0 if pui["language"] is not set, it will attempt to use the language you've set in the 'lang' query string parameter.

Customizing a Language

Any of the strings that are provided in the language dictionary of Profound UI may be customized.   To do that, you can define a string as follows:

pui[dictionary-name][language][message id] = "The New String";

For example, to customize the message that occurs when there's no connection to the server in USA English you can code:

pui["runtimeMsg"]["en_US"]["no connection message"] = "The server is unavailable. Call Jerry at 555-1234 for help!";

This can be set separately for each language.  For example, in German you might prefer:

You can find a list of the possible dictionary and message id values under "Defining a new language", below.

Defining a New Language

If Profound UI does not come with your preferred language already defined, you can add a new language yourself by coding all of the needed strings as configuration settings.   To do that, your settings file should set the language you wish to use.  You can pick any string you like for the language name.   Then, define empty objects for the runtimeMsg and runtimeText dictionaries, as follows:

Then, define a message for each message ID in each dictionary.  Here is a list of all of the messages you can define:

Please Note!

Due to security updates to many browsers, some of the following options may not work in all browsers.

Known Limitations:

  • pui["runtimeMsg"]["MyLanguage"]["closeMessage"]
    This option is currently only fully operational in Internet Explorer (not Edge).

You should only translate the text on the right-hand side of the equal sign.  Do not translate the message IDs (such as "no connection message" or "signature overflow") because Profound UI will not be able to find your message in the dictionary if you change the dictionary name or the message id.

Where do you save this configuration option? Here.