Translate Backoffice Texts

How to Translate Sana Commerce Backoffice Texts

By default the Sana Commerce backoffice is available only in English. But all texts of the Sana Commerce backoffice can be translated into another language.

Using the resource files you can translate the Sana Commerce backoffice texts into any language to meet your needs.

To translate the Sana Commerce backoffice texts into another language:

Step 1: Locate the resource files of the Sana Commerce backoffice.

The path to the backoffice resource files for SDK solution: …\SDK\Sana.Commerce.BackOffice\App_GlobalResources

The path to the backoffice resource files for Ready To Deploy solution:
…\Ready To Deploy\BackOffice\App_GlobalResources

The Sana Commerce backoffice contains four resource files: 'DataModel.resx', 'Settings.resx', 'SiteMap.resx' and 'Text.resx'

Step 2: Copy these files into the same folder. The copied files should be renamed in the following format: [name of the resource file].[Language Culture Name].[resx]

For example, if you need to translate the Sana Commerce backoffice into Dutch the copied resource files must have the following names: 'DataModel.nl-NL.resx', 'Settings.nl-NL.resx', 'SiteMap.nl-NL.resx' and 'Text.nl-NL.resx'.

The list of all Language Culture Names can be found here.

Step 3: Open the copied resource files in Microsoft Visual Studio.

Step 4: In the 'Value' column of the resource files you can see the default English texts which are shown in the Sana Commerce backoffice. Translate the texts into the necessary language and replace the default English values with those which are translated. Save your changes.

The resource file of the frontend ('Text.resx') contains the texts which are used in the Frontend Editor. These texts must be also translated in the same way as for the backoffice.

The path to the frontend resource file for SDK solution: …\SDK\Sana.Commerce.Startersite\App_GlobalResources

The path to the frontend resource file for Ready To Deploy solution:
…\Ready To Deploy\Frontend\App_GlobalResources

Now the language should be changed in the 'web.config' file of the Sana Commerce backoffice:

Step 1: Open the 'web.config' file of the Sana Commerce backoffice in any text editor.

Step 2: Locate the following line in the <sanaCommerce> configuration section:

<backoffice websiteName="Sana Commerce" language="en-US"></backoffice>

Step 3: Change the language value 'en-US' to the necessary one.

If all steps have been performed, then your Sana Commerce backoffice is in the language you have translated it.