mmidu/translatable

Automatic translation of json multilingual fields for Laravel.

dev-master 2020-04-10 07:55 UTC

Requires

• illuminate/support: ~5|~6|~7

Requires (Dev)

• mockery/mockery: ^1.1
• orchestra/testbench: ~3|~4
• phpunit/phpunit: ^8.0
• sempro/phpunit-pretty-print: ^1.0

MIT

• Marco Miduri

• translatable
• laravel

README

Automatic translation of json multilingual fields for Laravel.

usage:

1. add the service provider to config/app.php in the "providers" array like this. 'providers' => [ ... Mmidu\Translatable\TranslatableServiceProvider::class, ... ],

   refresh the config cache with the command

   php artisan config:cache

   and publish the config file with the command

   php artisan vendor:publish --provider "Mmidu\Translatable\TranslatableServiceProvider"

2. use the Translatable trait to the model you want to use it for.

3. set the languages config in the config/translatable.php file, you can add and remove locales.

4. the locale used for the translation has to be put in the session.

5. add the translatable fields in the model's translatable attribute like this

   protected $translatable = [ 'name', 'description' ];

6. the translatable fields must be JSON with the following structure:

   { "it": "nome", "en": "name", "es": "nombre" etc... }

7. access the right locale version through $model->attribute automatically.

   es. Session::put('locale', 'es'); echo $model->name;

   result = 'nombre'

8. Translatable adds two virtual attributes, multilingual_attribute and mulitilingual_attribute_str which give the multilingual version of the translatable attributes in array version. multilingual_attribute gives [] if there are no values, multilingual_attribute_str gives an empty string.

9. Enjoy!