philo / laravel-translate
Translation manager for Laravel 5
Installs: 31 352
Dependents: 2
Suggesters: 0
Security: 0
Stars: 88
Watchers: 9
Forks: 9
Open Issues: 7
Requires
- php: >=5.3.0
- illuminate/support: 5.*
README
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] <group> <line>
So for a example:
php artisan translate:add profile first_name
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
Translation files are dynamically generated in alphabetical order and equally spaced.
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
Clean up
The clean up command will search your files for language strings which are no longer used.
php artisan translate:cleanup
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
<?php
return array(
'search_ignore_folders' => 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.