deargonauten/translaravel

A Laravel package which translates all. Routes, models (trait) and strings (gettext-style).

TransLaravel

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

Install

Via Composer, _(*2)

``` bash $ composer require deArgonauten/TransLaravel, <sub>(*3)</sub>

Add the ServiceProvider in: `config/app.php`
``` php
deArgonauten\TransLaravel\TransLaravelServiceProvider::class,

An artisan command is now available. Run it. ``` bash $ php artisan translaravel:install, <sub>(*4)</sub>

And... DONE!

## Usage

First add a language by doing:
``` php
Lang::addLanguage('locale');
// en, nl, de, fr, et cetera

See full list: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes, <sub>(*5)</sub>

String Translations

``` php trans('A string, even with some HTML'); Lang::get('A string, even with some HTML');, <sub>(*6)</sub>

### Model translations
In your models use the Translations Trait like this:

``` php
use deArgonauten\TransLaravel\Translations;

class YourModel extends Model
{
    use Translations;

    private $translatable = ['attribute1', 'attribute2']
}

Use the variable $translatable to fill an array with translatable attributes., <sub>(*7)</sub>

Now you can use: ``` php $model->name; // It will automaticly fetch the translation set in Application. $model->getTranslationFor('attribute', 'locale');, <sub>(*8)</sub>

### Route translations
In your routes file you can use the translations as follow:
``` php
Route::get(
    Lang::route('/this-is-a-page'), function()
    {
        return view('pages.contact');
    });

Helper functions

We hook you up with some helper functions ``` php translateURL('url', 'locale'); // Returns a link in the requested locale. // By omiting the locale parameter it will fetch the current set language., <sub>(*9)</sub>

untranslateURL('url'); // Returns a link in the default language, <sub>(*10)</sub>

translateLink('url', 'name', [parameters], locale); // Returns something like this: trans('name'), <sub>(*11)</sub>

Change log

Please see CHANGELOG for more information what has changed recently., <sub>(*12)</sub>

Contributing

Please see CONTRIBUTING and CONDUCT for details., <sub>(*13)</sub>

Security

If you discover any security related issues, please email mail@deargonauten.com instead of using the issue tracker., <sub>(*14)</sub>

Credits

• [Jason de Ridder][http://deargonauten.com]

License

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