Skip to main content

Languages Management

The Languages module allows administrators to manage the user interface languages available within the application. It provides functionalities to add new languages, set defaults, and manage localization terms and phrases.


SPS Customizations

Below are the specific workflows and functionalities built into the Languages module.

1. Languages Interface

Languages View

The primary view displays a list of all configured languages in the system:

  • Languages List: A table displaying languages with details such as Name (with flag), Code, Is enabled status, and Created date. The default language is typically highlighted or indicated (e.g., Yes in green for Is enabled, or marked as default).
  • Actions Menu: Allows managing individual languages. The available options are:
    • Edit: Opens a dialog to modify the language's properties (such as enabling/disabling it or changing the display name).
    • Manage Localization Terms and Phrases: Opens a dedicated interface to view, search, and edit the translations for specific terms and UI texts in the selected language.
    • Set as default language: Marks the selected language as the primary fallback language for the application and users.
    • Delete: Removes the language configuration from the system (typically blocked for the default language).
  • Create New Language: A primary action button (+ Create new language) to add a new language configuration to the system.

2. Creating or Editing a Language

When creating or editing a language, administrators use a dialog to select the language properties:

Create Language Edit Language
  • Language Dropdowns: Selections for the specific language and culture code.
  • Is enabled: A checkbox to determine whether this language should be active and available for users to select in the application.

3. Manage Localization Terms and Phrases

Administrators can fine-tune translations and localization keys directly through the UI:

Manage Terms and Phrases
  • Filters: Options to filter terms by Base language, Target language, Source, and Target value.
  • Search: A search bar to locate specific keys or phrases.
  • Terms Table: Displays the Key, Base value, and Target value. Users can click the edit icon on any row to modify the translation for the target language.

Edit Text Dialog

When an administrator clicks the edit icon for a specific term, an Edit text dialog appears:

Edit Text
  • Key: Displays the system identifier for the phrase (e.g., AccountManagerName).
  • Base language (English): Shows the text in the base language as a reference (read-only).
  • Target value: A text area where the administrator can input or update the translation for the target language.

Developer Reference

Core Backend Components

  • Entities: Driven by core localization entities (typically Language and LanguageText) managing the supported languages and their dictionary entries.
  • Application Services: Services handling CRUD operations for languages, changing the default language, and dynamically updating or retrieving localization strings for the application frontend.