Selecting the Language

Setting the Language / Locale

The locale describes the regional settings for a piece of software, such as a website, or unblu. The most noticeable aspect of the locale is the language in which the user interface is displayed, but the locale can contain other regional aspects (such as date formats, number formats, and so on).

If your website has only one locale, you can set that locale for unblu in the configuration. This ensures that the website and unblu use the same locale (that is, the same language and the same (other) regional settings).

If your website supports multiple locales, then you have to tell unblu which locale to use.

Using an Attribute

A very straightforward way of telling unblu which locale to use is by using the default html lang attribute in the <html>tag, as follows:

<html lang="en">

IMPORTANT: Although according to the html specification, the langattribute can be set on any tag, unblu only checks the html tag to pick up the language.

unblu supports either language code or language-region code as defined in http://www.ietf.org/rfc/bcp/bcp47.txt section 2.2.1 (Language), section 2.2.4 (Region) and Appendix A (examples for language-region). If you do not want to set the language for the entire page, you can tell unblu explicitly what locale to use. To do so, add the (custom) attribute unblu_locale to the html tag as follows:

<html unblu_locale="en-US">

(Most content management systems will let you add this attribute to all pages with little effort.)

Using a JavaScript Function Call

You can also use a JavaScript function call to set the locale, as follows:

unblu.setLocale(language-code)

Note that you have to call the function after the snippet, but before the page is rendered. If at all possible, we recommend that you place the call immediately after the snippet.

Languages and Regions

The language code follows the IETF convention for language codes, so the following calls set the locales for English, US-English, and German as spoken in Germany:

unblu.setLocale("en")
unblu.setLocale("en-US")
unblu.setLocale("de-DE")`

To set languages in the Agent Desk see:

Agent Desk - Text

Agent Desk - Settings

Agent Desk - Settings in Advanced Mode

Agent Desk - Inheritance Troubleshooting Tips

Agent Desk - Managing the Queue: Filtering

  • deployonprem

results matching ""

    No results matching ""