mmelcor/yii2-babelfish

Monday, April 2, 2018
by mmelcor
Repository
3 Watchers
2 Stars
43 Installations

PHP
0 Dependents
0 Suggesters
0 Forks
0 Open issues
23 Versions
0 % Grown

The README.md

Yii2 Babel Fish

The Yii2 Babelfish symbiote is a portal to edit and update translations., _(*1)

Key Features

Uses it's own database for RBAC and user identities that can be shared across multiple instances of babelfish, allowing for easy translator management for several applications in one spot.
Properly escapes tags and special syntax so the tranlator doesn't need to know how to do so.
Uses AdminLTE and Redactor for an intuitive user experience
Intended to be used with Yii2 Advanced Template

Installation

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

Either run, _(*3)

php composer.phar require --prefer-dist mmelcor/yii2-babelfish "*"

or add, _(*4)

"mmelcor/yii2-babelfish": "*"

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

Configuration

Once the extension is installed :, _(*6)

Dependency Configuration, _(*7)

Follow configuration for oorrwullie\yii2-babelfishfood. Once this has been completed continue configuring the remaining dependencies:, _(*8)

Filesystem Configuration Configure your file system component. This package comes with creocoder\flysystem\AwsS3FileSystem by default as that is what we use. You may use any of those supported by trntv/yii2-file-kit. Place the following in the common/config/main.php file, or similar depending on your file system., _(*9)

'components' => [
    'awss3Fs' => [
        'class' => 'creocoder\flysystem\AwsS3Filesystem',
        'key' => '[AWS key]',
        'secret' => '[AWS Secret]',
        'region' => '[region]',
        'bucket' => '[bucket name]',
        'prefix' => '[prefix folder path]',
        'baseUrl' => '[S3 base url path]'
    ],
    '...',
],

for additional information or options checkout creocoder\Flysystem. Feel free to use any of the other file system options they support., _(*10)

Configure babelFileStorage place the following also in common/config/main.php. The file storage step is required to follow the file system set up as it uses the file system as the route for storing the uploaded files. File storage is required to support the uploading of users' avatars, and potential future features., _(*11)

'components' => [
    '...',
    'babelFileStorage' => [ //this must be the component name, as it is being used in the module.
        'class' => 'trntv\filekit\Storage',
        'filesystemComponent' => 'awss3Fs', //or whichever file system you are using.
        'baseUrl' => '[Your base url path]'
    ],
    '...',
],

If you have trouble see trntv/yii2-file-kit documentation., _(*12)

Module Configuration, _(*13)

Create a new database to house babelfish specific RBAC and Users., _(*14)

Add babelfishDb to common/config/main-local.php. This component must be named babelfishDb as that is the component the module will be looking for., _(*15)

'components' => [
    '. . .',
    'babelfishDb' => [
        'class' => 'yii\db\Connection',
        'dsn' => 'mysql:host=localhost;dbname=[database name],
        'username' => '[username]',
        'password' => '[password]',
        'charset' => 'utf8',
    ],
],

Config Init module by setting up the Module and bootstrapping it in console/config/main.php. This module will be used to install database migrations and setup the initial super user for the module. Example setup:, _(*16)
```
    'bootstrap' => ['log', 'babelfish-init'],
    'modules' => [
        'babelfish-init' => 'mmelcor\babelfish\Init',
    ],
```

Config babelfish module in frontend/config/main.php by placing the following in the modules section:, _(*17)


'modules' => [
    'babel' => [
        'class' => 'mmelcor\babelfish\Module',
        'cookieValidationKey' => '[CSRF Key]', //you will need to generate a unique validation key.
    ],
],

Run console commands, _(*18)

Once the configuration has been completed next run the following console commands:, _(*19)

./yii babelfish-init This creates the RBAC tables and users table in the babelfish users., _(*20)
./yii babelfish-init/load-rbac This will load the RBAC roles and rules into the database., _(*21)
./yii babelfish-init/signup This will create the initial super user for administration., _(*22)

Add Translation Hooks, _(*23)

Add the following babelfish necessary translation hooks to the common/config/main.php i18n section:, _(*24)

'i18n' => [
    'translations' => [
        '. . .',
        'base*' => [
            'class' => 'yii\i18n\GettextMessageSource',
            'useMoFile' => false,
            'basePath' => '@common/messages',
        ],
        'babelfish*' => [
            'class' => 'yii\i18n\GettextMessageSource',
            'useMoFile' => false,
            'basePath' => '@common/messages',
        ],
    ],
],

Implementation

Once this has all been completed you should be able to navigate to yourdomain.com/babel. If everything has been installed and configured correctly you should see the following screen:, _(*25)

babelfish login screenshot , _(*26)

The Versions

02/04 2018

0.1

0.1.0.0

library yii2-babelfish

mmelcor/yii2-babelfish

The README.md

Yii2 Babel Fish

Key Features

Installation

Configuration

Implementation

The Versions

0.1

dev-master

The Requires

by Jeremiah Payne

by Kevin Payne

1.1

The Requires

by Jeremiah Payne

by Kevin Payne

1.0

The Requires

by Jeremiah Payne

by Kevin Payne

0.6.5

The Requires

by Jeremiah Payne

by Kevin Payne

0.6.4

The Requires

by Jeremiah Payne

by Kevin Payne

0.6.3

The Requires

by Jeremiah Payne

by Kevin Payne

0.6.2

The Requires

by Jeremiah Payne

by Kevin Payne

0.6.1

The Requires

by Jeremiah Payne

by Kevin Payne

0.6

The Requires

by Jeremiah Payne

by Kevin Payne

0.5.8

The Requires

by Jeremiah Payne

by Kevin Payne

0.5.7

The Requires

by Jeremiah Payne

by Kevin Payne

0.5.6

The Requires

by Jeremiah Payne

by Kevin Payne

0.5.5

The Requires

by Jeremiah Payne

by Kevin Payne

0.5.4

The Requires

by Jeremiah Payne

by Kevin Payne

0.5.3

The Requires

by Jeremiah Payne

by Kevin Payne

0.5.2

The Requires

by Jeremiah Payne

by Kevin Payne

0.5.1

The Requires

by Jeremiah Payne

by Kevin Payne

0.5

The Requires