adamibrahim/localization

Laravel 5.6 Localization package with language chooser

Laravel 5.6 Localization package

![Software License][ico-license] ![Coverage Status][ico-scrutinizer] ![Total Downloads][ico-downloads], _(*1)

Laravel 5.6 Localization package with - Language chooser - Different language sessions for website and CMS / back - List of languages stored at Database table languages - At table languages you can set boolean values for [active, default], _(*2)

Demo

You can see working demo, _(*3)

Install

Install the package Via Composer

``` bash $ composer require adamibrahim/localization, <sub>(*4)</sub>

##### If you installing at laravel 5.5 or higher then you may go directly to Publish other wise you will need to edit composer.json, register the Service Provider and middleware

### composer.json

Add this code to your composer.json under the autoload at your main directory

``` bash
"psr-4": {
            "Adam\\Localization\\": "vendor/adamibrahim/localization/src"
        }

Service Provider

At file config/app.php register service provider under * Package Service Providers..., <sub>(*5)</sub>

``` bash Adam\Localization\LocalizationServiceProvider::class,, <sub>(*6)</sub>

##### Middleware 

if you are using Laravel version lower than 5.5 then you need to register the lang middleware at your App\Http\Kernel.php
 - At protected $routeMiddleware = [ ] array add the below code 

``` bash
'lang' => \Adam\Localization\Middleware\Localization::class,

Publishing

Optional publishing flags folder with flags svg images / and config file, <sub>(*7)</sub>

``` bash $ php artisan vendor:publish --tag=Localization --force, <sub>(*8)</sub>

### Database Migrating

run the Artisan migration command 

``` bash
$ php artisan migrate

Seeding

Run the Artisan Seeding command, <sub>(*9)</sub>

``` bash $ php artisan db:seed --class=Adam\Localization\database\seeds\LanguagesTableSeeder, <sub>(*10)</sub>

### Artisan Seed Error
If you receive this Error: 
###### Class Adam\Localization\database\seeds\LanguagesTableSeeder does not exist
Then you may need to dump-autoload by running this command 
``` bash
$ composer dump-autoload

Then run the seeding command once again, <sub>(*11)</sub>

``` bash $ php artisan db:seed --class=Adam\Localization\database\seeds\LanguagesTableSeeder, <sub>(*12)</sub>

### Usage

You need to add 'lang' middleware to all your routes 

``` bash
->middleware('lang')

Add the Bootstrap language change buttons to your website page/s, <sub>(*13)</sub>

``` bash @if (($languages)->count() > 1) , <sub>(*14)</sub>

{{ $lang['abbr'] }}

    <div class="dropdown-menu dropdown-menu-right" aria-labelledby="navbarDropdownMenuLink">
        @foreach($languages as $language)
            <a href="{{ route('language.change', $language->abbr) }}" class="dropdown-item">
                <img src="{{ asset('img/flags/'.$language->flag) }}"> {{$language->native}}
            </a>
        @endforeach
    </div>
</li>

@endif, <sub>(*15)</sub>

Optional you can add different language session if needed for example admin control panel

``` bash
@if (($languages_back)->count() > 1)
    <li class="nav-item dropdown">
        <a class="nav-link dropdown-toggle" href="#" id="navbarDropdownMenuLink" 
        data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
            <img src="{{ asset('img/flags/'.$lang_back['flag']) }}"> {{ $lang_back['abbr'] }}<span class="caret"></span>
        </a>

        <div class="dropdown-menu dropdown-menu-right" aria-labelledby="navbarDropdownMenuLink">
            @foreach($languages_back as $language)
                <a href="{{ route('admin.back.language', $language->abbr) }}" class="dropdown-item">
                    <img src="{{ asset('img/flags/'.$language->flag) }}"> {{$language->native}}
                </a>
            @endforeach
        </div>
    </li>
@endif

Optional The lang_back session set the app locale if the rote prefix is 'admin' if you wish to change the route prefix simple modify prefix at the config file config\localization.php, <sub>(*16)</sub>

Contributing

Contributing

Please see CONTRIBUTING and CODE_OF_CONDUCT for details., <sub>(*17)</sub>

Security

If you discover any security related issues, please email :author_email instead of using the issue tracker., <sub>(*18)</sub>

Credits

• Hostato
• All Contributors

License

The MIT License (MIT). Please see License File for more information., <sub>(*19)</sub>