library localizable

riseno/localizable

The localization plugin for laravel framework

Laravel Localizable

, _(*1)

A small plugin for managing multi-language in database table., _(*2)

Installation

Require this package with composer using the following command:, _(*3)

composer require riseno/localizable

After updating composer, add the service provider to the providers array in config/app.php, _(*4)

Riseno\Localizable\LocalizableServiceProvider::class,

Run artisan command to generate the database migration file, _(*5)

php artisan riseno:localizable:generate user

After generated migration file, open the migration file. Add any column that should be localized., _(*6)

Schema::create('user_localizations', function(Blueprint $table)
{
    $table->increments('id');
    $table->unsignedInteger('user_id');
    $table->string('locale');
    $table->boolean('default')->default(false);
    $table->string('name')->nullable();
    $table->timestamps();
    $table->foreign('user_id')->references('id')->on('users');
});

Once all the columns is added to migration file, run migrate command, _(*7)

php artisan migrate

Go to the model that you want to implement localizable function, and add this trait to the class, _(*8)

use Riseno\Localizable\LocalizableTrait;

class User extends Authenticatable
{
    use LocalizableTrait;

And also two required properties, _(*9)

protected $localizeModel  = UserLocalizations::class;
protected $localizeFields = ['name'];

One more thing, add a localizations method, _(*10)

public function localizations()
{
    return $this->hasMany(UserLocalizations::class, 'user_id', 'id');
}

Usage

The trait has provided a generic method for accessing the localized data,, _(*11)

$user->localize('en_US');
// or access value directly
$user->localize('en_US')->name;

If you want to save / update the localized record, _(*12)

$user->saveLocalize('en_US', ['name' => 'Riseno']);

License

The Laravel Localizable is open-sourced software licensed under the MIT license, _(*13)