kenepa / translation-manager
Manage your application's translation strings in Filament.
Installs: 26 015
Dependents: 1
Suggesters: 0
Security: 0
Stars: 90
Watchers: 3
Forks: 28
Open Issues: 2
Requires
- php: ^8.1
- filament/filament: ^3.0
- filament/notifications: ^3.0.0
- spatie/laravel-package-tools: ^1.15.0
- spatie/laravel-translation-loader: ^2.7
- stijnvanouplines/blade-country-flags: ^1.0
Requires (Dev)
- tightenco/duster: ^2.0
This package is auto-updated.
Last update: 2024-11-16 08:53:06 UTC
README
Introducing our Filament translation management tool, which allows you to easily manage, preview, and sync translations with your language files all within your Filament admin dashboard. Say goodbye to relying on developers to edit language files and streamline your localization workflow today.
Installation
You can install the package via composer:
Install via Composer.
composer require kenepa/translation-manager
You can run the following command to publish the configuration file:
php artisan vendor:publish --tag=translation-manager-config
This package uses spatie/laravel-translation-loader
, publish their migration file using:
php artisan vendor:publish --provider="Spatie\TranslationLoader\TranslationServiceProvider" --tag="migrations"
You have to update the migration file to the following:
Schema::create('language_lines', function (Blueprint $table) { $table->bigIncrements('id'); $table->string('group')->index(); $table->string('key')->index(); $table->json('text')->default(new \Illuminate\Database\Query\Expression('(JSON_ARRAY())')); $table->timestamps(); });
Finally, run the migration.
Custom Theme Required
In order to compile the package views correctly, we need to create a custom Filament theme first, and then add the following path to its content:
// Located at: /resources/css/filament/admin/tailwind.config.js import preset from '../../../../vendor/filament/filament/tailwind.config.preset'; export default { presets: [preset], content: [ // other content... './vendor/kenepa/translation-manager/resources/**/*.blade.php', ], };
Register the plugin with a panel
use Kenepa\TranslationManager\TranslationManagerPlugin; use Filament\Panel; class AdminPanelProvider extends PanelProvider { public function panel(Panel $panel): Panel { return $panel // ... ->plugin(TranslationManagerPlugin::make()); } }
Authorization
By default, the translation manager cannot be used by anyone. You need to define the following gate in your AppServiceProvider
boot method:
// app/Providers/AppServiceProvider.php use Illuminate\Support\Facades\Gate; /** * Bootstrap any application services. */ public function boot(): void { Gate::define('use-translation-manager', function (?User $user) { // Your authorization logic return $user !== null && $user->hasRole('admin'); }); }
If you want to learn more about gates, check out the official documentation.
Configuration
available_locales
Determines which locales your application supports. For example:
'available_locales' => [ ['code' => 'en', 'name' => 'English', 'flag' => 'gb'], ['code' => 'nl', 'name' => 'Nederlands', 'flag' => 'nl'], ['code' => 'de', 'name' => 'Deutsch', 'flag' => 'de'] ]
language_switcher
Enable or disable the language switcher feature. This allows users to switch their language - disable if you have your own implementation.
dont_register_navigation_on_panel_ids
Disable registering the translation manager navigation on certain panel IDs. The following will disable the translation navigation for the guest panel but still allow guest panel users to change the language.
'dont_register_navigation_on_panel_ids' => [ 'guest' ],
Adding to cluster
Example of adding the translation manager to a cluster:
// config/translation-manager.php [ // ...Other config 'cluster' => \App\Filament\Clusters\Products::class, ]
Usage
Once installed, the Translation Manager can be accessed via the Filament sidebar menu. Simply click on the "Translation Manager" link to access the translation management screen.
License
The MIT License (MIT). Please see License File for more information.