Splitting the 'New-Style' Locale Files

If you have merged locale files for more comfortable translation, you need to split the merged files before importing the locale into Plesk.

To split your translated files:

Run the following command for each of the files:

php <plesk-installation-dir>/admin/smb/application/utils/locale/plesk2smb.php -f <localeFile> -o <target-directory> -l <locale-code>


  • <plesk-installation-dir> is the Plesk installation directory (by default, that's /usr/local/psa on Linux and "C:\Program Files\Plesk" on Windows).
  • <localeFile> is the locale file that had previously been merged and needs to be split.
  • <target-directory> is the name of the directory, in which another directory, one containing the individual locale files will be created. If not specified, the current directory will be used.
  • <locale-code> is the locale code that will be used as the name of the directory containing the individual locale files. Use the xx-YY format, to find the required locale code, see the Appendix. Locale Codes section).

For example, to split the files /tmp/shared.php, /tmp/admin-panel.php, and /tmp/control-panel.php containing the locale translated into Brazilian Portuguese (pt-BR), and have the resulting files placed into the Plesk locale file structure, run the following commands:

# cd /usr/local/psa/admin/

# php smb/application/utils/locale/plesk2smb.php -f /tmp/shared.php -o application/default/resources/languages -l pt-BR

# php smb/application/utils/locale/plesk2smb.php -f /tmp/admin-panel.php -o application/admin/resources/languages -l pt-BR

# php smb/application/utils/locale/plesk2smb.php -f /tmp/control-panel.php -o application/smb/resources/languages -l pt-BR


Leave your feedback on this topic here

If you have questions or need support, please visit the Plesk forum or contact your hosting provider.
The comments below are for feedback on the documentation only. No timely answers or help will be provided.