Recent Changes - Search:

Categories

Portal Guard Language Support

PortalGuard and support for languages other than English

Problem: You have PortalGuard installed and you have users who speak a language other than the default language (English)

Solution: By default, PortalGuard ships with only a US English language file. All user interface messages/text are completely contained within the pg_custom.js file (found in C:\inetpub\PortalGuard\_layouts\images\PG\js) and this file is meant to be modified directly by customers. To support multiple languages, you must make duplicate copies of this file and translate the string contents to your target language(s). Your end users will have the ability to choose their preferred language from a drop-down list right on the PortalGuard login screen:

Please use the following steps to enable multiple language support on your PortalGuard server:

1) In inetpub\PortalGuard\_layouts\images\PG\js, rename pg_custom.js to pg_custom.en-US.js. When multiple language support is enabled, the “pg_custom.js” file is no longer used.

2) Create a copy of pg_custom.en-US.js for each language you need to support. These files must be saved in the same “js” folder and the name of each should be in the following format: pg_custom.[2 letter language code]-[2 letter region code].js For example: French: pg_custom.fr-FR.js German: pg_custom.de-DE.js

3) Translate the string contents of each of the files to the target languages.

4) In InetPub\PortalGuard, edit the web.config file in a text editor as an administrator.

5) Find the <LanguageSupport> element near the bottom of the file and remove the HTML comments that precede it (“<!--") and that follow the </LanguageSupport> closing tag (“-->"). The text to remove are shown in red highlight in the screenshot below:

6) For each language you want to support, create an <add> element with the following attributes (please note, these attribute names *must* be all lowercase):

a. lang – The locale that matches the files you created in step #2.

b. display – The value of the language that will be shown in the Language drop-down list seen by end-users on the PortalGuard UI.

c. default – This attribute must only be present on the one language that you want to be the default. When present, the value of this attribute must be “true”.

7) Run “iisreset” from an administrative Command Prompt. Please note that *ALL* changes to these web.config settings are cached and require “iisreset” to be run before they take effect. This includes both enabling and disabling multiple language support.

Accessing the PortalGuard website should now show a drop-down list of enabled languages in the upper right corner where users can manually choose their preferred language.

As of PortalGuard version 4.3.1.2 (January 2015), multiple language support still only extends to ISO-8859-1/ISO Latin 1 languages. This limitation is because the PortalGuard server’s back-end does not yet fully support Unicode/UTF-8 encoding. This means character sets & languages such as Shift JIS (Japanese), Simplified Chinese and Traditional Chinese are currently not supported by PortalGuard.

Tags: languages, user interface

Page last modified on January 28, 2016, at 12:39 PM