Localizing your Storefront and Backoffice

The Localization area in Presets displays all cultures defined in the system. These include out-of-the box cultures and additional cultures that have been added.

In the Localization page you can add cultures, and localize the storefront and backoffice to any language as reflected in system messages, labels, menu items, etc (i.e., static items). The static text is the text that appears /is available in all uStore stores and backoffice.

You can ease the localization process by importing and exporting localizations as Excel sheets.

You can also localize dynamic store text (for example, product groups, products). These localization options are defined in the stores and are specific for each store.

To view a list of all cultures, on the toolbar click Presets > Localization.

The Culture List contains all cultures that are currently defined in your uStore system. The cultures with missing localizations are marked with the icon. For each culture a flag, a full culture name (French-France), a culture code (fr-FR) and a language name in the native language (Français) are displayed. Clicking the Edit icon allows you to edit these definitions.

You can add a culture, edit culture properties, translate storefront and backoffice labels and menus to the selected language and delete a culture. Note that out-of-the box cultures and cultures already used in stores cannot be deleted.

Administrators are able to select the locale they want to use when they log in to uStore backoffice based on the settings you define here.

Store users are able to select the locale they want to use when they log in to the storefront based on the settings defined when setting up a store.

Set the backoffice culture

Administrators are able to select the locale they want to use when they log in to uStore backoffice based on the settings you define in this topic.

Note that in this page the user selects the application locale. The setup language for each store is defined separately per store.

To set the backoffice cultures:

  1. On the toolbar click Presets, and then click Localization.

    The Localization - Culture Listpage opens.

  2. Click the Set Admin Cultures button.

  3. In the Admin Cultures Setting page, select the languages you want available on the backoffice login page.

    The login page will display flags of the selected language.

    uStore_Admin_login_with_details.png

In the login page, the user will click a flag icon in the Change Language bar to choose the uStore backoffice locale as reflected in system messages, labels, menu items, etc.

Add a culture to uStore

You can add a culture to uStore from the list of predefined cultures. The available cultures are defined in the Culture List table.

If you do not find the desired culture in the list, or if you wish to use several dialects of a language, and thus address different segments of the population (for example, youngsters vs. elders), you can create a new culture or a new instance of a language.

For example, you may want to create two stores for different dialects of the en-US language. In this case, you should add two instances of the en-US languages and distinguish each with a different name. To create a new language or a new instance of a language, see Setting Up the Culture List Table. Then, you can localize each store with a different dialect using uStore Localization Tool, as described in Localizing System Tables.

To add a culture:

  1. On the toolbar click Presets, and then click Localization.
    The Localization - Culture List page opens.

  2. Click the New button.
    The Culture Sections page is displayed.

  3. Select the culture you want to add from the list and click Save.

    The Culture Sections page is displayed where you can now localize uStore tables with the newly added language, as described in Localize system tables.

To edit properties of an existing culture:

  1. Click the Edit icon next to the culture you want to edit.

    The Culture Edit page is displayed.

  2. The Culture Edit page includes the following fields:

    • Culture Code: Culture name, using the .NET conventions. For example, enter ‘en-US’ for English - United States.

      For more details, see CultureInfo Class.

    • Culture Name: The name of the Culture that will be displayed to the store administrator. For example, English-United States.

    • Flag File Name: The flag file name you wish to assign to this culture. The flag files are located in: ...uStore\App\uStoreShared\Skins\Images\flags.

    • The flag file icon will be available for selection in the storefront Login page and in the top right corner of all other pages.

    • Language: The culture name in the native language.

  3. Click Save.

Change the uStore welcome message

When you first log in to a store, you are presented with a Welcome page displaying a personalized welcome message. By default, the English message says Hello {FirstName}, displaying the first name of the user logged in to the store. You can modify this message to include other user properties.

To change the uStore welcome message:

  1. On the toolbar click Presets, and then click Localization.
    The Localization - Culture Listpage opens.

  2. Click the Translate icon next to the language for which you want to modify the welcome message.

    The Culture Sections page is displayed.

  3. Click the Resources link, and in the Culture Edit[culture name and code] page search for ID 345(in theIDcolumn) or Header_ WelcomeMessage (in the Context column).

  4. The default text is Hello {0}, where {0} represents First Name. Click the Edit icon to type in text in the Localized Text field, or add other user properties as follows:

    No.

    User Property

    {0}

    First Name

    {1}

    Last Name

    {2}

    Job Title

    {3}

    E-mail Address

    {4}

    Department

  5. Click Save.

Localize system tables

uStore tables can be localized for each language that exists in uStore. You may localize only the storefront or only the backoffice tables, or both.

To localize system tables:

  1. On the toolbar click Presets, and then click Localization.
    The Localization - Culture Listpage opens.

  2. Click the Translate icon next to a language.

    The Culture Sections page lists all available system tables of the uStore system that can be localized. The tables that have missing localizations for some of the text fields will be marked with the icon.

  3. To localize a table with missing localizations, click its link.
    The localization page for the selected system table is displayed.

    The Culture Edit page lists all text strings that are available for a selected system table, their ID number and an entry field where you can enter text in the local language. That text will be displayed in the store instead of the default English text.

    • You can filter down the presented text string list by using the filtering option at the top of each column. To apply a filter to the list, click the Filter icon next to the required column header and select the filter from the displayed list. Some filters allow you to further pinpoint the desired results by specifying a value or a text string of one or more required fields in the records returned from the database. For example, the "Context" filter allows you to enter a text string to look for in the listed records.

    • You can sort any column in the resulted record list in ascending or descending order by clicking the required column header. Clicking it once will sort the list in ascending order; clicking it again will sort it in descending order.

    • You can display all unlocalized records identified by the [no localization] label in their Localized Text field by clicking the Show only items without localization button.

  4. All tables can be localized by simply entering new text in the local language. To do so, click the Edit link to the right of the text string you want to replace and enter the new text in the box that appears. You can also enter the text directly in the Localized Text column.

  5. If the record you want to localize contains several localizable fields, click Edit More… to open all the linked localization text fields and localize them as necessary.

    If you need to localize only the storefront or only the backoffice, this list will help you identify which tables you need to translate.

    Excel Tab Name

    Storefront

    Backoffice

    Admin Resources

    ResourcesCulture_AdminApp

    Country

    Country_Culture

    Culture

    Culture_Culture

    Culture Names

    CultureList_Culture

    Dial Validation

    DialValidationType_Culture

    Dial Validation Templates

    DialValidationRegExp_Culture

    Document Repository

    FileSubmissionRepository_Cultur

    Email Template

    MessageTemplate_Culture

    Event Names

    EventKeyPoint_Culture

    Global Properties

    GlobalProperties_Culture,
    GlobalPropertyOption_Culture

    Help File Proxy (legacy only)

    HelpFileOriginator_Culture

    JDF Node Set

    JDFNodeSet_Culture

    Mall

    Mall_Culture

    Order Handling Actions

    OrderHandlingAction_Culture

    Order Handling Statuses

    OrderHandlingStatus_Culture

    Permission Types

    ACL_PermissionType_Culture

    Plugins

    PluginDef_Culture

    Product Units

    ProductUnitType_Culture

    Province

    Province_Culture

    Receipt

    DefaultReceipt_Culture

    Recipient List Model

    RecipientListModel_Culture

    Report Parameters

    ReportParameter_Culture

    Reports

    Report_Culture

    Resources

    ResourcesCulture_CustomerApp

    Tax

    Tax_Culture

    UI Controls Names

    UIControlType_Culture

Note that if you cannot find a specific tab in the Excel (for example tax definitions or document repository), you should first add one instance of that item (tax, document) through setup, and then download the Excel again to see the tab.

Export and import localizations

uStore offers you the possibility to export localizable application strings into an Excel file. After the Excel file is translated, it can then be imported back to uStore.

Export localizations

  1. On the toolbar click Presets, and then click Localization.

    The Localization - Culture Listpage opens.

  2. Click the Export button.

    The Culture Export page is displayed.

  3. Select the source culture (<language> - <country>) from the Source Culture list.

  4. Select the target culture from the Target Culture list.

  5. If you wish to export all the source strings including those that have already been localized, click the Download Entire Translation button. If you wish to export only the strings that have not been localized to the selected target language, click Download Missing Translation.

Import localizations

  1. On the toolbar click Presets, and then click Localization.

    The Localization - Culture Listpage opens.

  2. Click the Import button.

    The Culture Import page is displayed.

  3. Select the target culture in the Target Culture list.

  4. Click Choose File to locate the translated Excel file.

  5. Make sure you backed up your database before importing the translations.

  6. Click Update Translation.

    The new translations will be inserted into the database.