查看“如何进一步汉化FreePBX界面”的源代码

'''Translating FreePBX Manually'''

FreePBX began including the&nbsp;[http://www.gnu.org/software/gettext/ gettext]&nbsp;package for i18n since version 2.5. This makes translating (localization) to your desired language relatively simple using the following steps:&nbsp;

'''&nbsp;Translation files'''

In each modules/&lt;modulename&gt;/i18n directory there is a &lt;modulename&gt;.pot file. This is a template file with all the strings needed for translation. Create a new language directory structure in the i18n directory and copy the &lt;modulename&gt;.pot file to&nbsp;''lang_code''/LC_MESSAGES/&lt;modulename&gt;.po Replace&nbsp;''lang_code''&nbsp;with the proper language code for your translation (hint: see /usr/share/locale<nowiki>/locale.al</nowiki>ias).

'''Note:'''&nbsp;core does not contain an i18n directory as all text for core is located in admin/i18n/''lang_code''/LC_MESSAGES<nowiki>/amp.po</nowiki> - <nowiki>amp.mo</nowiki> and the template file are in admin/i18n.

'''Example'''

You want to translate the backup module to Danish, First check the language code for Danish in <nowiki>locale.al</nowiki>ias. For Danish it is da_DK, then create the directory structure (backup/i18n/da_DK/LC_MESSAGES), then copy the i18n<nowiki>/backup.po</nowiki>t to da_DK/LC_MESSAGES<nowiki>/backup.po</nowiki>.

'''Translating the File'''

Continuing from our above example, in <nowiki>backup.po</nowiki> you will see several "msgid" and "msgstr" name/value pairs. "msgid" contains the string to be translated and "msgstr" will be where you put your translation for the given "msgid". Here's an example from the core module where we translate "Delete Route %s" to Spanish:

<nowiki>#: amp_conf/htdocs/admin/modules/core/page.routing.php:275</nowiki>

<nowiki>#: amp_conf/htdocs/admin/modules/core/page.did.php:141</nowiki>

<nowiki>#, php-format</nowiki>

msgid "Delete Route %s"

msgstr "Agregar Usuario %s"

If you are working in Linux there is a PO-editor called KBabel which you may prefer to use. Otherwise you may also want to check out the cross-platform (Linux/Mac/Windows) editor called&nbsp;[http://www.poedit.net/ Poedit].

'''Compiling your translation file'''

The .po file needs to be compiled into an .mo file before it can be used. To do this, run:

'''''Note:'''''&nbsp;''If you are using KBabel or Poedit, the files are compiled with these programs and you don't have to do the next part''

msgfmt -v &lt;module&gt;.po -o &lt;module&gt;.mo

For example, you have translated the <nowiki>backup.po</nowiki>, to compile it, run:

msgfmt -v <nowiki>backup.po</nowiki> -o <nowiki>backup.mo</nowiki>

You might have some errors to correct, which are usually a result of quoting problems or that you have not updated the header in the .po file. If you have no error and all is good, continue to the next step.

'''Testing your Translation'''

To see your translations at work, you need to update FreePBX's code to include your translation. The file that you'll need to edit is located at /var/www/html/admin/views/men<nowiki>u.ph</nowiki>p (on a default CentOS install), and you'll want to look for the code block shown below:

'''/var/www/html/admin/views<nowiki>/menu.ph</nowiki>p''' 

<nowiki>if($amp_conf['SHOWLANGUAGE']) {</nowiki>

        $out .= '&lt;a id="language-menu-button" '

                . 'class="button-right ui-widget-content ui-state-default"&gt;' . _('Language') . '&lt;/a&gt;';

        $out .= '&lt;ul id="fpbx_lang" style="display:none;"&gt;';

        $out .= '&lt;li data-lang="en_US"&gt;&lt;a href="#"&gt;'. _('English') . '&lt;/a&gt;&lt;/li&gt;';

        $out .= '&lt;li data-lang="bg_BG"&gt;&lt;a href="#"&gt;' . _('Bulgarian') . '&lt;/a&gt;&lt;/li&gt;';

        $out .= '&lt;li data-lang="zh_CN"&gt;&lt;a href="#"&gt;' . _('Chinese') . '&lt;/a&gt;&lt;/li&gt;';

        $out .= '&lt;li data-lang="de_DE"&gt;&lt;a href="#"&gt;' . _('German') . '&lt;/a&gt;&lt;/li&gt;';

        $out .= '&lt;li data-lang="fr_FR"&gt;&lt;a href="#"&gt;' . _('French') . '&lt;/a&gt;&lt;/li&gt;';

        $out .= '&lt;li data-lang="he_IL"&gt;&lt;a href="#"&gt;' . _('Hebrew') . '&lt;/a&gt;&lt;/li&gt;';

        $out .= '&lt;li data-lang="hu_HU"&gt;&lt;a href="#"&gt;' . _('Hungarian') . '&lt;/a&gt;&lt;/li&gt;';

        $out .= '&lt;li data-lang="it_IT"&gt;&lt;a href="#"&gt;' . _('Italian') . '&lt;/a&gt;&lt;/li&gt;';

        $out .= '&lt;li data-lang="pt_PT"&gt;&lt;a href="#"&gt;' . _('Portuguese') . '&lt;/a&gt;&lt;/li&gt;';

        $out .= '&lt;li data-lang="pt_BR"&gt;&lt;a href="#"&gt;' . _('Portuguese (Brasil)') . '&lt;/a&gt;&lt;/li&gt;';

        $out .= '&lt;li data-lang="ru_RU"&gt;&lt;a href="#"&gt;' . _('Russian') . '&lt;/a&gt;&lt;/li&gt;';

        $out .= '&lt;li data-lang="sv_SE"&gt;&lt;a href="#"&gt;' . _('Swedish') . '&lt;/a&gt;&lt;/li&gt;';

        $out .= '&lt;li data-lang="es_ES"&gt;&lt;a href="#"&gt;' . _('Spanish') . '&lt;/a&gt;&lt;/li&gt;';

        $out .= '&lt;/ul&gt;';

}

Once you've located the code block, you'll want to add you code to above the line that shows:

        $out .= '&lt;/ul&gt;';

For example, if you want to add Danish as the new language, you would add the following live above the code block above:

$out .= '&lt;li data-lang="da_DK"&gt;&lt;a href="#"&gt;' . _('Danish') . '&lt;/a&gt;&lt;/li&gt;';

Finally you can test your translations by refreshing your browser window and selecting your new language.&nbsp;If everything looks good, zip up your translated &lt;modules&gt;.po and &lt;modules.&gt;mo files and submit them by creating a New Ticket in our bug tracker. For information on how to do that, please see&nbsp;[file:///E:/display/FOP/Bug+Reporting Bug Reporting].

'''Determining Translation Status'''

The&nbsp;'''languagestatus'''&nbsp;module provides developers insight into the translation status of core modules. To install the module, follow the steps below:

* Click Admin
* Choose Module Admin
* Make sure Unsupported is checked
* Check for Updates
* Install languagestatus

The module provides a menu option under Admin called&nbsp;'''Language Status.&nbsp;'''If you click on this, you will be greeted with a page that tells you to choose a language. If you do not have the language selection dropdown in the menu, complete the following:

* Click Settings
* Choose Advanced Settings
* Set&nbsp;'''Show Language setting'''&nbsp;to True&nbsp;

Choose a language other than English to see how well core modules are translated.