anacreation/translatable

Translate Model

Overview

This add translation to Eloquent Model, _(*1)

Installation

composer require anacreation/translatable

Eloquent model that use the, _(*2)

namespace App;

use Anacreation\Translatable\traits\TranslatableTrait;
use Illuminate\Database\Eloquent\Model;

class Product extends Model
{
    use TranslatableTrait;
}

can use the following APIs, _(*3)

Usage

Create and update translations

createModelWithTranslations( array $attributes = [], array $content): Model

the $content has a predefine format, _(*4)

$content = [
    "language_code_1"=>[
        "attribute_1" => "value 1",
        "attribute_2" => "value 2",
        "attribute_3" => "value 3",
    ],

    "language_code_2"=>[
        "attribute_1" => "value 4",
        "attribute_2" => "value 5",
        "attribute_3" => "value 6",
    ]
]

$newModel = Model::createModelWithTranslations($attributes, $content);

it create a model instance and save the content, _(*5)

updateTranslations(array $content): void

No matter for create new language transaltion or update existing language. Simple call this funciton. The $content structure is same as above., _(*6)

Retrieve translation

if you have a model with translation as above., _(*7)

then you can, _(*8)

$mode->attribute_1;

this will automatically fetch the translation base on your current locale setting., _(*9)

app()->getLocale();

Fallback

Then defalut fallback is set to false, no fallback if content is null., _(*10)

The fall back system is very simple. if you have set the config fallback_locale and set the eloquent model fallback to true, _(*11)

$model->fallback = true;

then if the translation for particular attribute is null. It will try to get the translation for fallback locale., _(*12)

Retrieve all translation

$translation_array = $model->translatables;

this will return a array as above. The translation array has structure as below:, _(*13)

[
    "language_code_1"=>[
        "attribute_1" => "value 1",
        "attribute_2" => "value 2",
    ],

    "language_code_2"=>[
        "attribute_1" => "value 3",
        "attribute_2" => "value 4",
    ]
]

Delete Translation

deleteTranslatableAttribute( string $key, string $locale = null ): void

This will delete specfic attribute for all or speficied transaltion. If the original translation as below:, _(*14)

[
    "language_code_1"=>[
        "attribute_1" => "value 1",
        "attribute_2" => "value 2",
    ],

    "language_code_2"=>[
        "attribute_1" => "value 3",
        "attribute_2" => "value 4",
    ]
]

We call, _(*15)

    $model->deleteTranslatableAttribute("attribute_2");

the translation will become, _(*16)

[
    "language_code_1"=>[
        "attribute_1" => "value 1",
    ],

    "language_code_2"=>[
        "attribute_1" => "value 3",
    ]
]

if we call, _(*17)

    $model->deleteTranslatableAttribute("attribute_2", "language_code_2");

the result will as below, _(*18)

[
    "language_code_1"=>[
        "attribute_1" => "value 1",
        "attribute_2" => "value 2",
    ],

    "language_code_2"=>[
        "attribute_1" => "value 3",
    ]
]

deleteTranslatableWithLocale(string $locale ): void

This will remove all translation with specified locale. if we call, _(*19)

    $model->deleteTranslatableWithLocale("language_code_2");

the result will as below, _(*20)

[
    "language_code_1"=>[
        "attribute_1" => "value 1",
        "attribute_2" => "value 2",
    ]
]