Lang

Lib for multi language support
introduction
It is important to understand:
Any bot can be translated
The bot consists of commands in which there are no untranslated places.
All commands are multilingual
There are no commands like /menuEn,  /menuFr, /menuRu. There is only one /menu command
All multilingual texts must be placed in each language files (command), for example, in lng-en, lng-ru. This will make them easier to translate.
everything can be translated: any text, answer, keyboard, inline keyboard, alert...
This is especially important for large bots
Getting started
First - need to setup languages. For example with /setup command:
var enLang = {
    user: { whatIsYourName: "What is your name?" },
    hello: "Hello!",
    onlyOnEnglish: "Only on english"
    keyboards: {
        mainMenu: { buttons: "Bonus, Friends", text: "menu" }
        bonusMenu: { buttons: "Get bonus, Back", text: "Get your bonus now" }
    }
}
​
var ruLang = {
    user: { whatIsYourName: "Как тебя зовут?" },
    hello: "Привет!",
    // not translated yet:
    // onlyOnEnglish: "Only on english"
    keyboards: {
        mainMenu: { buttons: "Бонус, Друзья", text: "меню"}
        bonusMenu: { buttons: "Получить бонус, Назад", text: "получи бонус"}
    }
}
​
// first language is default language
Libs.Lang.setup("en", enLang);  // english is default now
Libs.Lang.setup("ru", ruLang);
Now default language is "english".
You can use lib now (for example, in command /test):
var lang = Libs.Lang;
// send messages on default language
Bot.sendMessage(lang.t("hello"))   // Hello!
Bot.sendMessage(lang.t("user.whatIsYourName"))  // What is your name?
​
Bot.sendMessage(lang.t("onlyOnEnglish")) // "Only on english"
// Default language text always is used
//  for non translated keys yet
​
​
// send keyboard for Main menu:
Bot.sendKeyboard(
  lang.t("keyboards.mainMenu.buttons"),
  lang.t("keyboards.mainMenu.text")
)
​
// or send Bonus menu:
Bot.sendKeyboard(
  lang.t("keyboards.bonusMenu.buttons"),
  lang.t("keyboards.bonusMenu.text")
)
How to use
Change user lang
Libs.Lang.user.setLang("ru")
You can get user language code. For example in /start:
// in /start command
var lang_code = request.from.language_code;
Libs.Lang.user.setLang(lang_code)
Get cur lang
var lang = Libs.Lang.user.getLang()
Change default lang
Libs.Lang.default.setLang("en")
var default = Libs.Lang.default.getCurLang()
Tips. Also you can use multi lang command. This is not recommended but sometimes a good solution
In BJS for command /hello:
Bot.runCommand("/hello_" + Libs.Lang.user.getLang())
Also you can use 
Libs.Lang.t("translation-key", "ru") 
for non user actions: in webhooks and etc
Get translation by language code
Sometimes we do not have user object. For example, on income webhooks or with Bot.runAll command and etc. Therefore, we cannot determine the current language.
The following code might be helpful in such cases.
// command /test
// you can pass language code in params
var lng = params;
// or in options with Bot.run(command: "/test", options: {lngCode: "fr"} )
var lng = options.lngCode
​
// So now:
// lng = "fr"
​
Bot.sendMessage(
    Libs.Lang.t("hello", lng)
)   // Привет!
​
Get all language json
// get all json for default language:
Bot.sendMessage(Libs.Lang.get())
​
// get all json for "ru":
Bot.sendMessage(Libs.Lang.get("ru"))
​
Using aliases
You can set aliases for language.
For /setup
var enLang = {
    aliases: {
       // Command /start have aliases:
       //       home, dashboard and /main:
       "home, dashboard, /main": "/start",
       
       // command /otherCommand have aliases:
       //       alias1, alias2
       "alias1,alias2": "/otherCommand"
    }
    user: { whatIsYourName: "What is your name?" },
}
​
Libs.Lang.setup("en", enLang);
For Master command * :
// find multilanguage aliases
var cmd = Libs.Lang.getCommandByAlias(message);
if(cmd){ Bot.run({ command: cmd }) }
​
// also it is possible define language
// var cmd = Libs.Lang.getCommandByAlias(message, "ru");
// if(cmd){ Bot.run({ command: cmd }) }
 
Good practices
Use different language files (command) for each language.
For example "lng-en.js", "lng-fr.js" and etc. So it's easier to translate. 
In /setup you can make something like this:
var languages = ["en", "es", "cn", "ru"];
var cmdName;
​
for(var i in languages){
    cmdName = "lng-" + languages[i].code;
    Bot.run({ command: cmdName })
}
​
Bot.sendMessage("Multi Languages - installed");
Make a simple command based structure
var enLang = {
    command1: {
      text: "your text",
      // keys
      ...
      }
      ...
    }
    command2: {
      text: "your text"
      // keys,
      ...
    }
    // bot menus
    menus: {
      mainMenu: {
        keyboard: 
        text: 
      },
      helpMenu: {
        keyboad:
        text: 
      }
    },
    // common links
    links: {
      homePage: "<a href='example.com'>Home page</a>",
    },
    alert: {
      error: "sorry, we have error"
    }
    ...
}
​
Libs.Lang.setup("en", enLang);
Make translation for text and keyboard:
var enLang = {
    command1: {
       text: "Please confirm",
       keyboard: "Yes, Cancel",
       
       // you can also attach Inline keyboard:
       inlineKeyboard: {
         buttons: [ 
           {title: "google", url: "http://google.com" },
           {title: "other command", command: "/othercommand"}
          ],
          text: "Please make a choice."
        }
    }
    //...
}
​
Libs.Lang.setup("en", enLang);
So in /command1 you can make:
Bot.sendKeyboard(
   Libs.Lang.t("command1.keyboard"),
   Libs.Lang.t("command1.text"),
)
​
// send inline keyboard:
Bot.sendInlineKeyboard(
   Libs.Lang.t("command1.inlineKeyboard.buttons"),
   Libs.Lang.t("command1.inlineKeyboard.text"),
)
Use aliases translations
See this​
​
Libs - Previous
ResourcesLib
Next - Libs
QiwiPayments
Last updated 10 months ago