https://github.com/philonl/laravel-translate

Translation manager for Laravel 5
https://github.com/philonl/laravel-translate

Last synced: 10 days ago
JSON representation

Translation manager for Laravel 5

• Host: GitHub
• URL: https://github.com/philonl/laravel-translate
• Owner: PhiloNL
• Created: 2013-12-16T11:48:59.000Z (almost 11 years ago)
• Default Branch: master
• Last Pushed: 2016-10-06T19:29:47.000Z (about 8 years ago)
• Last Synced: 2024-09-28T22:45:41.158Z (about 1 month ago)
• Language: PHP
• Homepage:
• Size: 49.8 KB
• Stars: 86
• Watchers: 8
• Forks: 8
• Open Issues: 7
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

README

        
Translation manager for Laravel 5

===============

 

Managing translations can be a pain, switching between different language files, adding new strings, keeping everything in sync and removing translations which are no longer being used.

But that's in the past if you install this package!

## Features

Lets take a look at all the features included in this package.

### Adding new translations

To add a new translation you need to open your terminal, and run the following command:

`php artisan translate:add [--bench[="..."]] [--no-entities]  `

So for a example:

`php artisan translate:add profile first_name`

![1](https://f.cloud.github.com/assets/1133950/1894668/f3c1f81e-7af6-11e3-8fe2-65f816b4b9f1.png)

As you can see, you will get the blade syntax returned so you can copy and paste it to your view. Adding variables to your string will result in a different syntax:

`php artisan translate:add profile texts.introduction`

![2](https://f.cloud.github.com/assets/1133950/1894724/3bcc0cc4-7af9-11e3-9c31-5333bc75d19e.png)

Translation files are dynamically generated in alphabetical order and equally spaced.

![3](https://f.cloud.github.com/assets/1133950/1894726/416c9888-7af9-11e3-92f6-88fd2b1b9078.png)

### Removing translations

To remove translations you can use the remove command which has the same syntax as the add command:

`php artisan translate:remove account upgrade`

![4](https://f.cloud.github.com/assets/1133950/1894728/469efada-7af9-11e3-84b3-8fb5e3e648b4.png)

### Clean up

The clean up command will search your files for language strings which are no longer used.

`php artisan translate:cleanup`

![5](https://f.cloud.github.com/assets/1133950/1894729/4bbb9b90-7af9-11e3-8571-d5fccf418c74.png)

Foreach line that was not found, you will get a confirmation if you want to delete the line in question.

In case you you don't want to confirm each line, you can add the `--silent` parameter.

`php artisan translate:cleanup --silent`

By default the clean up command will look through all your language files. In case you want to focus on one specific group, you can add the `--group="account"` parameter.

`php artisan translate:cleanup --group="account"`

## Installation

The package can be installed via Composer by requiring the "philo/laravel-translate": "~2.0" package in your project's composer.json.

```

{

    "require": {

        "laravel/framework": "5.*",

        "philo/laravel-translate": "~2.0"

    },

    "minimum-stability": "dev"

}

```

Next you need to add the service provider to app/config/app.php

```

'providers' => array(

    /*

     * Application Service Providers...

     */

    'Philo\Translate\TranslateServiceProvider',

)

```

## Config

You can publish the config file in case you want to make some adjustments to the clean up command:

`php artisan vendor:publish`

```

 array('commands', 'config', 'database', 'lang', 'start', 'storage', 'tests'),

	'search_exclude_files'  => array('pagination', 'reminders', 'validation'),

	'digg_folders'          => array('app/models', 'app/views', 'app/controllers'),

);

```

#### Notes

When you start using the translation manager you need to make sure that all your translation files are in sync.