Page tree
Skip to end of metadata
Go to start of metadata

 

For cPanel & WHM version 11.50

(Home >> Locales >> Edit a Locale)

Overview

Use this interface to edit the locales on your server.

Important:

After you use this interface, you must run the /usr/local/cpanel/bin/build_locale_databases script from the command line. If you do not run this script, your changes will not appear in the cPanel interface until the next time that the upcp script runs.

Note:

To edit a locale offline, download the locale file from WHM's Locale XML Download interface (Home >> Locales >> Local XML Download). After you make the desired changes, upload the file in WHM's Locale XML Upload interface (Home >> Locales >> Locale XML Upload)

Locale Editor - Live Mode

The Live Mode editor allows you to edit a locale's collection of translated phrases in a new browser window that displays an editable version of the cPanel interface.

Important:

  • The Live Mode editor only modifies the x3 and x3mail themes. To modify localized phrases in the Paper Lantern theme, you must use the Bulk Mode editor. 
  • You must select a reseller account with access to all of the cPanel interface's features. If some features are disabled for the reseller account, you cannot edit all of the locale's phrases.
  • You cannot use this editor if you disallow root or reseller logins to cPanel user accounts. To allow root or reseller logins, select one of the following options in WHM's Tweak Settings interface (Home >> Sever Configuration >> Tweak Settings):

    • Root, Account-Owner, and cPanel User — Allow the root user and the reseller to access the cPanel account.
    • Account-Owner and cPanel User Only — Allow the reseller to access the cPanel account.

To edit a locale's collection of translated phrases, perform the following steps:

  1. Select the desired LocaleTheme, and Reseller names from the menus, and click Go. A new browser window will open that displays an editable version of the cPanel interface.

    Note:

    The ☃ cPanel Snowmen  - i_cpanel_snowmen locale is not for general use. Theme customizers and third-party developers can use this locale to test cPanel & WHM's localization system against their customizations. For more information, or for help if you selected this theme accidentally, read our The Snowman Locale documentation.

     

  2. All translated (editable) phrases appear as green text. Click the phrase that you wish to edit. An editor window will display.
  3. Edit the phrase in the Value text box.
  4. Click Evaluate Expression to check whether the system can successfully change the edited phrase.
  5. Click Save Changes to confirm changes, or click cancel to cancel changes.

Locale Editor - Bulk Mode

The Bulk Mode editor allows you to edit any of a locale's phrases.

To edit a locale's phrases, perform the following steps:

  1. Select the desired locale from the Locale menu.

    Note:

    The ☃ cPanel Snowmen  - i_cpanel_snowmen locale is not for general use. Theme customizers and third-party developers can use this locale to test cPanel & WHM's localization system against their customizations. For more information, or for help if you selected this theme accidentally, read our The Snowman Locale documentation.

     
  2. Select one of the following options from the Theme menu:
    • / — Edit both the x3 and Paper Lantern themes.
    • x3 — Edit the x3 theme.
    • x3mail — Edit the x3mail theme.
  3. Click Go. A new interface will display.
  4. Click Edit under the phrase that you wish to edit.
  5. Edit the phrase in the Value text box.
  6. Click Save Changes to save your changes, or click cancel to cancel changes.

Note:

Click Revert to Default Value to undo changes or edits to a specific phrase.

Non-Standard Locale Configuration

This tool allows you to configure data for a non-standard locale. A non-standard locale is a language with no data in the CLDR. The system adds the prefix i_ to the names of these locales. These tags are standard ways to create, identify, and work with non-standard locales.

To configure a non-standard locale, perform the following steps:

  1. Select a locale from the Locale menu and click Go.

    Note:

    The ☃ cPanel Snowmen  - i_cpanel_snowmen locale is not for general use. Theme customizers and third-party developers can use this locale to test cPanel & WHM's localization system against their customizations. For more information, or for help if you selected this theme accidentally, read our The Snowman Locale documentation.

     
  2. Enter a display name in the Display Name text box.
  3. Select the fallback locale, number formatting, and character orientation from the appropriate menus.

    Note:

     When a non-standard locale's lexicon does not have a phrase, the system displays the fallback locale's phrase.

  4. Click Save.