Laravel Translation Editor
, (*1)
This project allow you to edit your translations directly through the browser and the command line., (*2)
Installation
Require this package with composer:, (*3)
composer require exolnet/laravel-translation-editor
The translation editor will be enabled when the environment variable TRANSLATION_EDITOR_ENABLED
is true
., (*4)
If you don't use package auto-discovery, add the service provider to the providers
array in config/app.php
:, (*5)
Exolnet\Translation\Editor\TranslationEditorServiceProvider::class
Usage
In-app translating
In your development environment, you can enable in-app translation by adding to your .env
the following
environment variable:, (*6)
TRANSLATION_EDITOR_ENABLED=true
You'll then be able to open the editor with alt + click
on all translations using te
or @te
helpers:, (*7)
@te('home.title')
{{ te('home.title') }}
And the editor looks like this:, (*8)
, (*9)
Once saved, you can commit the edited translation files in resources/lang/**/*.php
if you're satisfied., (*10)
Detect potential translations
You can detect most of your potential variable string with the i18n:detect
command. To do so, simply run
``` bash
php artisan i18n:detect, (*11)
By default this command will go through all your `.php` files in the views directory and look for potential variables.
Every time a string is detected, it will ask you if you want to save it and you will have to provide a name
for your variable.
Additionally, you can provide the `--locale` or `-l` option if you want to save the detected variable in another language
than the default one in your Laravel configuration.
## Testing
To run the phpUnit tests, please use:
``` bash
composer test
Contributing
Please see CONTRIBUTING and CODE OF CONDUCT for details., (*12)
Security
If you discover any security related issues, please email security@exolnet.com instead of using the issue tracker., (*13)
Credits
License
Copyright © eXolnet. All rights reserved., (*14)
This code is licensed under the MIT license.
Please see the license file for more information., (*15)