Download the PHP package kkhomeriki/nova-translatable without Composer
On this page you can find all versions of the php package kkhomeriki/nova-translatable. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download kkhomeriki/nova-translatable
More information about kkhomeriki/nova-translatable
Files in kkhomeriki/nova-translatable
Package nova-translatable
Short Description Making Nova fields translatable
License MIT
Homepage https://github.com/spatie/nova-translatable
Informations about the package nova-translatable
Making Nova fields translatable
This package contains a Translatable
class you can use to make any Nova field type translatable.
Imagine you have this fields
method in a Post
Nova resource:
That Post
Nova resource will be rendered like this.
Requirements
This Nova field requires Nova 3 specifically and MySQL 5.7.8 or higher.
Support us
We invest a lot of resources into creating best in class open source packages. You can support us by buying one of our paid products.
We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on our contact page. We publish all received postcards on our virtual postcard wall.
Installation
First you must install spatie/laravel-translatable into your Laravel app. In a nutshell, this package will store translations for your model in a json column in your table. On top of that, it provides many handy functions to store and retrieve translations. Be sure to read the entire readme of laravel-translatable before using this Nova package.
Next, you can install this Nova package into a Laravel app that uses Nova via composer:
Usage
In order to use the package you must first let Translatable
know which locales your app is using using the Translatable::defaultLocales()
method. You can put this code in AppServiceProvider
or a dedicated service provider of your own.
Next, you must prepare your model as explained in the readme of laravel-translatable. In short: you must add json
columns to your model's table for each field you want to translate. Your model must use the Spatie\Translatable\HasTranslations
on your model. Finally, you must also add a $translatable
property on your model that holds an array with the translatable attribute names.
Now that your model is configured for translations, you can use Translatable
in the related Nova resource. Any fields you want to display in a multilingual way can be passed as an array to `Translatable.
Customizing the locales per translatable
If you have a Nova resource where you want different locales than the ones configured globally, you can call the locales
method on Translatable
.
These fields will now use the de
and es
locales.
Customizing the name of a translatable
By default translatable fields get ($locale)
appended to their name. You can customize this behaviour globally by providing a closure to displayLocalizedNameByDefaultUsing
on Translatable
. This callback will be used to render the localized field names.
With this in place all names of translatable fields will get [$locale]
appended.
You can also customize the localized field name per resource by passing a closure the displayLocalizedNameUsing
function.
With this in place, the localized field names will be suffixed with --- $locale
.
Of course you can still customize the name of a field as usual.
Using the code about above the name for the title
field will be "My title ['en']".
On customizing the UI
You might wonder why we didn't render the translatable fields in tabs, panels or with magical unicorns displayed next to them. The truth is that everybody wants translations to be displayed a bit different. That's why we opted to keep them very simple for now.
If Nova gains the ability to better structure a long form natively, we'd probably start leveraging that in a new major version of the package.
Testing
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
Credits
License
The MIT License (MIT). Please see License File for more information.