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