xxc / nova-translatable
A Laravel Nova field for spatie/laravel-translatable.
Installs: 3
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 3
Forks: 1
Open Issues: 0
Language:Vue
Requires
- php: >=7.1.0
- spatie/laravel-translatable: ^2.2
This package is auto-updated.
Last update: 2024-11-23 11:03:12 UTC
README
Adds the ability to show and edit translated fields created with spatie/laravel-translatable package.
It will show up in the detail view like this:
And in the edit view like this:
Installation and usage
You can require this package using composer:
composer require xxc/nova-translatable
You can add the field follows:
use xXc\Translatable\Translatable;
Translatable::make('Description'),
Make sure, that you have your Eloquent model setup correct:
- First, you need to add the
Spatie\Translatable\HasTranslations
-trait. - Next, you should create a public property
$translatable
which holds an array with all the names of attributes you wish to make translatable. - Finally, you should make sure that all translatable attributes are set to the
text
-datatype in your database. If your database supportsjson
-columns, use that.
Here's an example of a prepared model:
use Illuminate\Database\Eloquent\Model; use Spatie\Translatable\HasTranslations; class NewsItem extends Model { use HasTranslations; public $translatable = ['name']; }
Defining Locales
Locales can be defined via config file config/translatable.php
(config file can be created via spatie/laravel-translatable package) by adding a locales
array:
// config/translatable.php
return [
...
'locales' => [
'en' => 'English',
'de' => 'German',
'fr' => 'French',
],
];
Alternatively you can "override" the config locales with the locales(...)
method:
Translatable::make('Description')->locales([
'en' => 'English',
'de' => 'German',
]),
Single Line Option
By default the input field on the edit view is a textarea. If you want to change it to a single line input field you can add the singleLine()
option:
Translatable::make('Description')->locales([...])->singleLine(),
Trix Editor
You can use the trix editor for your translated fields by using the trix()
option:
Translatable::make('Description')->trix(),
Index View
By default the locale used when displaying the field on the index view is determined by app()->getLocale()
. To override this you can use the indexLocale($locale)
option:
Translatable::make('Description')->indexLocale('de'),
Simultaneous Tab changing
By default the tabs of the languages change on all displayed fields when you click on one of them
The readOnly option
Added a readonly option for a field
Translatable::make('Description')->readOnly(),
The fieldHookup option
Using fieldHookup() method will trigger the inputted value of one field to be transferred to another. This helps a lot when generating slugs for sef urls. Also - this can be used with a combination with resolveUsing() in order to modify the inputted value of a field