README

Yii2 translation GUI for better management on translation messages while developing.

Features

Provides a web-based graphical user interface for message translations in YII2
Supports multiple languages and categories
Uses only a single database table
Can generate YII2 standard translation files with one click
Command-line interface to import existing translation files(if any)
Prevents duplicate key entries

Installation

Install With Composer

The preferred way to install this extension is through composer.

php composer.phar require amdz/yii2-translation-gui "dev-master"

Or, you may add

"amdz/yii2-translation-gui": "dev-master"

to the require section of your composer.json file and execute php composer.phar update.

Configuration

Once the extension is installed, simply add the extention to your 'module' section of your application configuration file. Do not forget to add required configuration params as follow:

return [
    'modules' => [
        'translator' => [
            'class' => 'amdz\yii2Translator\Module',
            'languages' => [
                'en-US' => 'English',
                'fa-IR' => 'Farsi',
                //'de-GE' => 'German',
            ],
            'categories' => [
                'app' => 'Application',
            ],
            'defaultLanguage' => 'en-US',
            'defaultCategory' => 'app',
            'messagePath' => '@app/messages', //optional
        ],
        ]
        ...
    ],
];

Migrations

To create the translation database table, execute the following migration:

yii migrate --migrationPath=@amdz/yii2Translator/migrations

Importing existing translation files(if any)

This extension provides a command interface to import existing Yii2 standard translation files into database(if any). Run the following command to import files:

>>> yii translator/import/standard @app/path/to/message/directory

or simply run:

>>> yii translator

for more instructions.

If your app command configuration file is separated, make sure that you've already added the required configuration params to your command configuration file.

amdz / yii2-translation-gui

Maintainers

Details