metalguardian/yii2-i18n-module

Yii2 internalization module

I18n module

Yii2 internalization module, _(*1)

Installation

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

Either run, _(*3)

php composer.phar require --prefer-dist metalguardian/yii2-i18n-module "*"

or add, _(*4)

"metalguardian/yii2-i18n-module": "*"

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

Usage

How to configure component:, _(*6)

'components' => [
    // ...
    'i18n' => [
        'class' => '\metalguardian\i18n\components\I18n',
        // you can configure message sources, which will be used to handle all sources
        'messageSourceConfig' => [
            // here you can change all message source settings
            //'class' => \yii\i18n\DbMessageSource::className(),
        ],
        // you can turn off handling missing translations
        'handleMissing' => true,
        // here you can setup which categories to handle
        'only' => [
            'app',
            '*',
            // for example, you can add 'yii' core category
            //'yii',
        ],
        // do you want to override already configured message sources?
        'override' => true,
         // a list of languages
        'languages' => ['en', 'uk', 'fr', 'es'],
    ],
],

You can handle ALL message sources like this:, _(*7)

'components' => [
    // ...
    'i18n' => [
        'class' => '\metalguardian\i18n\components\I18n',
        'only' => false,
        'override' => true,
        'languages' => ['en', 'uk', 'fr', 'es'],
    ],
],

This will override all other message sources and setup '*' source, which handle all translations in application, _(*8)

If you don't have message tables in your database yet, you may use migrations:, _(*9)

./yii migrate --migrationPath=@vendor/metalguardian/yii2-i18n-module/src/migrations

In admin application you need to configure translation module:, _(*10)

'modules' => [
    // ...
    'i18n' => [
        'class' => 'metalguardian\i18n\Module',
    ],
],

If you set 'i18n' name to the module, you can simply call \metalguardian\i18n\Module::getUrl() to get link to the translation controller, _(*11)

Using this module you can export and import translations from and into database:, _(*12)

Export all messages from database:, _(*13)

./yii message/export ./common/messages

Export only app category from database:, _(*14)

./yii message/export ./common/messages app

Import translations from all files in ./vendor/yiisoft/yii2/messages/. Script will ask you some questions, like category message and language for the importing file, _(*15)

./yii message/import ./vendor/yiisoft/yii2/messages/

You can add override argument to override existing translations with translations stored in files, _(*16)

./yii message/import ./vendor/yiisoft/yii2/messages/   1

Or you can import only one file. Than you need to specify all parameters as arguments:, _(*17)

./yii message/import-file ./vendor/yiisoft/yii2/messages/uk/yii.php yii uk

And if you need override existing translations:, _(*18)

./yii message/import-file ./vendor/yiisoft/yii2/messages/uk/yii.php yii uk 1