Translating Language Files

PyroCMS is built to have a fully multi-lingual interface, which means you can switch between different languages, and if your language is not supported you can easily translate from one of the existing languages into yours.

Step #1: Translate or Download a CodeIgniter language pack

The CodeIgniter translations are all now drastically out of date, as PyroCMS uses CodeIgniter 3.0, so you will need to translate them yourself.

Copy the English translation folder from system/codeigniter/languages/<language-name> and translate each file to the new language.

Step #2: Translate PyroCMS language pack

PyroCMS language files exist both in the main application folder and inside each module. This is a list of all folders that contain language files:

1. system/cms/language/<language-name>/
2. system/cms/modules/<module-name>/language/<language-name>/
3. addons/modules/<module-name>/language/<language-name>/

To get these new folders, just copy the english folder, rename it and translate all of the English text into your language.

Step #3: Add language to each modules details.php

Each module has a details.php file that contains details about the module such as versions, installation information, names and descriptions. Each name and description needs to be translated into your current language based on the ISO_3166-2 2-letter code. For example, English is "en" and French is "fr".

Step #4: Add language to config

Open up system/cms/config/languages.php and add your language to the array with the same two digit code used in Step 3. Once this is done you will see your language available in the dropdown menu in the Control Panel.

That should be it! If you get any language related errors when you switch to your new language and want to switch back to English then just add ?lang=en to any URL.

When you have confirmed that it everything looks correct you could consider contributing the language pack changes back to the core of PyroCMS via forking with Git . This way it can be contributed to the next major version and others will not have to spend time translating PyroCMS themselves.