clusteramaryllis/gettext

Adds localization support to laravel applications with PoEdit and Gettext

laravel-gettext

, _(*1)

Installation

Laravel 5.x Installation, _(*2)

Add the composer repository to your composer.json file:, _(*3)

"require": {
    "clusteramaryllis/gettext": "dev-master"
}

• For Laravel 5.2, checkout 1.3 branch
• For Laravel 5.1, checkout 1.2 branch
• For Laravel 4.2, checkout 0.3 branch

And run composer update. Once finished, register via service provider in config/app.php in the providers array:, _(*4)

'providers' => [

    // ...

    Clusteramaryllis\Gettext\GettextServiceProvider::class,

]

You can also provide static syntax via facade in the aliases array:, _(*5)

'aliases' => [

    // ...

    'Gettext' => Clusteramaryllis\Gettext\Facades\Gettext::class,

]

Publish the configuration file (optional) (will create on config/gettext.php) :, _(*6)

php artisan vendor:publish

Command

Available commands, _(*7)

gettext:create => Generate new .po file, _(*8)

gettext:update => Update existing .po file, _(*9)

Available options, _(*10)

Check with php artisan gettext:create --help or php artisan gettext:update --help, _(*11)

Example, _(*12)

php artisan gettext:create --sources="app/Http/Controllers, resources/views" --destination="resources/locale" --locale="en_US" 

This will generate .po files in resources/locale/en_US/LC_MESSAGES/messages.po & will scan any string that utilize php-gettext function on app/Http/Controllers & resources/views, _(*13)

Once done, you can easily translate your application using tools such as PoEdit., _(*14)

How To

Simple usage, _(*15)

1) Prepare view with strings wrapped with Gettext method or helper, _(*16)

<!-- resources\views\welcome.blade.php -->
{!! __('Welcome to main page') !!}

2) Add your language preferences via config/gettext.php on languages array, _(*17)

languages => [

    // ...,

    'sv' => [
        'locale' => 'sv_SE',
        'encoding' => 'utf-8',
        'plural_forms' => "nplurals=2; plural=(n != 1);",
    ]      
]

3) Run php artisan gettext:create. This will generate .po file in, _(*18)

resources\locale\sv_SE\LC_MESSAGES\messages.po

& ready to scan translated string in app\Http\Controllers & resources\views (Default option)., _(*19)

4) Open the .po file with PoEdit or any similar editors. In PoEdit you need to click update to populate the table with the scanned strings. After that, you can start begin translating., _(*20)

5) Simple routes test, _(*21)

Route::get('/', function() {

    Gettext::bindTextDomain('messages', base_path('resources/locale'));
    Gettext::textDomain('messages');

    Gettext::setLocale(LC_ALL, 'sv_SE.utf-8');

    return view('welcome');
});

Available methods, _(*22)

More detailed method & their parameters can be seen here., _(*23)

Acknowledgements

This package is inspired by laravel-gettext by Nicolás Daniel Palumbo for .po files creation & utilize php-gettext package by Danilo Segan., _(*24)