How to add new language?

In order to install new translation you have to download lhc from github or just click this link. Archive contains two folders:

  1. lhc_dc - contains desktop client
  2. lhc_web - contains desktop client

You now can make translations directly on https://www.transifex.com/projects/p/live-helper-chat/

I constantly update live helper chat translations based on transifex updates. So the easiest way to have a new language just translate it there and I will add it automatically to live helper chat.

How configure Live Helper Chat header detection languages?

Recent version already have it configured but if you want to play around see. In

System configuration -> Speech

You can find few usefull links

  • Languages - it's all defined languages in Live Helper Chat. Where each language can be mapped to a specific siteaccess.
  • Dialects - dialects is basically a short code for a langauge. When we do language detection from browser we are looking to match one of these.

Installing translations for web client.

Let say we are installing Russian language, the workflow would be the following.

  1. Add siteaccess
'available_site_access' =>
      array (
        0 => 'eng',
        1 => 'lit',
        2 => 'hrv',
        3 => 'esp',
        4 => 'por',
        5 => 'nld',
        6 => 'site_admin',
      ),

Change to

'available_site_access' =>
      array (
        0 => 'eng',
        1 => 'lit',
        2 => 'hrv',
        3 => 'esp',
        4 => 'por',
        5 => 'nld',
        6 => 'rus',
        7 => 'site_admin',
 ),

Now you have to add new siteaccess. It will be similar to the one you see bellow

'site_access_options' =>
    array (
      'eng' =>
      array (
        'locale' => 'en_EN',
        'content_language' => 'en',
        'default_url' =>
        array (
          'module' => 'chat',
          'view' => 'startchat',
        ),
        'theme' =>
        array (
          0 => 'customtheme',
          1 => 'defaulttheme',
        ),
      ),

Our new siteaccess description will look like:

'site_access_options' =>
    array (
      'rus' =>
      array (
        'locale' => 'ru_RU',
        'content_language' => 'ru',
        'default_url' =>
        array (
          'module' => 'chat',
          'view' => 'startchat',
        ),
        'theme' =>
        array (
          0 => 'customtheme',
          1 => 'defaulttheme',
        ),
      ),

Now let say you want to change site_admin (our back office language). You just have to change

'site_admin' =>
      array (
        'locale' => 'ru_RU',
        'content_language' => 'ru',
        'theme' =>
        array (
          0 => 'customtheme',
          1 => 'defaulttheme',
        ),
        'login_pagelayout' => 'login',
        'default_url' =>
        array (
          'module' => 'front',
          'view' => 'default',
        ),
      ),

That's all.

Installing translations for desktop client.

Now you have to enter "dc" folder and copy two files to desktop client "translations" folder. Then you have to edit "settings.xml" file and edit <language>en</language> variable.

To compile desktop client translation you have to use QT Linquist application. It can be downloaded from:
https://code.google.com/p/qtlinguistdownload/downloads/list

Recomendation for languages translations

  • English (en_EN) - it's default system language and no translations file is needed.
  • Lithuanian (lt_LT) - it's my native language :), so I make translations to this language.
  • Danish - (da_DA) (Based on google translations)
  • German - (de_DE) (Based on google translations)
  • Spanish - (es_ES) (Based on google translations)
  • French - (fr_FR) (Based on google translations)
  • Indian - (hi_HI) (Based on google translations)
  • Italian - (it_IT) (Based on google translations)
  • Japan - (ja_JA) (Based on google translations)
  • Norwegian - (no_NO) (Based on google translations)
  • Portugal - (pt_PT) (Based on google translations)
  • Russian - (ru_RU) (Based on google translations)
  • Czech - (cs_CS) (Based on google translations)
  • Croatia - (hr_HR) (Based on google translations)
  • Icelandic - (is_IS) (Based on google translations)
  • Finnish - (fi_FI) (Based on google translations)
  • Romanian - (ro_RO) (Based on google translations)
  • Swedish - (sv_SV) (Based on google translations)
  • Belarusian - (be_BE) (Based on google translations)
  • Ukrainian - (uk_UK) (Based on google translations)
  • Turkish - (tr_TR) (Based on google translations)
  • Polish - (pl_PL) (Based on google translations)

I have updated translation file but still I see untranslated text?

  • Clear cache in back office.
  • If you are updating widget text also disable network cache in chrome to be sure new content is delivered.

How to switch from LTR to RTL language, how to add RTL language?

Since 1.30v we have support for full RTL language.

Section example

'lit' =>
array (
'locale' => 'lt_LT',
'content_language' => 'lt',
'dir_language' => 'ltr',
'title' => '',
'description' => '',
'theme' =>
array (
0 => 'customtheme',
1 => 'defaulttheme',
),
'default_url' =>
array (
'module' => 'chat',
'view' => 'startchat',
),
),

So if you want that it would be RTL just write RTL instead of LTR

Languages which may require RTL support. We do not have at the moment translated any of these languages. But now you can be sure, that it will work 100% with Live Helper Chat

  • Arabic: ar
  • Chinese: zh
  • Farsi: fa
  • Hebrew: he, iw
  • Japanese: ja
  • Urdu: ur
  • Yiddish: yi, ji

So if anyone will translate to any of these langauges, please send me translation.

Last updated on by Remigijus Kiminas