yiimaker/yii2-translatable

Translatable behavior aggregates logic of linking translations to the primary model

Wednesday, May 23, 2018
by greeflas
Repository
3 Watchers
6 Stars
465 Installations

PHP
1 Dependents
0 Suggesters
1 Forks
1 Open issues
4 Versions
160 % Grown

The README.md

, _(*1)

, _(*2)

Translatable behavior

, _(*3)

Translatable behavior aggregates logic of linking translations to the primary model., _(*4)

Installation

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

Either run, _(*6)

$ composer require yiimaker/yii2-translatable

or add, _(*7)

"yiimaker/yii2-translatable": "~1.0"

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

Usage

Add behavior to the your primary model

public function behaviors()
{
    return [
        // ...
        'translatable' => [
            'class' => TranslatableBehavior::className(),
            // 'translationRelationName' => 'translations',
            // 'translationLanguageAttrName' => 'language',
            // 'attributeNamePattern' => '%name% [%language%]',
            'translationAttributeList' => [
                'title',
                'description',
            ],
        ],
    ];
}

And use getTranslation() or translateTo() methods

// product is an active record model with translatable behavior
$product = new Product();

// sets translation for default application language
$product->title = 'PhpStrom 2018.1';
$product->description = 'Лицензия PhpStrom IDE версия 2018.1';

// gets translation for English language
$translation = $product->getTranslation('en');
$translation->title = 'PhpStrom 2018.1';
$translation->description = 'License of the PhpStrom IDE version 2018.1';

// sets description for French language
$product->translateTo('fr')->description = 'La licence de PhpStorm IDE la version 2018.1';

$product->insert();

translateTo() it's just an alias for getTranslation() method., _(*9)

After saving the model you can fetch this model from the database and translatable behavior will fetch all translations automatically., _(*10)

$product = Product::find()
    ->where(['id' => 1])
    ->with('translations')
    ->one()
;

// gets translation for English language
$product->translateTo('en')->description; // License of the PhpStrom IDE version 2018.1
// gets translation for French language
$product->translateTo('fr')->description; // La licence de PhpStorm IDE la version 2018.1

// check whether Ukrainian translation not exists
if (!$product->hasTranslation('uk')) {
    $product->translateTo('uk')->description = 'Ліцензія PhpStrom IDE версія 2018.1';
}

// update Enlish translation
$product->translateTo('en')->title = 'PhpStorm IDE';

$product->update();