Administration Guide

Adding a Localization Dictionary to the Self Service Portal

After you have prepared a localization dictionary, you must add it to the Self Service Portal.

If you haven’t installed the Self Service Portal yet:

  1. Put your localization dictionary to the localization folder under the Alloy Navigator installation folder, typically at:

    C:\Program Files\Alloy Software\Alloy Navigator 8\
    System\WebAppsTemplates\SSP\localization

  2. Run the Web Configuration tool to configure a new instance of the Self Service Portal. On the Select Languages page, you will see your newly added language pack. Keep its check box selected and proceed with the configuration of the Portal.

INFO: For details on the Web Configuration tool, see Web Components.

If you already have a configured instance of the Self Service Portal:

  1. Put your localization dictionary to the localization folder under the SSP installation directory:

    [PhysicalPathToSSP]\localization

    INFO: For instruction on viewing the physical path of Self Service Portal installation folder, see Physical Path to Self Service Portal Files.

  2. Run the Web Configuration tool and go to the Select Languages page. Your newly added language pack will be listed there. Keep the corresponding check box selected, then proceed to the last page and click Apply.

To manually add a localization dictionary to an existing Self Service Portal instance without using the Web Configuration tool:

  1. Put your localization dictionary to the localization folder under SSP installation directory:

    [PhysicalPathToSSP]\localization

  2. Open the User.config file from the config folder in a text editor:

    [PhysicalPathToSSP]\config

  3. In the <Locales> section of the User.config file, add a line for the new language, for example:

    <add LocaleID="tr-TR" Description="Turkish - Turkey" Default="false" />

    The LocaleID attribute must be the same as the id key value of the Formats key in the localization dictionary.

    The Default attribute specifies whether this language will be used by default for users who haven't set their Self Service Portal preferred language.

    You can specify the optional attribute File if the name of the localization dictionary is not in the recommended format <LCID>.json.

  4. Save your changes in the User.config file.