LLH is a set of tools to help you manage translations in your Laravel project.
1 - Add the following line in the require-dev
array of the composer.json
file :
"potsky/laravel-localization-helpers" : "~1.1"
2 - Update your installation : composer update
3 - Add one of the following lines in the providers
array of the app/config/app.php
configuration file :
Laravel 4: 'Potsky\LaravelLocalizationHelpers\LaravelLocalizationHelpersServiceProvider',
Laravel 5: 'Potsky\LaravelLocalizationHelpers\LaravelLocalizationHelpersServiceProviderLaravel5',
Now execute php artisan list
and you should view the new localization commands:
...
key
key:generate Set the application key
localization
localization:find Display all files where the argument is used as a lemma
localization:missing Parse all translations in app directory and build all lang files
migrate
migrate:install Create the migration repository
...
To configure your fresh installed package, please create a configuration file by executing :
For Laravel 4: php artisan config:publish potsky/laravel-localization-helpers
For Laravel 5: php artisan vendor:publish
Then you can modify the configuration in file app/config/packages/potsky/laravel-localization-helpers/config.php
(Laravel 4) or app/config/laravel-localization-helpers.php
(Laravel 5).
Add new folders to search for, add your own lang methods or functions, ...
This command parses all your code and generate according lang files in all lang/XXX/
directories.
Use php artisan help localization:missing
for more informations about options.
php artisan localization:missing
php artisan localization:missing -n
php artisan localization:missing -b
php artisan localization:missing -o
php artisan localization:missing -c
php artisan localization:missing -d
3 commands below produce the same output:
php artisan localization:missing
php artisan localization:missing -l
php artisan localization:missing -l "%LEMMA"
You can customize the default generated values for unknown lemmas.
The following command let new values empty:
php artisan localization:missing -l ""
The following command prefixes all lemmas values with "Please translate this : "
php artisan localization:missing -l "Please translate this : %LEMMA"
The following command prefixes all lemmas values with "Please translate this !"
php artisan localization:missing -l 'Please translate this !'
#!/bin/bash
php artisan localization:missing -s
if [ $? -eq 0 ]; then
echo "Nothing to do dude, GO for release"
else
echo "I will not release in production, lang files are not clean"
fi
php artisan localization:missing -r
php artisan localization:missing -e
You can edit the editor path in your configuration file. By default, editor is Sublime Text on Mac OS X :
'editor_command_line' => '/Applications/Sublime\\ Text.app/Contents/SharedSupport/bin/subl'
This command will search in all your code for the argument as a lemma.
Use php artisan help localization:find
for more informations about options.
php artisan localization:find Search
php artisan localization:find -v Search
php artisan localization:find -s "Search me"
php artisan localization:find -s -r "@Search.*@"
php artisan localization:find -s -r "/.*me$/"
PCRE functions are used
Use the github issue system to open a issue and ask for something.
- add resource folder for Laravel 5
- add full support for Laravel 5
- add support for @lang and @choice in Blade templates (by Jesper Ekstrand)
- add
lang_folder_path
parameter in configuration file to configure the custom location of your lang files - check lang files in
app/lang
by default for Laravel 4.x - check lang files in
app/resources/lang
by default for Laravel 5
- support for Laravel 5 (4.3)
- add
ignore_lang_files
parameter in configuration file to ignore lang files (useful forvalidation
file for example)