Download the PHP package zai/laravel-eloquent-multilingualization without Composer
On this page you can find all versions of the php package zai/laravel-eloquent-multilingualization. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download zai/laravel-eloquent-multilingualization
More information about zai/laravel-eloquent-multilingualization
Files in zai/laravel-eloquent-multilingualization
Package laravel-eloquent-multilingualization
Short Description Add multilingual support to laravel eloquent models
License MIT
Informations about the package laravel-eloquent-multilingualization
laravel-eloquent-multilingualization
Add multilingual support to your laravel eloquent models in a breeze
Installation
Step 1: Install package
Executing the following command to add the package in your composer.json
For laravel 5.4, add the service provider to app/config/app.php
For laravel 5.5, because of package auto-discovery, there is no need to add service provider to app/config/app.php
Step 2: Migration
Executing the following commands to add translations table. Only one table is needed for translating any Eloquent models
Usage
Use Translatable trait in the model you want to translate
Let's say the model is called Article. In the Article model
Define translatables property in the model
Take the same Article model as example. We want to translate title and body of an article
Add Translation
Using method: addTranslation. It takes an associative array as parameter. Simply put the translation data in the array, including which language it is using key locale.
The method only adds keys that exist in the translatables property of the model. Any other keys will be ignored. If a key in the translatables property is missing in the parameter. It will still be inserted, but the value will become empty string.
If you submit the translation data in the form. In your ArticleTranslationsController, simply using
Remember to include locale input filed in your form, so it can be posted in the request. If addTranslation method is applied to an existing translation, it will update the existing translation with values in the parameter.
Display translation
Using translation attribute provided by the trait, e.g, $article->translation->title. It will return correct translation based on what the current locale is (the value returned by App::getLocale())
For default locale or if the translation of a locale is missing, it will return the values in the model.
Update translation
Using method: updateTranslation. It takes an associative array as parameter. Simply put the updated translation data in the array, including which language it is.
If you update the translation using form, in your ArticleTranslationsController
If you update to a translation which doesn't exist, it will insert a new translation.
Delete a translation
Using method deleteTranslation. It takes a string which specifies which language of the translation you want to delete as parameter.
Delete all translations
Using method deleteTranslations which takes no parmaters
Check translations exist
Using method hasTranslations which takes no paramters. The method returns boolean to indicate if the record has translations or not.
Check translation of a locale exists
Using method hasTranslation. It takes a string as parameter which specifies the locale you are checking. The method returns boolean to indicate if the translation of a specific locale exists or not.
Prevent N+1 problem
To prevent N+1 problem, eager load translations in your model
Appending Values To JSON
Add the attribute translation to the appends property on the model