Translation [Admidio-Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Translation ======
Admidio use separated language texts within the code that are added in separate XML files. Thus a translation become relatively easy and we look forward to any other language in which we can offer Admidio. Within the translation files we use the xml format of **Android String Resource**. Our translation files are available at [[https://www.transifex.com|Transifex]] and you can use that platform to perform the translation. After you are done, we import the translated files from Transifex to the Admidio source code.

===== Add new language =====

==== First steps ====
If you want to add a new language to Admidio please [[m.fassbender@admidio.org|contact]] us first. We can thus avoid that multiple people simultaneously translate a language and discuss problems or other things directly. At the same time you can register yourself at [[http://www.transifex.com|Transifex]] and join the [[https://www.transifex.com/admidio/admidio/dashboard/|Admidio Project]].

==== Translate ====
If you got an //ok// from us to translate Admidio in your favorite language you can do so within [[http://www.transifex.com|Transifex]]. Please check if your language is accepted for Admidio otherwise ask for activation of the language and that we add you as a translator. 

After that you can start to translate. Please start with the //resource// called **main program strings**. These are the strings Admidio needs. The other resources are plugins and countries that you may translate later.

If you have problems to select **english** as your source language then please have a look at {{:en:developers:documents:change_source_lang.pdf|this short how-to}}. This how-to starts at the [[https://www.transifex.com/admidio/program/dashboard/|Admidio Dashboard]] of Transifex.

Now you can start the translation of your favorite language.

==== Use your language within Admidio ====
If you want to see your work in Admidio you must download your translated strings from [[http://www.transifex.com|Transifex]] and copy this file to the Admidio folder **adm_program/languages**.
Now you must introduce the new language to Admidio so that it will be shown in the language select box. 

Therefore you must add the ISO code and the name of the language to the php file **languages.php** in the folder **adm_program/languages**. The name of the language should be a combination of the english word and the name of the language in the language itself.

The following PHP snippet must be adapted and should be add to the beginning of the array list in the file just after **$gSupportedLanguages = array(**
<code php>    'de'    => array(
        'name'    => 'German - Deutsch (du)',
        'isocode' => 'de',
        'libs'    => 'de'
    ),</code>

:!: Please note that the ISO code must be the same as the name of your xml file. E.g. if your downloaded XML file has the name //xy.xml// than your ISO code is //xy//.

Now restart your browser and go to your Admidio installation. You can now select your new language within the **Regional settings** of the **preferences**

==== Last step ====
Now translate all necessary texts and then [[m.fassbender@admidio.org|send us]] an email that the language is ready for delivery. We integrate the file in our source code and your translation will then be included in the next Admidio release.

===== Improve existing language =====

If you want to improve an existing language of Admidio please [[m.fassbender@admidio.org|contact]] us first. At the same time you can register yourself at [[http://www.transifex.com|Transifex]] and join the [[https://www.transifex.com/admidio/admidio/dashboard/|Admidio Project]]. We will than give you the necessary rights to edit translations in your favorite language at Transifex. After that you are ready to start with the improvements to your language.