Introduction
The i_cpanel_snowmen
locale allows you to quickly test localization. This locale translates every localized string in the interface into several Unicode snowman characters (☃). This allows you to easily find hardcoded strings (strings that do not exist inside a locale.maketext()
wrapper) without the need to search code manually.
Notes:
- We introduced this locale in cPanel & WHM version 11.46.
- Because the
i_cpanel_snowmen
locale is a cPanel-provided locale, youcannot remove this locale from the server.
Basic usage
You can use the i_cpanel_snowmen
locale to test the localization in custom interfaces, or to ensure that your customizations did not cause problems in existing strings.
To do this, perform the following steps:
- Navigate to cPanel's Change Language interface (Home >> Preferences >> Change Language).
- Select the ☃ cPanel Snowmen ☃ - i_cpanel_snowmen locale from the Set language to menu.
- In cPanel's Paper Lantern theme, this is the Select a Language menu.
- Click Change. The interface reloads with the new locale.
When the interface displays in the i_cpanel_snowmen
locale, only the following types of text will continue to display in the default locale:
- Localized words that exist in
[asis]
bracket notation. - The cPanel account's username.
- Filenames and other technical data that does not change when translated.
- Hardcoded strings, which do not exist inside a
locale.maketext()
wrapper.
Help! I accidentally selected the snowmen locale.
If you accidentally selected the i_cpanel_snowmen
locale, use one of the following methods to select the correct locale:
- If you did not navigate away from the Change Language interface, select the correct locale and click the button directly below the menu.
- In cPanel's x3 theme, this button will appear similar to the following example:
- In cPanel's Paper Lantern theme, this button will appear similar to the following example:
- If you navigated away from the Change Language interface, click the Logoutbutton in the top right corner of the interface. The login interface allows you to select a different locale.
- In cPanel's x3 theme, this button appears similar to the following example:
- In cPanel's Paper Lantern theme, this button appears similar to the following example:
- In cPanel's x3 theme, this button appears similar to the following example:
- If you navigated away from the Change Language interface, click the Logoutbutton in the top right corner of the interface. The login interface allows you to select a different locale.