Creating Language Files (Deprecated as of 11.25.0)

This document describes the process of creating new language files used with versions of cPanel prior to cPanel 11.25.0.

Warning: This document is deprecated. The information contained within does not apply to cPanel 11.25.0 and later.

In WHM

1. Clone an existing language file to create the basis for your new language file.
   • You can find the documentation about cloning an existing language file here.
2. Edit the language file you have just cloned.
   • You can find more information about editing an existing language file here.
3. Remember to save your changes.

Once you have completed this process, your users will be able to select the language from within their cPanel interface, if the option is available to them. If your users are unable to select a language, you may use the Modify an Account feature in WHM to select the new language for them.

Manually

1. Copy /usr/local/cpanel/lang/english/ to /usr/local/cpanel/lang/new_language_name. You may use the following commands to do so.
   • cd /usr/local/cpanel/lang/
   • cp english new_language_name
2. Use your preferred text editor to edit the language file you have just copied.
3. Run the following command from the command line interface:
   • /usr/local/cpanel/bin/cachelangfiles

Once you have completed this process, your users will be able to select the language from within their cPanel interface, if the option is available to them. If your users are unable to select a language, you may use the Modify an Account feature in WHM to select the new language for them.

Notes

1. /usr/local/cpanel/lang/english is the default English language file provided by cPanel.
2. New language files must include all of the values present in the /usr/local/cpanel/lang/english file. Any changes to the English language file (/usr/local/cpanel/lang/english) will be overwritten when cPanel is upgraded or resynchronized. You will need to create a new language file if you wish to edit the English language.
3. Any time changes are made to a language file, you must cache the changes if you want them to appear. You can cache changes to your language files by running the following command:
   • /usr/local/cpanel/bin/cachelangfiles
   • Note: Whenever a language file is edited in the WHM interface, this script is automatically run. This script also runs whenever cpsrvd is restarted.