Pre-requisites



Installed Atomia GUI applications (HCP, BCP, POP)


Customization


Proper way of altering translation files starts with creation of new theme


CREATING A NEW THEME


First you have to duplicate an existing theme, for example the default one:


{app_root}\Themes\Default


and rename it to e.g. CustomTheme. You should have two theme folders now:


{app_root}\Themes\Default


{app_root}\Themes\CustomTheme


Second create {app_root}\App_GlobalResources\CustomTheme folder


Next, copy all .resx files from {app_root}\App_GlobalResources folder to {app_root}\App_GlobalResources\CustomTheme folder 


and rename them to CustomTheme{resx_file_name} eg. BreadCrumbItems.nl-NL.resx to CustomThemeBreadCrumbItems.nl-NL.resx


Next, you have to register your new theme:


Create, C:\Program Files (x86)\Atomia\{app_root}\App_Data\Transformation Files\appConfig.CustomThemeEnable.config

 

<?xml version="1.0" encoding="UTF-8"?>
<appConfig xmlns="Atomia.Web.Base.Configs" xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform">
    <themesList>
            <theme name="Default" isActive="false" xdt:Transform="SetAttributes(isActive)" />
            <theme name="CustomTheme" isActive="true" xdt:Transform="Insert" />
    </themesList>
</appConfig>

 

Next, apply transformations and recreate config files by executing the following:


powershell

C:\install\recreate_all_config_files.ps1
iisreset.exe

 


After you created custom GUI theme, you are ready to start altering translations and modifying it.



You can find location of specific translation file by looking at address bar at your browser


eg. https://billing.example.com/{user_id}/CustomerPanel/ExtraServices


says that all translations related to this page can be found at 


C:\Program Files (x86)\Atomia\BillingCustomerPanel\Themes\{ThemeName}\Views\ExtraServices\App_LocalResources\


Just search .resx file for string you want to replace and edit in place.



Basically all GUI translations can be found at two locations:


Local Resources

{app_root}\Themes\{ThemeName}\Views\{GUIpage}\App_LocalResources\*


Global Resources

{app_root}\App_GlobalResources\{ThemeName}\*


Languages are marked by language code contained in filename eg. Index.aspx.nl-NL.resx is Dutch translation