No exemplo anterior de manifest.json, vimos que certos parâmetros exigem valores no formato widget.name, widget.description, advanced.title. Esses valores são necessários se o widget for projetado para suportar vários idiomas.

Nesses casos, você precisa criar arquivos de localização para cada idioma suportado. A Kommo atualmente suporta os idiomas Inglês, Espanhol, Português, Turco e Indonésio, os arquivos devem ser nomeados como en.json, es.json, pt.json, tr.json e id.json respectivamente. Esses arquivos devem ser colocados na pasta i18n. Dependendo do idioma da conta, as mensagens serão exibidas no idioma apropriado tanto para a interface (UI/UX) quanto para o backend.

👉

Se você estiver usando duas localizações, ambos os arquivos i18n devem ter a mesma estrutura.

Exemplos

i18n/en.json

{
    "widget":{
        "name":"My Widget",
        "short_description":"Short description",
        "description":"Full description",
        "tour_description":"Tour description"
    },
    "settings":{
        "login":"User login",
        "api_key":"API key",
        "account":"Account"
    }
}

i18n/pt.json

{
    "widget":{
		"name":"Meu Widget",
        "short_description":"Descrição curta",
        "description":"Descrição completa",
        "tour_description":"Descrição do Tour"
    },
    "settings":{
        "login":"Conecte-se",
        "api_key":"Chave API",
        "account":"Conta"
    }
}

Essas localizações aparecerão nas configurações da janela modal de integração nos dois idiomas.

Além disso, os arquivos de localização são usados na parte JavaScript do widget. Para extrair um objeto dos arquivos de idioma, você deve usar self.i18n('key'), onde ‘key’ é o nome do objeto que você deseja extrair e seu valor está presente no arquivo de localização.

Por exemplo, se você quiser obter o nome do widget no JS, pode usar self.i18n('widget').name.

Você pode encontrar mais informações sobre esse método em script.js da seção Widget.