nevadskiy / nova-translatable
Allows you to add translatable fields in Laravel Nova.
Requires
- php: ^7.3|^8.0
- laravel/nova: ~3.0|~4.0
This package is auto-updated.
Last update: 2024-10-17 15:34:50 UTC
README
This package allows you to add translatable fields to Laravel Nova resources.
It is designed to work in tandem with the main nevadskiy/laravel-translatable package, which manages how translations are stored in the database.
🔌 Installation
composer require nevadskiy/nova-translatable
Also make sure the main nevadskiy/laravel-translatable package is installed.
âš™ Demo
The code below shows how to make a Nova resource translatable using the package.
<?php namespace App\Nova; use App\Models\Book as BookModel; use Nevadskiy\Nova\Translatable\PerformsTranslatableQueries; use Nevadskiy\Nova\Translatable\Fields\Text; use Nevadskiy\Nova\Translatable\Fields\Textarea; class Book extends Resource { use PerformsTranslatableQueries; public static $model = BookModel::class; public static $title = 'name'; public static $search = ['id', 'name']; public function fields(Request $request): array { return [ ID::make() ->sortable(), Text::make('Name') ->sortable() ->translatable() ->requiredOnlyFallbackLocale() ->showOnIndexOnlyFallbackLocale() Textarea::make('Description') ->translatable() ->requiredOnlyFallbackLocale(), ]; } }
📄 Documentation
Defining locales
To specify the global list of locales, you can add the following code to the AppServiceProvider
.
use Nevadskiy\Nova\Translatable\Localizer; public function boot(): void { Localizer::locales(['en', 'uk', 'pl', 'cz']); }
Customizing field labels (names)
By default, a name of the translatable field has the following format: Title (en)
.
To customize the name display logic for fields, you can specify the customizer function globally in the AppServiceProvider
.
use Nevadskiy\Nova\Translatable\Fields; public function boot(): void { Localizer::localizeNameUsing(fn (string $name, string $locale) => "{$name} ({$locale})"); }
Searching and sorting
If you want to search or sort models by translatable fields, add a PerformsTranslatableQueries
trait to the resource.
<?php namespace App\Nova; use App\Models\Book as BookModel; use Nevadskiy\Nova\Translatable\PerformsTranslatableQueries; class Book extends Resource { use PerformsTranslatableQueries; }
📑 Changelog
Please see CHANGELOG for more information what has changed recently.
☕ Contributing
Contributions are welcome and will be fully credited.
We accept contributions via Pull Requests.
🔓 Security
If you discover any security related issues, please e-mail me instead of using the issue tracker.
📜 License
The MIT License (MIT). Please see LICENSE for more information.