websafe/zf-mod-zfc-user-i18n

Multi language pack module for the ZF-Commons/ZfcUser module. Currently contains: de_DE, ja_JP, pl_PL translations.

pl_PL, de_DE, ja_jP and ru_RU translations are now merged into ZF-Commons/ZfcUser master branch :-), _(*1)

Translation continues there., _(*2)

WebsafeZfModZfcUserI18n

, _(*3)

Multi language pack module for the ZF-Commons/ZfcUser module., _(*4)

Currently contains following languages/locales/translations:, _(*5)

• de_DE: report an issue with de_DE | edit de_DE.po
• ja_JP: report an issue with ja_JP | edit ja_JP.po
• pl_PL: report an issue with pl_PL | edit pl_PL.po

Each translation is located in a separate repository (linked above). This module (WebsafeZfModZfcUserI18n) simply collects all .po files from coresponding single-language repositories during the build process., _(*6)

For details about the build process see this repositories composer.json -> require-dev and scripts/build/build.sh., _(*7)

• Installation
• Configuration
• Updating
• Contributing
• Compiling

Installation

Chdir into Your projects root directory (where composer.json resides) and run the following command:, _(*8)

~~~~ bash composer require websafe/zf-mod-zfc-user-i18n:dev-master --prefer-dist, _(*9)

Configuration
--------------------------------------------------------------------------------

### Enabling the multi language pack module in Your ZF2 application

In `config/application.conf.php` add `WebsafeZfModZfcUserI18n` after
`ZfcUser`:

~~~~ php
<?php
return array(
    'modules' => array(
        // ...
        'ZfcUser',
        'WebsafeZfModZfcUserI18n',
        // ...
    ),
    // ...
);

Set the locale

This step is not really required - it depends on how the locale is initialized in Your application., _(*10)

In config/global.conf or module/Application/config/module.config.php add:, _(*11)

~~~~ php // ... 'translator' => array( 'locale' => 'AVAILABLE_LOCALE', // ... ), // ..., _(*12)

Replace `AVAILABLE_LOCALE` with `de_DE`, `ja_JP` or `pl_PL`. See list of 
available translations at the [top of this README].



Updating
--------------------------------------------------------------------------------

Chdir into projects root directory (where `composer.json` resides)
and run the following commands:

~~~~ bash
rm -rf ~/.composer/cache/files/websafe/zf-mod-zfc-user-i18n*
composer update websafe/zf-mod-zfc-user-i18n

The rm -rf ... part is needed when the module was installed with --prefer-dist. Without cleaning up the cache before installing - Composer will probably stick to a cached version., _(*13)

Contributing

If You want to help with translation, just:, _(*14)

• edit de_DE.po
• edit ja_JP.po
• edit pl_PL.po

and after all send a pull request., _(*15)

When You're not familiar with editing .po files - simply:, _(*16)

• report an issue with de_DE
• report an issue with ja_JP
• report an issue with pl_PL

If You want to add a new language:, _(*17)

• report an issue and I will create a repo for Your language, compatible with existing single-language module repos.

Compiling .po files to .mo files

There's no need to compile .po files after the installation or before sending pull requests, but if you modify the .po file locally, recompile it by executing the following command in this modules root directory:, _(*18)

~~~~ bash msgfmt -cv -o language/de_DE.mo language/de_DE.po ~~~~, _(*19)