black-lamp/yii2-translate-panel

Yii2 Translate Panel makes the translation of your application so simple.

Yii2 Translate Panel

Yii2 Translate Panel makes the translation of your application awesome!

This module based on i18n (internalization) module with greatly improved usability in mind (see screen shots below).

Forked from uran1980/yii2-translate-panel.

Installation

Install Yii2

Install and configure Yii2 App Advanced Template

Composer

The preferred way to install this extension is through Composer.

Either run

php composer.phar require black-lamp/yii2-translate-panel "*"

or add

"black-lamp/yii2-translate-panel": "*"

to the require section of your composer.json

Usage

Configure urlManager and "Yii2 Translate Panel" component in common/config/main.php:

return [
    ...
    'components' => [
        ...
        'urlManager' => [
            'class'             => yii\web\UrlManager::className(),
            'enablePrettyUrl'   => true,
            'showScriptName'    => false, // false - means that index.php will not be part of the URLs
        ],
        'i18n' => [
            'class'      => uran1980\yii\modules\i18n\components\I18N::className(),
            'languages'  => ['en', 'de', 'fr', 'it', 'es', 'pt', 'ru'],
            'format'     => 'db',
            'sourcePath' => [
                __DIR__ . '/../../frontend',
                __DIR__ . '/../../backend',
                __DIR__ . '/../../common',
            ],
            'messagePath' => __DIR__  . '/../../messages',
            'translations' => [
                '*' => [
                    'class'           => yii\i18n\DbMessageSource::className(),
                    'enableCaching'   => true,
                    'cachingDuration' => 60 * 60 * 2, // cache on 2 hours
                ],
            ],
        ],
        ...
    ],
    ...
];

Configure "Yii2 Translate Panel" module in backend/config/main.php:

return [
    ...
    'modules' => [
        ...
        'i18n' => [
            'class' => uran1980\yii\modules\i18n\Module::className(),
            'controllerMap' => [
                'default' => uran1980\yii\modules\i18n\controllers\DefaultController::className(),
            ],
            // example for set access control to module (if required):
            'as access' => [
                'class' => yii\filters\AccessControl::className(),
                'rules' => [
                    [
                        'controllers'   => ['i18n/default'],
                        'actions'       => ['index', 'save', 'update', 'rescan', 'clear-cache', 'delete', 'restore'],
                        'allow'         => true,
                        'roles'         => ['translator'],
                    ]
                ],
            ],
        ],
        ...
    ],
    ...
]

Run:

php yii migrate --migrationPath=@uran1980/yii/modules/i18n/migrations

Go to http://backend.yourdomain.com/translations for translating your messages

PHP to DB import

If you have an old project with PHP-based i18n you may migrate to DbSource via console.

Run:

php yii i18n/import @common/messages

where @common/messages is path for app translations

DB to PHP export

Run:

php yii i18n/export @uran1980/yii/modules/i18n/messages uran1980/modules/i18n

where @uran1980/yii/modules/i18n/messages is path for app translations and uran1980/modules/i18n is translations category in DB

Using yii category with DB

Import translations from PHP files

php yii i18n/import @yii/messages

Info

Component uses yii\i18n\MissingTranslationEvent for auto-add of missing translations to database

See Yii2 i18n guide

Author

Ivan Yakovlev, e-mail: uran1980@gmail.com