Localization

Feng Office is available in many languages, and the amount of languages is constantly growing! It currently supports the following languages:

Notes:

1. Quality of localizations is a subjective measure (ranking: 1=bad to 5=Excellent) assigned by the core development team. As evidences of higher quality (completeness, volume of contributions, statistics, comments) prove a substantial improvement, quality rankings will be increased.

A different localization can be chosen for each user. To choose your localization you can go to Account → Edit Preferences → General → Language. Select your language, save changes and refresh the browser.

ADministrators can change system wide localization for the whole plataform at once. This way there will be no need for all users to configure their profile (as mentioned above):

1. Open the file ”{Feng Office}/config/config.php”.
2. Look for the following line: define('DEFAULT_LOCALIZATION', 'en_us');
3. Change it to what you want. For example: define('DEFAULT_LOCALIZATION', 'es_es');

This will change the language for all users from English (US) to Spanish (from Spain, not LatAm).

Please note that users can override this setting selecting another language from their profile.

IMPORTANT: The new locale's name has to be the “short name” included in parenthesis in the upper part of this section, under the title “Localizations, Available Languages”.

All text that is displayed in Feng Office is stored on files in the language folder. In that folder there is one sub-folder for each localization available in Feng Office, which are named with the ISO code of the language followed by the country code (e.g. en_us for English - United States). Each of these sub-folders store a group of files that associate translation keys to translation strings. A sample pair of translation key and string on one of this files could be: <PHP>

  'hello world' => 'Hello world!',

</PHP> The left part is the translation key, which is used on Feng Office's source code. The right part is the translation string, which is displayed on Feng Office's interface. The localization files are loaded according to the localization preferences chosen by the user. If the user selects the 'pt_br' localization on his user preferences, then the files in the 'pt_br' folder will be loaded and so all text will be displayed in Portuguese.

For on-premise:

To translate Feng Office to your own localization you could just copy the en_us folder, rename it to your localization's name, and translate the right part of all files in that folder, but there's an easier and safer way. Feng Office includes a translation tool that will take care of all the nifty details, and allow you to focus on just translating the text. If you were to manually translate all files you would have to be careful to use UTF-8 character encoding and respect the file format, comma positions, etc, otherwise text could be wrongly displayed or it could break the interface altogether. For example, PHP translation files can have a trailing comma on the last translation string, but Javascript files should not end with a comma, or it won't work in IE. When using Feng Office's translation tool this is handled for you. To use it browse to http://feng_root/public/tools (change feng_root for your installation's root, e.g., localhost/feng) of any installation and choose Translate Feng Office. This tool can also be used to update existing translations.

For cloud clients:

Contact our support team at support@fengoffice.com and request a user for our web translation tool.

Once you have finished translating Feng Office you can share your translation files at the Feng Office forums.