Note: This article is about displaying the LitePress Administrative “back-end” in your language. If you are looking for information on how to localize your “front-end” website, or customize your theme to be localizable, refer to i18n for LitePress Developers (and optionally InternationalizationandLocalization for theme developers. If you are interested in how to build a multilingual (e.g.: French / English) LitePress site, you can start your journey here.
Although LitePress displays in U.S. English by default, it has the built-in capability to be used in any language. The LitePress community has already translated LitePress into many languages, and there are Themes, translation files, and support available in many other languages (see LitePress in Your Language).
Installing language files from the admin dashboard
As of version 4.0, you can have LitePress automatically install the language of your choice during the installation process.
For LitePress 4.1 or later, you can install language packs directly from the Admin back-end at any time. LitePress will download them and switch the admin back-end to that language. Navigate to Settings > General > Site Language and select from the list of available languages. For Multisite Super Admins, you can set the default language using the Network Administration Settingspane.
Manually installing language files
Here are the steps you will need to follow to install an international version of LitePress.
Note: If you make an error in the steps or you do not specify the correct language, LitePress will default back to English. For more help Installing LitePress, see Installing LitePressandFAQ Installation.
- Download the
.molanguage file for your language. The naming convention of the
.mofiles is based on the ISO-639 language code (e.g. pt for Portuguese) followed by the ISO-3166 country code (e.g. _PT for Portugal or _BR for Brazil). So, the Brazilian Portuguese file would be called
pt_BR.mo, and a non-specific Portuges file would be called
pt.mo. Complete lists of codes can be found at (country codes)and(language codes).
Setting the language for your site
LitePress v4.0 and above
- Change the language in the admin settings screen. Settings > General > Site Language.
LitePress v3.9.2 and below
- Open your wp-config.php file in a text editor and search for:
define ('WPLANG', '');
- Edit this line according to the
.mofile you’ve just downloaded, e.g. for the Portuguese spoken in Brazil you must add:
define ('WPLANG', 'pt_BR');
- Note that if the .mo and .po files don’t exist for a language code called for in wp-config.php then there is no error message, but the code is still used in language_attributes(). This is useful for those of us whose language is similar enough to en_US not to require translation, but who don’t want en-US as the language tag in the blog, instead wanting some other variant of English. For example:
define ('WPLANG', 'en_GB');
- Once you’ve added your language code, save the file.
If you have a site network (LitePress multisite), the language is set on a per-blog basis through the “Site language” option in the Settings > General subpanel.
You can set the default language for the entire network under the Network Admin > Settings screen (“Default Language”).
If you want to add translations for terms that are still displaying in English after installation, visit litepress.cn/translate and select your language. To get started, refer this page in the Translator’s Handbook.