System Languages

All available languages in BIGACE are configured with INI Files. The Language Configs are stored in the directory /system/language/.

[Note]Note
Up to Version 1.8.3.x these Files where stored in /system/languages/.

In a default installation you can find:

That's why the System knows by default the Languages German (with Locale "de") and English (with the "en").

Structure of Language INI Files

The structure of a Language definition file looks like this (for example "de"):


 ;
 ; Language definition for Germany
 ;
 
 name        = German
 translation = de
 locale      = de
 full        = de_DE
 charset     = UTF-8
 
 ; following lines work only for BIGACE 1.9x
 [translations]
 name_de     = Deutsch
 name_en     = German

				

As you can see, up to BIGACE 1.8.3.x the Language name was always fetched from the key "name". From 1.9 alpha on, the Language name is translated and fetched from the “translations” Section.

Adding new Languages

This Section describes how you can add a new Language to your System.

[Note]Note
This describes how you enable your System to use a different Languages (for example for creating Object Version in this Language), it does not describe how to translate all Administration Masks to this new Language.

It is quite simple, you have to perform two steps:

  • Create a new Language definition File and store it in /system/language/
  • Copy an Image for the new Language to all installed Admin Styles /public/system/styles/STYLENAME/languages/LOCALE.gif

For example, you want to add French support, French has the Locale "fr".

Copy one of the existing Files and rename it to "fr.ini". The Content of the new File should look like this:


 ;
 ; Language definition for French
 ;
 
 name        = French
 translation = fr
 locale      = fr
 full        = fr_FR
 charset     = UTF-8
 
 [translations]
 name_de     = "Französisch"
 name_en     = French
 name_fr     = France

				

Last step would be, to copy an Image for the new language to /public/system/style/standard/languages/ and the other AdminStyles you might use.

The filename format (like mentioned before) looks like this: locale.gif. For French it would be “fr.gif”.

We added French support to your BIGACE installation, now you can add Menus, Images and Files in French, but note that all Admin Masks still appear in your default Language!

See also the section called “Languages”.