vortgo/laravel-translate

Translate system for laravel project

, _(*1)

Translate entity

About package

This package is intended for adding multi language support to your models. If your application already be working and you need to add one or more aditional languages to your content in database it's be easy., _(*2)

Installation

Require this package in your composer.json, _(*3)

$ composer reqiure vortgo/laravel-translate

Add the service provider to you config file config/app.php, _(*4)

Vortgo\Translate\ModelTranslateServiceProvider::class

Publish vendor, _(*5)

    $ php artisan vendor:publish

Run migration to create table for your translatable content, _(*6)

$ php artisan migrate

Add trait to your model which need to translate and setup your default language for your model, _(*7)

    class Category extends Model
    {
        use Translate;
        protected $defaultLocale = 'en';
    }

Usage

You can create entity with translate as usually:, _(*8)

        Category::create([
            'name' => 'name',
            'ru' => [
                'name' => 'название'
            ],
            'fr' => [
                'name' => 'fr name'
            ]
        ]);

For access the translate value you can use next variant:, _(*9)

Determine when calling, _(*10)

    $category->translate('fr')->name

Use your app locale, _(*11)

    App()->setLocale('fr')
    $category->name

Get all translations attributes for current model, _(*12)

$category->getTranslations('fr')

Bonuses

You can use relations for eager loader your model, _(*13)

    App()->setLocale('fr');
    $item = Item::with('category', 'category.rTranslate')->first();
    $item->category->name;

To array with relation, _(*14)

    App()->setLocale('fr');
    $item = Item::with('category', 'category.rTranslate')->first();
    $item->toArray();
    Result = [
        'id' =>1,
        'item_name' => 'name',
        'category' => [
            'name' => 'fr name'
        ]
    ];

If you want to override function toArray() use translateToArray() in your model, _(*15)

    public function toArray()
    {
        $array = $this->translateToArray(); //parent::toArray()

        // Your code here

        return $array;
    }