Custom Translations

How to make changes to translations in the Atomia User Panel

Overview

The Atomia User Panel comes with a number of translations installed as part of the default theme. They are .resx files located in the App_GlobalResources folder and the page specific App_LocalResources folders under the Themes\<ThemeName>\Views structure.

If for some reason you wish to change these translations, either to correct some error, or to better suit your customers, this guide describes how to do that in the simplest way as part of your own custom theme.

Good to know

This guide applies to both parts of the Atomia User Panel: the Billing User Panel and the Hosting User Panel.

Before you begin

This guide requires you to have your own custom theme set up in the Themes folder structure and to have it activated in the App_Data\appConfig.config settings.

Page specific translations

Most translations are located in page specific App_LocalResources folders inside the Views folder structure. Here is how to change them:

Locate the string you want to edit by doing a global search for it in the Themes\NewDefault\Views folder with your text editor of choice.
Copy the .resx file(s) found to the same position in the folder structure under your own custom theme.
Remove all translation entries except the ones you want to edit.
Change the string to be translated in the value element.

Important!

It is important that you keep only the entries you want to edit, so that you get the benefit of any improvements or fixes to the strings that you did not change. Each translation entry is represented by an XML element that looks like this in a regular text editor:

<data name="Title" xml:space="preserve">
  <value>Landung</value>
 </data>

Keep in mind

You might find the same translation you want to change in several places. To know which translation entry is located in which file you can compare the path of the page in the control panel with the Views folder structure. E.g. the German translation entries for the path /<account-number>/CustomerPanel/MySubscriptions are located in the Views\MySubscriptions\App_LocalResources\Index.aspx.de-DE.resx file.

Global translations

Some translations are defined and available globally for the whole application (Billing User Panel and Hosting User Panel separately). They are located under the App_GlobalResources folder in the root folder of the application. They contain common strings like validation messages etc. Here is how to change them:

Locate the string you want to edit by doing a global search for it in the App_GlobalResources folder with your text editor of choice.
Copy the .resx file(s) found to your theme specific translation files:
1. If the string is located in the NewDefaultCommon.*.resx files, make or modify a copy of it with the name <YourThemeName>Common.*.resx.
2. If the string is located in another file, make or modify a copy of it to a file in a subfolder with the name <YourThemeName>\<YourThemeName><OriginalFileName>.*.resx. E.g. changes to App_GlobalResources\MenuRender.*.resx in a theme called Foo would be done in App_GlobalResources\Foo\FooMenuRender.*.resx.
Remove all translation entries except the ones you want to edit.
Change the string to be translated in the value element.

Country name translation

The country names are listed in the drop-down box on the Accounts settings page (Address tab) in the Billing User Panel and by default are in English. The country name of one or more countries for some particular language can be changed by adding a new translation entry in the appropriate Common.*.resx file. For example, to change Norway to Norge for the Swedish language the following lines should be added in the <YourThemeName>Common.sv-SE,resx file:

<data name="Norway" xml:space="preserve">
 <value>Norge</value>
</data>

The name of the entry must be exactly the same as the country name in English and the value is the translated country name.

Customizing the UI