This is the documentation for Clover Club 12.0.
Documentation for the upcoming version Rampur 13.0 can be found here.

Internationalization

Owned by Jan Panoušek
Jun 14, 2024
2 min read

In the Internationalization section you can rename or translate all user interface labels within each individual partition (i.e., rename the label 'product master' into 'service master'). With that the Pricefx look and feel can be completely adjusted to the needs and requirements of an individual customer without the necessity of any application customization.

To change the labels:

  1. Go to Administration > Configuration > Internationalization.

  2. Select where you want to make the changes by switching to the correct tab at the top:

    • Partition-wide – Changes are visible for all users who do not have the Edit Localization role assigned.

    • Private – Changes are visible only to users with the Edit Localization role. This allows you to test the localization without impacting the regular users.

  3. In most scenarios, you will probably want to make the edits in Excel.

    1. Click the Export button to obtain the XLSX file with all localization strings.

    2. Enter new labels to override the existing ones. You must put the new labels in the third column, next to the current label.
      Do not add or remove lines in the Excel file.

    3. Upload the file using the Import button.

  4. Optionally, you can enter a new text into the Value Override field directly in the application.

  5. You must always click the Save button to keep the changes. At this point, you still have a choice whether to save the changes for the whole partition or just privately.

  6. You must log out and log in back to the system to see your changes take effect.

 If you want to have translated labels for multiple languages, you can do it with the help of URL parameters:

  1. Load the Internationalization page with URL parameters specifying the desired language, for example ?locale=fr&uiLanguage=fr for French.

  2. Add and save your translations.

  3. Log in again to the UI using the parameters ?locale=fr&uiLanguage=fr.
    The labels will be displayed in French translation.

This way you can translate labels for several languages.

Whenever there are Value Overrides on both the Private and Partition-wide tabs, users with the Edit Localization role will always see in the UI the "private" changes (and not the partition changes). This is because the Private tab edits are displayed to these localization admins by default. Only after all edits on the Private tab are reset, localization admins can see the Partition-wide tab edits (which regular users see too).

To remove the localized values, use the Reset button. It removes all of the changed labels – either in the partition-wide or private localization.