ericlagarda/locally

Laravel 5 User Preferred Localization

This is a fork to use removed package. Credits to Mohammed Isa

Laravel 5 User Preferred Localization

This package allows users to set the prefered site localization. Locales are based on ISO 639-1 standard. It automatically switch the site langage to the user preference. All you have to do is install it and set a locale for the user., _(*1)

Installation

You can install the package via composer, _(*2)

composer require ericlagarda/locally

Then you must configure the service provider by adding this in config/app.php, _(*3)

'providers' => [
  ...
  Smartisan\Locally\LocallyServiceProvider::class,
];

Also, add the middleware to web group in Kernel.php, _(*4)

'web' => [
            ...
            \Smartisan\Locally\Http\Middlewares\LocallyMiddleware::class
        ],

And you must publish the migrations, _(*5)

php artisan vendor:publish --provider="Smartisan\Locally\LocallyServiceProvider" --tag="migrations"

Do not forget to migrate your tables, _(*6)

php artisan migrate

Finally, add the package trait in your User model., _(*7)

class User
{
    use LocallyTrait;
}

Optionally, you can add a Laravel Facade and alias for it in config/app.php, _(*8)

'aliases' => [
  ...
  'Locally'   => \Smartisan\Locally\Facades\Locally::class
];

Usage

Set User Locale

If given language code is not exists, an exception will be thrown., _(*9)

$user->setLocale('en');

Get User Prefered Locale

If user local is not set, the system default locale will be returned., _(*10)

$user->getLocale(); //en

Remove User Prefered Locale

$user->removeLocale();

Supported Locales

An array of supported locales will be returned by scanning resources/lang folder., _(*11)

Locally::getSupportedLocales();

Get Language Code / Name

Two helper functions to get language code or name, _(*12)

Locally::getLanguageCodeByName('english'); //en
Locally::getLanguageNameByCode('en'); //English

License

The MIT License (MIT). Please see License File for more information., _(*13)