notgosu/yii2-i18n-module

Yii2 i18n (internalization) module makes the translation of your application so simple

Yii2 I18N module

Yii2 i18n (internalization) module makes the translation of your application so simple, _(*1)

Installation

Composer

The preferred way to install this extension is through Composer., _(*2)

Either run, _(*3)

php composer.phar require zelenin/yii2-i18n-module "dev-master"

or add, _(*4)

"zelenin/yii2-i18n-module": "dev-master"

to the require section of your composer.json, _(*5)

Usage

Configure I18N component in common config:, _(*6)

'i18n' => [
    'class' => Zelenin\yii\modules\I18n\components\I18N::className(),
    'languages' => ['ru-RU', 'de-DE', 'it-IT']
],

Configure I18N component in backend config:, _(*7)

'modules' => [
    'i18n' => Zelenin\yii\modules\I18n\Module::className()
],

Run:, _(*8)

php yii migrate --migrationPath=@Zelenin/yii/modules/I18n/migrations

Go to http://backend.yourdomain.com/translations for translating your messages, _(*9)

PHP to DB import

If you have an old project with PHP-based i18n you may migrate to DbSource via console., _(*10)

Run:, _(*11)

php yii i18n/import @common/messages

where @common/messages is path for app translations, _(*12)

DB to PHP export

Run:, _(*13)

php yii i18n/export @Zelenin/yii/modules/I18n/messages zelenin/modules/i18n

where @Zelenin/yii/modules/I18n/messages is path for app translations and zelenin/modules/i18n is translations category in DB, _(*14)

Using yii category with DB

Import translations from PHP files, _(*15)

php yii i18n/import @yii/messages

Configure I18N component:, _(*16)

'i18n' => [
    'class'=> Zelenin\yii\modules\I18n\components\I18N::className(),
    'languages' => ['ru-RU', 'de-DE', 'it-IT'],
    'translations' => [
        'yii' => [
            'class' => yii\i18n\DbMessageSource::className()
        ]
    ]
],

Info

Component uses yii\i18n\MissingTranslationEvent for auto-add of missing translations to database, _(*17)

See Yii2 i18n guide, _(*18)

Author

Aleksandr Zelenin, e-mail: aleksandr@zelenin.me, _(*19)