levis/help365
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

update
All checks were successful
Deploy Static Site / deploy (push) Successful in 6m6s
Details

Browse Source
This commit is contained in:
koziavin
2025-05-29 16:42:45 +04:00
parent e217f89702
commit 00717a92fb
2681 changed files with 173810 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

320
platform/set-new-locale.html Normal file
View File

@ -0,0 +1,320 @@
<!DOCTYPE html>
<html lang="en">
<head>
<title>Install a new locale</title>
<meta name="generator" content="Help+Manual" />
<meta name="keywords" content="" />
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="In BRIX, you can change the interface language in the locale settings and the user profile. You can use one of the supported languages. If your company or some of its users..." />
<meta name="picture" content="" />
<meta property="og:type" content="website" />
<meta property="og:title" content="Full documentation for BRIX365 platform. Low-code developer guide. User guide. Admin guide. Developer guide." />
<meta property="og:url" content="https://brix365.com/en/help" />
<meta property="og:image" content="" />
<link rel="icon" href="favicon.png" type="image/png" />
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet" />
<link rel="stylesheet" href="./jquery-ui.min.css" />
<link rel="stylesheet" href="default.css" />
<link rel="stylesheet" href="./search-yandex.css" />
<link rel="stylesheet" href="./article.css" />
<link rel="stylesheet" href="./glossary.css" />
<link rel="stylesheet" href="./theme.css" />
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="helpman_settings.js"></script>
<script type="text/javascript" src="helpman_topicinit.js"></script>
<script type="text/javascript" src="highlight.js"></script>
<script type="text/javascript">
$(document).ready(function(){highlight();});
</script>
</head>
<body>
<script>!function(e,t,c,n,r,a,m){e.ym=e.ym||function(){(e.ym.a=e.ym.a||[]).push(arguments)},e.ym.l=1*new Date;for(var s=0;s<document.scripts.length;s++)if(document.scripts[s].src===n)return;a=t.createElement(c),m=t.getElementsByTagName(c)[0],a.async=1,a.src=n,m.parentNode.insertBefore(a,m)}(window,document,"script","https://mc.yandex.ru/metrika/tag.js"),ym(83179930,"init",{clickmap:!0,trackLinks:!0,accurateTrackBounce:!0,webvisor:!0})</script><noscript><div><img alt=""src=https://mc.yandex.ru/watch/83179930 style=position:absolute;left:-9999px></div></noscript>
<header class="header elma-365">
<div class="container">
<a class="header__logo" href="https://brix365.com/en/help">
<img src="./logo-en.svg" alt="header logo">
</a>
<!-- <div class="hero__search-form" id="search-panel">
<form class="search-form" onsubmit="ym(83180416,'reachGoal','poisk')">
<label class="search-form__label">
<span id="reset-search" class="search__icon"></span>
<input class="search-form__input" type="text">
</label>
<input class="search-form__submit" type="submit" value="Submit">
</form>
</div> -->
<div class="hero__search-form" id="search-panel"> <form class="search-form"> <label class="search-form__label"> <span id="reset-search" class="search__icon"></span> <input class="search-form__input" type="text"> </label> <input class="search-form__submit" type="submit" value="Submit"> </form> </div>
<div class="hero__search">
<a href="#" id="search-icon" class="hero__search-icon">
<img src="search-icon-white.svg" alt="search string">
</a>
<a href="#" id="side-menu-icon" class="hero__side-icon">
<img src="side_menu.svg" alt="side menu">
</a>
</div>
<div class="header__navi">
<ul class="header__list"><li><span class="solution-select"><span class="solution-select__selected"></span><svg width="7" height="4" viewBox="0 0 7 4" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M1 1L3.5 3.5L6 1" stroke="white" stroke-linecap="round" stroke-linejoin="round"/></svg><ul class="solution-select__list"><li><a class="project-link" href="https://brix365.com/en/help/platform/get-trial.html">Platform</a></li><li><a class="project-link" href="https://brix365.com/en/help/ecm/ecm-functions.html">ECM</a></li><li><a class="project-link" href="https://brix365.com/en/help/crm/crm_overview.html">CRM</a></li><li><a class="project-link" href="https://brix365.com/en/help/service/service-functions.html">Service</a></li><li><a class="project-link" href="https://brix365.com/en/help/projects/projects-functions.html">Projects</a></li><li><a class="project-link" href="https://brix365.com/en/help/business_solutions/-elma365-store.html">Business Solutions</a></li></ul></span></li><li><a href="https://api.brix365.com/en/" target="_blank">API</a></li><li><a href="https://tssdk.brix365.com/" target="_blank">SDK</a></li></ul>
</div>
</div>
</header>
<main class="main container">
<aside class="sidebar" id="sidebar">
<div class="sidebar__header">
<a class="header__logo" href="https://brix365.com/en/help">
<img src="./logo-light-en.svg">
</a>
<span class="sidebar__close elma-365-close" id="close"></span>
</div>
<div class="sidebar__wrapper" id="side-menu">
</div>
</aside>
<article class="article" id="article">
<div class="article-inner">
<div class="content">
<header class="article__header">
<div class="article__bread" style="display:flex; gap:10px;">
<span id="subcategory" class="search-res__item-category search-res__item-category_subcategory subcategory article__badge"></span>
<div class="topic__breadcrumbs">
<p>System settings / Install a new locale</p>
</div>
</div>
<div class="topic__title"><h1 class="p_Heading1"><span class="f_Heading1">Install a new locale</span></h1>
</div>
</header>
<section class="article__content">
<div class="scroll-top-inner">
<a href="#h1-article" class="scroll-top"></a>
</div>
<!-- Placeholder for topic body. -->
<p style="line-height: 1.20; margin: 7px 0 16px 0;"><span style="font-family: Inter;">In BRIX, you can change the interface language in the <a href="locale-settings.html#interface-language" class="topiclink">locale settings</a> and the <a href="360016398552.html" class="topiclink">user profile</a>. You can use one of the supported languages. If your company or some of its users require an interface language that is not available by default, you can install an additional locale. To do this:</span></p>
<ol style="list-style-type:decimal">
<li value="1" style="line-height: 1.28; margin-top: 0; margin-right: 0; margin-bottom: 11px;"><span style="font-family: Inter;">Create and install a module of the </span><span style="font-family: Inter; font-weight: bold;">Language package</span><span style="font-family: Inter;"> type for the new locale.</span></li><li value="2" style="line-height: 1.28; margin-top: 0; margin-right: 0; margin-bottom: 11px;"><span style="font-family: Inter;"><a href="set-new-locale.html#translate-configuration" class="topiclink">Translate the custom configuration</a> and built-in workspaces.</span></li><li value="3" style="line-height: 1.28; margin-top: 0; margin-right: 0; margin-bottom: 11px;"><span style="font-family: Inter;"><a href="set-new-locale.html#check-locale" class="topiclink">Perform a check</a> of the new locale.</span></li></ol>
<p style="line-height: 1.28; margin: 0 0 11px 0;"><span style="font-family: Inter;">If you want to change standard translations for default languages, follow the same procedure as for a new locale.</span></p>
<h2 class="p_Heading2"><span class="f_Heading2">Create and install a language package</span></h2>
<ol style="list-style-type:upper-roman">
<li value="1" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">Submit a request for a new locale to technical support.</span></li></ol>
<p style="line-height: 1.20; margin: 7px 0 16px 0;"><span style="font-family: Inter;">The specialist forwards your request to the developer and provides you with:</span></p>
<ul style="list-style-type:disc">
<li style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">A list of </span><span style="font-family: Inter; font-weight: bold;">.po</span><span style="font-family: Inter;"> files with resources for translation.</span></li><li style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">A utility with instructions to create a </span><span style="font-family: Inter; font-weight: bold;">Language package</span><span style="font-family: Inter;"> type module for the target locale from these files.</span></li></ul>
<ol style="list-style-type:upper-roman">
<li value="2" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">Translate the received </span><span style="font-family: Inter; font-weight: bold;">.po</span><span style="font-family: Inter;"> files using a specialized program, for example, <a href="https://poedit.net/" target="_blank" class="weblink">Poedit</a>.</span></li><li value="3" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">Create a </span><span style="font-family: Inter; font-weight: bold;">Language package</span><span style="font-family: Inter;"> type module in the form of a </span><span style="font-family: Inter; font-weight: bold;">.e365</span><span style="font-family: Inter;"> file by running the utility as per the instructions.</span></li><li value="4" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">Check the proper functioning of the module.</span></li><li value="5" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;"><a href="import_extension.html" class="topiclink">Install the module</a>. If it contains incorrectly translated data, an error will occur during installation. In this case, <a href="set-new-locale.html#check-locale" class="topiclink">check the translation</a> in the </span><span style="font-family: Inter; font-weight: bold;">.po</span><span style="font-family: Inter;"> files using a specialized program, such as Poedit.</span></li><li value="6" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">Enable the module.</span></li></ol>
<p style="line-height: 1.28; margin: 0 0 11px 0;"><img alt="set-new-locale-1" width="980" height="515" style="margin:0;width:980px;height:515px;border:none" src="set-new-locale-1.png"/></p>
<p style="line-height: 1.20; margin: 7px 0 16px 0;"><span style="font-family: Inter;">Afterwards, in the company settings and in the user profile, it will be possible to switch the interface language to the new one. The name and code of the new language are set according to the module.</span></p>
<p style="line-height: 1.20; margin: 7px 0 16px 0;"><span style="font-family: Inter;">If the new locale is only needed for specific users, you don’t need to change the language in company settings.</span></p>
<ol style="list-style-type:upper-roman" start="7">
<li value="7" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">If you wish to update the locale, perform the steps indicated above again. New resources appear after each system update. Obtain </span><span style="font-family: Inter; font-weight: bold;">.po</span><span style="font-family: Inter;"> files with new resources, add them to the module, and install it. Only one module per language can be used in the system, so the previously installed language package for the target locale will be replaced with the new one.</span></li><li value="8" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">After installing the locale, you can begin translating the user configuration. By default, the translation function is unavailable. Contact BRIX support to activate this option.</span></li></ol>
<p style="line-height: 1.20; margin: 7px 0 16px 0;"><span style="font-family: Inter;">Please note that the built-in workspaces, such as </span><span style="font-family: Inter; font-weight: bold;">CRM</span><span style="font-family: Inter;">, </span><span style="font-family: Inter; font-weight: bold;">Marketing</span><span style="font-family: Inter;">, </span><span style="font-family: Inter; font-weight: bold;">Live Chats</span><span style="font-family: Inter;">, </span><span style="font-family: Inter; font-weight: bold;">Projects</span><span style="font-family: Inter;">, and </span><span style="font-family: Inter; font-weight: bold;">System apps</span><span style="font-family: Inter;"> are not translated within a module. For a new locale, translate them in the same way as the custom configuration.</span></p>
<h2 class="p_Heading2"><a id="translate-configuration" class="hmanchor"></a><span class="f_Heading2">Translate a custom configuration</span></h2>
<p style="line-height: 1.20; margin: 7px 0 16px 0;"><span style="font-family: Inter;">Custom <a href="extentions.html" class="topiclink">modules</a>, <a href="360006887271.html" class="topiclink">workspaces</a>, apps, pages, <a href="user_widgets.html" class="topiclink">widgets</a>, and business processes are translated via resource export.</span></p>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">начало&nbsp;внимание</span></p>
<p style="line-height: 1.20; margin: 7px 0 16px 0;"><span style="font-family: Inter;">The configuration translation isn’t available by default. To activate this option, please contact BRIX technical support. If the translation function is enabled, the </span><span style="font-family: Inter; font-weight: bold;">Translations</span><span style="font-family: Inter;"> option will appear in the settings of workspaces and custom modules.</span></p>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">конец&nbsp;внимание</span></p>
<p style="line-height: 1.20; margin: 7px 0 16px 0;"><span style="font-family: Inter;">To add resource translations, follow these steps:</span></p>
<ol style="list-style-type:upper-roman">
<li value="1" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">Open the </span><span style="font-family: Inter; font-weight: bold;">Translations</span><span style="font-family: Inter;"> page in the system component settings:</span></li></ol>
<ul style="list-style-type:disc">
<li style="line-height: 1.28; margin-top: 0; margin-right: 0; margin-bottom: 11px;"><span style="font-family: Inter;">For custom modules, go to </span><span style="font-family: Inter; font-weight: bold;">Administration &gt; Modules</span><span style="font-family: Inter;">, select the desired module, click </span><span style="font-family: Inter; font-weight: bold;">Settings</span><span style="font-family: Inter;">, and then open the </span><span style="font-family: Inter; font-weight: bold;">Translations </span><span style="font-family: Inter;">tab.</span></li></ul>
<p style="line-height: 1.28; margin: 0 0 11px 34px;"><img alt="set-new-locale-2" width="1472" height="737" style="margin:0;width:1472px;height:737px;border:none" src="set-new-locale-2.png"/></p>
<ul style="list-style-type:disc">
<li style="line-height: 1.28; margin-top: 0; margin-right: 0; margin-bottom: 11px;"><span style="font-family: Inter;">For custom workspaces, navigate to the workspace page, click the gear icon next to its name, and select </span><span style="font-family: Inter; font-weight: bold;">Translations</span><span style="font-family: Inter;">.</span></li></ul>
<p style="line-height: 1.28; margin: 0 0 11px 34px;"><img alt="set-new-locale-3" width="359" height="462" style="margin:0;width:359px;height:462px;border:none" src="set-new-locale-3.png"/></p>
<p style="line-height: 1.20; margin: 7px 0 16px 34px;"><span style="font-family: Inter;">Actions described further are the same for translating resources of modules and workspaces.</span></p>
<ol style="list-style-type:upper-roman" start="2">
<li value="2" style="line-height: 1.28; margin-top: 0; margin-right: 0; margin-bottom: 11px;"><span style="font-family: Inter;">Download a file with the resources of the current workspace or module to your PC. To do this, in the upper right corner of the </span><span style="font-family: Inter; font-weight: bold;">Translations</span><span style="font-family: Inter;"> page, click the </span><span style="font-family: Inter; font-weight: bold;">Generate .po File</span><span style="font-family: Inter;"> button.</span></li></ol>
<p style="line-height: 1.28; margin: 0 0 11px 34px;"><img alt="set-new-locale-4" width="1048" height="433" style="margin:0;width:1048px;height:433px;border:none" src="set-new-locale-4.png"/></p>
<ol style="list-style-type:upper-roman" start="3">
<li value="3" style="line-height: 1.28; margin-top: 0; margin-right: 0; margin-bottom: 11px;"><a id="file-name" class="hmanchor"></a><span style="font-family: Inter;">Save the </span><span style="font-family: Inter; font-weight: bold;">.po</span><span style="font-family: Inter;"> file and rename it by the following template: </span><span style="font-family: Inter; font-weight: bold;">{target locale code}.po</span><span style="font-family: Inter;">. For example:</span></li></ol>
<ul style="list-style-type:circle">
<li style="line-height: 1.28; margin-top: 0; margin-right: 0; margin-bottom: 11px;"><span style="font-family: Inter; font-weight: bold;">en-US.po</span><span style="font-family: Inter;"> for English (United States).</span></li><li style="line-height: 1.28; margin-top: 0; margin-right: 0; margin-bottom: 11px;"><span style="font-family: Inter; font-weight: bold;">en-UK.po</span><span style="font-family: Inter;"> for English (United Kingdom).</span></li><li style="line-height: 1.28; margin-top: 0; margin-right: 0; margin-bottom: 11px;"><span style="font-family: Inter; font-weight: bold;">tr-TR.po</span><span style="font-family: Inter;"> for Turkish (Turkey).</span></li></ul>
<p style="line-height: 1.20; margin: 0 0 11px 0;"><span style="font-family: Inter;">The </span><span style="font-family: Inter; font-weight: bold;">.po</span><span style="font-family: Inter;"> file includes a list of the workspace’s original resources (</span><code><b>msgid</b></code><span style="font-family: Inter;">) and empty strings for their translation (</span><code><b>msgstr</b></code><span style="font-family: Inter;">). For example:</span></p>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">msgid&nbsp;&quot;My&nbsp;legal&nbsp;entities&quot;</span><br />
<span class="f_CodeExample">msgstr&nbsp;&quot;&quot;</span><br />
<span class="f_CodeExample">&nbsp;</span><br />
<span class="f_CodeExample">msgid&nbsp;&quot;Legal&nbsp;entity&quot;</span><br />
<span class="f_CodeExample">msgstr&nbsp;&quot;&quot;</span><br />
<span class="f_CodeExample">&nbsp;</span><br />
<span class="f_CodeExample">msgid&nbsp;&quot;Name&quot;</span><br />
<span class="f_CodeExample">msgstr&nbsp;&quot;&quot;</span><br />
<span class="f_CodeExample">&nbsp;</span><br />
<span class="f_CodeExample">msgid&nbsp;&quot;Full&nbsp;name&quot;</span><br />
<span class="f_CodeExample">msgstr&nbsp;&quot;&quot;</span><br />
<span class="f_CodeExample">&nbsp;</span><br />
<span class="f_CodeExample">msgid&nbsp;&quot;Legal&nbsp;address&quot;</span><br />
<span class="f_CodeExample">msgstr&nbsp;&quot;&quot;</span><br />
<span class="f_CodeExample">&nbsp;</span><br />
<span class="f_CodeExample">msgid&nbsp;&quot;Actual&nbsp;address&quot;</span><br />
<span class="f_CodeExample">msgstr&nbsp;&quot;&quot;</span></p>
<p style="line-height: 1.28; margin: 0 0 11px 0;"><span style="font-size: 13px; color: #000000;">&nbsp;</span></p>
<ol style="list-style-type:upper-roman" start="4">
<li value="4" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 7px;"><span style="font-family: Inter;">Open the downloaded </span><span style="font-family: Inter; font-weight: bold;">.po</span><span style="font-family: Inter;"> file using a translation program, for example, <a href="https://poedit.net/" target="_blank" class="weblink">Poedit</a>. Translate the resources by filling in the empty strings in the file.</span></li></ol>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">начало&nbsp;внимание</span></p>
<p style="line-height: 1.28; margin: 0 0 11px 0;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">Translate resources in a specialized program to avoid possible <a href="set-new-locale.html#check-locale" class="topiclink">errors</a>.</span></p>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">конец&nbsp;внимание</span></p>
<p style="line-height: 1.28; margin: 0 0 11px 0;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">We recommend saving </span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif; font-weight: bold;">.po</span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;"> files with completed translations locally on your PC. They may be useful in case of data loss, for example, after updating system workspaces.</span></p>
<ol style="list-style-type:upper-roman" start="5">
<li value="5" style="line-height: 1.28; margin-top: 0; margin-right: 0; margin-bottom: 11px;"><span style="font-family: Inter;">Upload the translation file back to the workspace or module. To do this, on the </span><span style="font-family: Inter; font-weight: bold;">Translations</span><span style="font-family: Inter;"> page, click </span><span style="font-family: Inter; font-weight: bold;">+File</span><span style="font-family: Inter;">. Note that if the <a href="set-new-locale.html#file-name" class="topiclink">file name</a> does not correspond with the locale code, an error will occur.</span></li></ol>
<p style="line-height: 1.28; margin: 0 0 11px 0;"><img alt="set-new-locale-5" width="1179" height="569" style="margin:0;width:1179px;height:569px;border:none" src="set-new-locale-5.png"/></p>
<p style="line-height: 1.20; margin: 7px 0 16px 0;"><span style="font-family: Inter;">The translation will automatically apply if the user selects the corresponding interface language in the settings.</span></p>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">начало&nbsp;внимание</span></p>
<p style="line-height: 1.28; margin: 0 0 11px 0;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">All functions of the </span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif; font-weight: bold;">Administration</span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;"> workspace are available only in the original language of the interface used when creating the company. To work in this workspace, the administrator needs to change the language to the original one in their profile.</span></p>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">конец&nbsp;внимание</span></p>
<ol style="list-style-type:upper-roman" start="6">
<li value="6" style="line-height: 1.28; margin-top: 0; margin-right: 0; margin-bottom: 11px;"><span style="font-family: Inter;">In this way, create and upload </span><span style="font-family: Inter; font-weight: bold;">.po</span><span style="font-family: Inter;"> files for each locale used in your company.</span></li></ol>
<h3 class="p_Heading3"><span class="f_Heading3">Translation in scripts</span></h3>
<p style="line-height: 1.28; margin: 0 0 11px 0;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">In custom scripts, including scripts in the <a href="code_widget.html" class="topiclink">Code</a> widget, use the </span><code><b>SR</b></code><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;"> object for translation with the method </span><code><b>T(str:&nbsp;string):&nbsp;string</b></code><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">.</span></p>
<p style="line-height: 1.28; margin: 0 0 11px 0;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">Then, the string specified in the method will be added to the </span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif; font-weight: bold;">.po</span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;"> file of the section or module. Next, add the translation of this string to the </span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif; font-weight: bold;">.po</span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;"> file and upload the file with the target locale back to the workspace or module. If the user changes the locale in their profile settings afterward, the string will be translated to the value specified in the </span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif; font-weight: bold;">.po</span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;"> file.</span></p>
<p style="line-height: 1.28; margin: 0 0 11px 0;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">Example of a script in the </span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif; font-weight: bold;">Code</span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;"> widget using the translation function:</span></p>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">&lt;</span><span class="f_CodeExample">%&nbsp;</span><span class="f_CodeExample" style="font-weight: bold;">if</span><span class="f_CodeExample">&nbsp;(</span><span class="f_CodeExample" style="font-weight: bold;">true</span><span class="f_CodeExample">)&nbsp;{&nbsp;%&gt;</span><br />
<span class="f_CodeExample">You&nbsp;can&nbsp;</span><span class="f_CodeExample" style="font-weight: bold;">delete&nbsp;this</span><span class="f_CodeExample">&nbsp;block&nbsp;after&nbsp;reading.</span><br />
<span class="f_CodeExample">&lt;br&gt;</span><br />
<span class="f_CodeExample">&nbsp;</span><br />
<span class="f_CodeExample">/*&nbsp;SR.T('comment')&nbsp;*/</span><br />
<span class="f_CodeExample">String&nbsp;translation:&nbsp;&lt;%=&nbsp;SR.T('string&nbsp;1')&nbsp;%&gt;</span><br />
<span class="f_CodeExample">&lt;%&nbsp;}&nbsp;%&gt;</span></p>
<p style="line-height: 1.28; margin: 0 0 11px 0;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">The </span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif; font-weight: bold;">.po</span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;"> file will include the value </span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif; font-weight: bold;">string 1</span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">.</span></p>
<h2 class="p_Heading2"><a id="check-locale" class="hmanchor"></a><span class="f_Heading2">Check the new locale</span></h2>
<p style="line-height: 1.28; margin: 0 0 11px 0;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">If the locale is installed incorrectly, you will encounter errors such as an empty interface in workspaces, page loading issues, etc. To avoid this, perform a check. It is recommended to use incognito mode or a different browser for this purpose.</span></p>
<ol style="list-style-type:decimal">
<li value="1" style="line-height: 1.28; margin-top: 0; margin-right: 0; margin-bottom: 11px;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">Ensure that in the settings of workspaces and modules:</span><ul style="list-style-type:circle">
<li style="line-height: 1.28; margin-top: 0; margin-right: 0; margin-bottom: 11px;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">The </span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif; font-weight: bold;">Translations</span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;"> page contains correct </span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif; font-weight: bold;">.po</span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;"> files with resource translations.</span></li><li style="line-height: 1.28; margin-top: 0; margin-right: 0; margin-bottom: 11px;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">The original interface language on which the <a href="360006965372.html#section-settings" class="topiclink">workspace</a> or <a href="create-extention.html#main-tab" class="topiclink">module</a> was created is set.</span></li></ul></li></ol>
<p style="line-height: 1.28; margin: 0 0 11px 36px;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">If you have imported a workspace or module from another company, check that its settings indicate the original interface language. By setting the original language before exporting, after importing into the target company, you will see it indicated by default in the settings.</span></p>
<ol style="list-style-type:decimal" start="2">
<li value="2" style="line-height: 1.28; margin-top: 0; margin-right: 0; margin-bottom: 11px;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">Verify that the new language is available for selection in the user profile settings.</span></li><li value="3" style="line-height: 1.28; margin-top: 0; margin-right: 0; margin-bottom: 11px;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">Set the new language in your profile and check the translation in workspaces.</span></li></ol>
<h3 class="p_Heading3"><span class="f_Heading3">Errors in locale installation and their causes</span></h3>
<ol style="list-style-type:upper-roman">
<li value="1" style="line-height: 1.28; margin-top: 0; margin-right: 0; margin-bottom: 11px;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">Error: After a user changes the language in their profile, the page does not load. The error text in the console refers to the language package.</span></li></ol>
<p style="line-height: 1.28; margin: 0 0 11px 0;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">Standard reason for this error: The original language is not set in the workspace settings.</span></p>
<ol style="list-style-type:upper-roman" start="2">
<li value="2" style="line-height: 1.28; margin-top: 0; margin-right: 0; margin-bottom: 11px;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">Error: Empty workspace interface, the page hangs.</span></li></ol>
<p><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">This may be caused by invalid translation of resources in the </span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif; font-weight: bold;">.po</span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;"> file. To avoid this, translate </span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif; font-weight: bold;">.po</span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;"> files using a specialized program, such as <a href="https://poedit.net/" target="_blank" class="weblink">Poedit</a>. Correct incorrect translations in this program as well.</span></p>
<p><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">Example of a </span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif; font-weight: bold;">.po</span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;"> file with errors, opened in Poedit:</span></p>
<p class="p_Normal"><img alt="set-new-locale-6" width="706" height="318" style="margin:0;width:706px;height:318px;border:none" src="set-new-locale-6.png"/></p>
<ol style="list-style-type:upper-roman" start="3">
<li value="3" style="line-height: 1.28; margin-top: 0; margin-right: 0; margin-bottom: 11px;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">Code formatting error in the </span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif; font-weight: bold;">.po</span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;"> file.</span></li></ol>
<p style="line-height: 1.28; margin: 0 0 11px 0;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">This can be caused by incorrect use of double quotes. Follow these rules for their formatting:</span></p>
<ol style="list-style-type:decimal">
<li value="1" style="line-height: 1.28; margin-top: 0; margin-right: 0; margin-bottom: 11px;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">Double quotes can only be at the beginning and end of each translation string.</span></li></ol>
<p style="line-height: 1.28; margin: 0 0 11px 0;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">Example of code with an error:</span></p>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">msgid&quot;&quot;</span><br />
<span class="f_CodeExample">&quot;text1\n&quot;</span><br />
<span class="f_CodeExample">&quot;text2\n&quot;</span><br />
<span class="f_CodeExample">msgstr&quot;&quot;translation1\n&quot;translation2\n&quot;</span></p>
<p style="line-height: 1.28; margin: 0 0 11px 0;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">Example of correct code 1:</span></p>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">msgid&quot;&quot;</span><br />
<span class="f_CodeExample">&quot;text1\n&quot;</span><br />
<span class="f_CodeExample">&quot;text2\n&quot;</span><br />
<span class="f_CodeExample">msgstr&quot;translation1\ntranslation2\n&quot;</span></p>
<p style="line-height: 1.28; margin: 0 0 11px 0;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">Example of correct code 2:</span></p>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">msgid&quot;&quot;</span><br />
<span class="f_CodeExample">&quot;text1\n&quot;</span><br />
<span class="f_CodeExample">&quot;text2\n&quot;</span><br />
<span class="f_CodeExample">msgstr&quot;&quot;</span><br />
<span class="f_CodeExample">&quot;translation1\n&quot;</span><br />
<span class="f_CodeExample">&quot;translation2\n&quot;</span></p>
<ol style="list-style-type:decimal" start="2">
<li value="2" style="line-height: 1.28; margin-top: 0; margin-right: 0; margin-bottom: 11px;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">If double quotes are needed within the translation, they must be escaped with the </span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif; font-weight: bold;">\</span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;"> character, for example:</span></li></ol>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">msgstr&nbsp;&quot;Add&nbsp;the&nbsp;\&quot;Start\&quot;&nbsp;button&quot;;</span><br />
<span class="f_CodeExample">msgstr&nbsp;&quot;Value&nbsp;=&nbsp;\&quot;1\&quot;&quot;</span></p>
<p style="line-height: 1.28; margin: 0 0 11px 0;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">Other details of code formatting in the </span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif; font-weight: bold;">.po</span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;"> file:</span></p>
<ul style="list-style-type:disc">
<li style="line-height: 1.28; margin-top: 0; margin-right: 0; margin-bottom: 11px;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">If the value of the </span><code><b>msgstr</b></code><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;"> parameter is split into two lines, you can write it in one line. This will not cause an error.</span></li><li style="line-height: 1.28; margin-top: 0; margin-right: 0; margin-bottom: 11px;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">The value of the </span><code><b>msgid</b></code><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;"> parameter (translation key) cannot be changed. To avoid such errors as typos, extra spaces, case changes, etc., do not modify it. If these errors are present, the translation key may not be applied.</span></li><li style="line-height: 1.28; margin-top: 0; margin-right: 0; margin-bottom: 11px;"><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">If there are special characters in the translation, they also cannot be changed. In this case, translate only the words.</span></li></ul>
<h2 class="p_Heading2"><span class="f_Heading2">Complete translation after adding new components</span></h2>
<p style="line-height: 1.20; margin: 7px 0 16px 0;"><span style="font-family: Inter;">If you’ve made changes in a workspace, such as <a href="360007235031.html" class="topiclink">adding an app</a>, you should supplement the translations in all </span><span style="font-family: Inter; font-weight: bold;">.po</span><span style="font-family: Inter;"> files. To do this:</span></p>
<ol style="list-style-type:upper-roman">
<li value="1" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">In the settings of the workspace or module, navigate to the </span><span style="font-family: Inter; font-weight: bold;">Translations</span><span style="font-family: Inter;"> page.</span></li><li value="2" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">To the right of each file’s name, click on the three dots and select </span><span style="font-family: Inter; font-weight: bold;">Re-generate .po File</span><span style="font-family: Inter;">. New resources with empty translations will be added to the </span><span style="font-family: Inter; font-weight: bold;">.po</span><span style="font-family: Inter;"> files, while translations made earlier are retained.</span></li></ol>
<p style="line-height: 1.28; margin: 0 0 11px 34px;"><img alt="set-new-locale-7" width="889" height="330" style="margin:0;width:889px;height:330px;border:none" src="set-new-locale-7.png"/></p>
<ol style="list-style-type:upper-roman" start="3">
<li value="3" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 7px;"><span style="font-family: Inter;"> Download the </span><span style="font-family: Inter; font-weight: bold;">.po</span><span style="font-family: Inter;"> files to your PC and add &nbsp;the new translations using a specialized translation program, for example, Poedit.</span></li><li value="4" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 7px;"><span style="font-family: Inter;">Return to the BRIX interface and navigate to the </span><span style="font-family: Inter; font-weight: bold;">Translations</span><span style="font-family: Inter;"> page. Select the outdated files using the checkbox and delete them.</span></li></ol>
<p style="line-height: 1.28; margin: 0 0 11px 34px;"><img alt="set-new-locale-8" width="892" height="311" style="margin:0;width:892px;height:311px;border:none" src="set-new-locale-8.png"/></p>
<ol style="list-style-type:upper-roman" start="5">
<li value="5" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 7px;"><span style="font-family: Inter;">Click </span><span style="font-family: Inter; font-weight: bold;">+File</span><span style="font-family: Inter;"> and upload the new </span><span style="font-family: Inter; font-weight: bold;">.po</span><span style="font-family: Inter;"> files with full translation.</span></li></ol>
<div class="bottom-nav">
<a id="prev-link" class="topic__navi_prev" href="locale-settings.html">
<span class="bottom-nav__arrow bottom-nav__arrow--prev"></span> <span
class="bottom-nav__link">locale-settings.html</span>
</a>
<a id="next-link" class="topic__navi_next" href="branding.html">
<span class="bottom-nav__link">branding.html</span> <span
class="bottom-nav__arrow bottom-nav__arrow--next"></span>
</a>
</div>
<!-- добавляет на страницу строку блок Была ли статья полезной? -->
<div class="feedback" id="feedback"><div class="feedback-help"><span><b>Was this helpful?</b></span><form action="" method="POST" class="feedback-form" id="feedback-form"><div class="feedback__popup feedback__popup-response" id="feedback__popup_thx" style="display: none;">Thanks for your feedback!</div><div class="feedback__popup" id="feedback__popup_why" style="display: none;"><div class="feedback__popup-header">Please specify why:</div><input type="radio" name="category" id="bad_recommendation" value="bad_recommendation"><label for="bad_recommendation">Recommendations did not help me</label><input type="radio" name="category" id="difficult_text" value="difficult_text"><label for="difficult_text">Article is hard to understand</label><input type="radio" name="category" id="no_answer" value="no_answer"><label for="no_answer">Didn`t answer my question</label><input type="radio" name="category" id="bad_header" value="bad_header"><label for="bad_header">Content does not match the topic</label><input type="radio" name="category" id="other_reason" value="other_reason"><label for="other_reason">Other</label></div><div class="feedback__popup" id="feedback__popup-other" style="display: none;"><div class="feedback__popup-header">How we can improve it?</div><textarea class="feedback__textarea" name="other" id=""></textarea><input type="submit" class="feedback__other-btn" value="Submit"></div><div class="feedback-form__btn-group"><input type="radio" name="useful" id="feedback__useful_yes" value="true"><label for="feedback__useful_yes"><img src="like.svg" class="small-img" alt="like"><spanclass="feedback-form__btn-group_yes-btn">Yes</spanclass="feedback-form__btn-group_yes-btn"></label><input type="radio" name="useful" id="feedback__useful_no" value="false"><label for="feedback__useful_no"><img src="dislike.svg" class="small-img" alt="dislike"><spanclass="feedback-form__btn-group_no-btn">No</spanclass="feedback-form__btn-group_no-btn"></label></div><select name="category"><option disabled="">Please specify why</option><option value="bad_recommendation" selected="">Recommendations did not help me</option><option value="difficult_text">Article is hard to understand</option><option value="no_answer">Didn`t answer my question</option><option value="bad_header">Content does not match the topic</option><option value="other_reason">Other</option></select><input type="submit"></form></div><div class="found_typo"><p style="margin: 0px; margin-top: 16px !important;"><span><b>Found a typo?</b></span> Select it and press <i>Ctrl+Enter</i> to send us feedback</p></div></div>
</section>
</div>
<aside class="article__sidebar" style="display:none">
<input type="checkbox" />
<div class="article__arrow"></div>
<div class="table-of-contents elma365-right" id="toc2Content">
<h3 class="h3-toc">In this topic</h3>
<nav id="toc2"></nav>
</div>
</aside>
</div>
</article>
</main>
<footer class="footer">
<div class="footer-container">
<div class="footer-mobile">
<ul class="footer-mobile__list"><li><a href="https://brix365.com/en/" target="_blank">BRIX</a></li><li><a href="https://tssdk.brix365.com/en/latest/" target="_blank">SDK</a></li><li><a href="https://api.brix365.com/en/" target="_blank">API</a></li></ul><ul class="footer-mobile__list"><li><a href="https://brix365.com/en/help/platform/get-trial.html">Platform</a></li><li><a href="https://brix365.com/en/help/ecm/ecm-functions.html">ECM</a></li><li><a href="https://brix365.com/en/help/service/service-functions.html">Service</a></li><li><a href="https://brix365.com/en/help/projects/projects-functions.html">Projects</a></li></ul>
</div>
<div class="footer-wrap">
<div><span class="mobile-question-popup">Send feedback</span><form method="POST" action class="question__popup question-xs" id="question__popup"><div class="question-wrap"><span class="close"></span><span class="title">Ask a question</span><label for="help_question" style="display: none;"></label><textarea name="help_question" id="help_question"></textarea><input type="submit" value="Send"></div></form><div class="hidden fade-in question-success-xs">Sent</div></div>
<div class="footer-flex-b">
<span class="footer-copy">&copy; 2025 BRIX</span>
<ul class="footer-list">
<li class="footer-item">
<a href="#" class="arrow-top" style="display: block;"></a>
</li>
</ul>
</div>
</div>
</div>
</footer>
<iframe name="hmnavigation" style="display:none!important"></iframe>
<script src="./jquery-ui.js"></script>
<!--script src="//cdn.jsdelivr.net/npm/featherlight@1.7.14/release/featherlight.min.js" type="text/javascript" charset="utf-8"></script-->
<script src="./jquery.tocify.min.js"></script>
<script src="./TypoReporter.min.js"></script>
<script src="./google-search.js"></script>
<script src="./main.js"></script>
</body>
</html>