PHPackages zakariatlilani/translation-manager - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Localization & i18n](/categories/localization) 4. / 5. zakariatlilani/translation-manager ActiveLibrary[Localization & i18n](/categories/localization) zakariatlilani/translation-manager ================================== Manage your application's translation strings in Filament. 6.0.0(today)00MITPHPPHP ^8.2 Since Jun 26Pushed todayCompare [ Source](https://github.com/ZakariaTlilani/translation-manager)[ Packagist](https://packagist.org/packages/zakariatlilani/translation-manager)[ Docs](https://github.com/zakariatlilani/translation-manager)[ RSS](/packages/zakariatlilani-translation-manager/feed)WikiDiscussions 5.x Synced today READMEChangelog (1)Dependencies (6)Versions (2)Used By (0) Translation Manager =================== [](#translation-manager) [![filament-translation-manager-art](https://raw.githubusercontent.com/ZakariaTlilani/ZakariaTlilani/main/art/TranslationManager/filament-translation-manager-banner.png)](https://github.com/ZakariaTlilani/translation-manager)[![Latest Version on Packagist](https://camo.githubusercontent.com/954361315c8dcfdc00adabbde04f12671105233e1b07a229c87936e7b9f61013/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f5a616b61726961546c696c616e692f7472616e736c6174696f6e2d6d616e616765722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ZakariaTlilani/translation-manager)[![Total Downloads](https://camo.githubusercontent.com/8304ec6eb73d6e809cdcc610bf5a3436ea62b1a4813c68e8abd714fd958cdb12/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f5a616b61726961546c696c616e692f7472616e736c6174696f6e2d6d616e616765722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ZakariaTlilani/translation-manager) 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. [![filament-translation-manager-art](https://raw.githubusercontent.com/ZakariaTlilani/ZakariaTlilani/main/art/TranslationManager/translation-manager-promo.png)](https://github.com/ZakariaTlilani/translation-manager)Installation ------------ [](#installation) You can install the package via composer: Install via Composer. Plugin VersionFilament VersionPHP Version<= 3.x2.x> 8.04.x3.x> 8.15.x4.x or 5.x> 8.2``` composer require ZakariaTlilani/translation-manager ``` This package uses `spatie/laravel-translation-loader`, publish their migration file using: ``` php artisan vendor:publish --provider="Spatie\TranslationLoader\TranslationServiceProvider" --tag="translation-loader-migrations" php artisan migrate ``` 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 [](#custom-theme-required) In order to compile the package views correctly, we need to [create a custom Filament theme](https://filamentphp.com/docs/3.x/panels/themes#creating-a-custom-theme) **first**, and then add the following path to its content. In the `theme.css` file of the theme, add the following line: ``` @source '../../../../vendor/ZakariaTlilani/translation-manager/resources/**/*.blade.php'; ``` Register the plugin with a panel -------------------------------- [](#register-the-plugin-with-a-panel) ``` use ZakariaTlilani\TranslationManager\TranslationManagerPlugin; use Filament\Panel; class AdminPanelProvider extends PanelProvider { public function panel(Panel $panel): Panel { return $panel // ... ->plugin(TranslationManagerPlugin::make()); } } ``` Configuration ------------- [](#configuration) **From version 5.x onwards, the main configuration is done through the plugin class.** The traditional config file is still supported for compatibility, but all new configurations should be done through the plugin. ### Plugin Configuration [](#plugin-configuration) Configure the plugin using fluent method chaining: ``` use ZakariaTlilani\TranslationManager\TranslationManagerPlugin; TranslationManagerPlugin::make() ->availableLocales([ ['code' => 'en', 'name' => 'English', 'flag' => 'gb'], ['code' => 'nl', 'name' => 'Nederlands', 'flag' => 'nl'], ['code' => 'fr', 'name' => 'Français', 'flag' => 'fr'], ['code' => 'de', 'name' => 'Deutsch', 'flag' => 'de'], ]) ->languageSwitcher(true) ->languageSwitcherRenderHook('panels::user-menu.before') ->navigationGroup('Settings') ->navigationIcon('heroicon-o-globe-alt') ->showFlags(true) ->disableKeyAndGroupEditing(false) ->quickTranslateNavigationRegistration(true) ->dontRegisterNavigationOnPanelIds(['guest']) ->prependDirectoryPathToGroupName(false) ``` #### Available Configuration Methods [](#available-configuration-methods) - `availableLocales(array $locales)` - Set available application locales - `disableKeyAndGroupEditing(bool $disable = true)` - Control key/group editing - `languageSwitcher(bool $enable = true)` - Enable/disable language switcher - `languageSwitcherRenderHook(string $hook)` - Set render hook for language switcher - `navigationGroupTranslationKey(?string $key)` - Set navigation group translation key - `navigationGroup(?string $group)` - Set navigation group - `cluster(?string $cluster)` - Set cluster - `navigationIcon(mixed $icon)` - Set navigation icon (supports `false` to disable) - `quickTranslateNavigationRegistration(bool $register = true)` - Control quick translate navigation - `dontRegisterNavigationOnPanelIds(array $panelIds)` - Exclude panels from navigation - `showFlags(bool $show = true)` - Show flags in language switcher - `prependDirectoryPathToGroupName(bool $prepend = true)` - Control group naming ### Config File [](#config-file) You can run the following command to publish the configuration file: ``` php artisan vendor:publish --tag=translation-manager-config ``` Authorization ------------- [](#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](https://laravel.com/docs/master/authorization#gates). ### Legacy Configuration Examples [](#legacy-configuration-examples) #### `available_locales` [](#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` [](#language_switcher) Enable or disable the language switcher feature. This allows users to switch their language - disable if you have your own implementation. [![Language Switcher](https://raw.githubusercontent.com/ZakariaTlilani/translation-manager/4.x/.github/language-switcher.png)](https://raw.githubusercontent.com/ZakariaTlilani/translation-manager/4.x/.github/language-switcher.png) #### `dont_register_navigation_on_panel_ids` [](#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 [](#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 ----- [](#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. Upgrade Guide ------------- [](#upgrade-guide) ### Upgrading to Filament 5.x (Livewire 4) [](#upgrading-to-filament-5x-livewire-4) Filament 5 introduces **Livewire 4 + Tailwind 4** support. There are **no API breaking changes** — your plugin configuration and panel setup remain identical. #### Prerequisites [](#prerequisites) - **PHP**: 8.2+ - **Laravel**: 11.28+ - **Filament**: Upgrade to Filament 5.x - **Livewire**: Upgrade to Livewire 4.x #### Step 1: Upgrade Filament and Livewire [](#step-1-upgrade-filament-and-livewire) ``` composer require livewire/livewire:"^4.0" filament/filament:"^5.0" -W ``` #### Step 2: Run the Filament upgrade script [](#step-2-run-the-filament-upgrade-script) ``` composer require filament/upgrade:"^5.0" -W --dev vendor/bin/filament-v5 ``` #### Step 3: Rebuild your theme assets [](#step-3-rebuild-your-theme-assets) Filament 5 requires **Tailwind CSS v4**. Rebuild your custom theme after upgrading: ``` npm install && npm run build ``` > No changes are required to your `TranslationManagerPlugin` configuration or any Blade views — everything works as-is with Filament 5. --- ### Upgrading from 4.x to 5.x [](#upgrading-from-4x-to-5x) Version 5.x introduces **Filament v4 support** and a **new plugin-based configuration system**. Follow these steps to upgrade: #### Prerequisites [](#prerequisites-1) - **PHP**: Upgrade to PHP 8.2+ - **Filament**: Upgrade to Filament 4.x #### Step 1: Theme Configuration (Required) [](#step-1-theme-configuration-required) **Breaking Change**: Filament v4 requires a different approach for including package assets. **Remove from `tailwind.config.js` (if present):** ``` // Remove this from your tailwind.config.js content array: "./vendor/ZakariaTlilani/translation-manager/resources/**/*.blade.php"; ``` **Add to your custom theme CSS file:** 1. Create a custom theme if you don't have one ([Filament v4 theme docs](https://filamentphp.com/docs/4.x/panels/themes#creating-a-custom-theme)) 2. Add this line to your theme's CSS file: ``` @source '../../../../vendor/ZakariaTlilani/translation-manager/resources/**/*.blade.php'; ``` #### Step 2: Migrate Configuration (Recommended) [](#step-2-migrate-configuration-recommended) Migrate your config file settings to the plugin configuration: ``` // In your AdminPanelProvider.php use ZakariaTlilani\TranslationManager\TranslationManagerPlugin; public function panel(Panel $panel): Panel { return $panel ->plugin( TranslationManagerPlugin::make() ->availableLocales([ ['code' => 'en', 'name' => 'English', 'flag' => 'gb'], ['code' => 'nl', 'name' => 'Nederlands', 'flag' => 'nl'], ['code' => 'fr', 'name' => 'Français', 'flag' => 'fr'], ]) ->languageSwitcher(true) ->languageSwitcherRenderHook('panels::user-menu.before') ->navigationGroup('Settings') ->navigationIcon('heroicon-o-globe-alt') ->showFlags(true) ->disableKeyAndGroupEditing(false) ->quickTranslateNavigationRegistration(true) ->dontRegisterNavigationOnPanelIds(['guest']) ); } ``` License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 41 — FairBetter than 87% of packages Maintenance100 Actively maintained with recent releases Popularity0 Limited adoption so far Community16 Small or concentrated contributor base Maturity45 Maturing project, gaining track record Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 2 Last Release 0d ago Major Versions 5.x-dev → 6.0.02026-06-26 ### Community Maintainers ![](https://www.gravatar.com/avatar/4d4a410fb650e270485c131ed01ac8a6e84ff9ee030dbcc85e3ef6d148eca38b?d=identicon)[zakaria tlilani](/maintainers/zakaria%20tlilani) --- Top Contributors [![Jehizkia](https://avatars.githubusercontent.com/u/8775667?v=4)](https://github.com/Jehizkia "Jehizkia (69 commits)")[![musa11971](https://avatars.githubusercontent.com/u/21341801?v=4)](https://github.com/musa11971 "musa11971 (43 commits)")[![daar](https://avatars.githubusercontent.com/u/865062?v=4)](https://github.com/daar "daar (5 commits)")[![nahime0](https://avatars.githubusercontent.com/u/436702?v=4)](https://github.com/nahime0 "nahime0 (5 commits)")[![mansoorkhan96](https://avatars.githubusercontent.com/u/51432274?v=4)](https://github.com/mansoorkhan96 "mansoorkhan96 (4 commits)")[![GoodM4ven](https://avatars.githubusercontent.com/u/121377476?v=4)](https://github.com/GoodM4ven "GoodM4ven (4 commits)")[![ZakariaTlilani](https://avatars.githubusercontent.com/u/116965173?v=4)](https://github.com/ZakariaTlilani "ZakariaTlilani (3 commits)")[![musta20](https://avatars.githubusercontent.com/u/46521416?v=4)](https://github.com/musta20 "musta20 (3 commits)")[![DevOashim](https://avatars.githubusercontent.com/u/179505619?v=4)](https://github.com/DevOashim "DevOashim (2 commits)")[![Danoctum](https://avatars.githubusercontent.com/u/18471218?v=4)](https://github.com/Danoctum "Danoctum (2 commits)")[![Skullbock](https://avatars.githubusercontent.com/u/1104083?v=4)](https://github.com/Skullbock "Skullbock (2 commits)")[![edstevo](https://avatars.githubusercontent.com/u/9676607?v=4)](https://github.com/edstevo "edstevo (2 commits)")[![lakuapik](https://avatars.githubusercontent.com/u/20186786?v=4)](https://github.com/lakuapik "lakuapik (1 commits)")[![buzkall](https://avatars.githubusercontent.com/u/5702?v=4)](https://github.com/buzkall "buzkall (1 commits)")[![pardalsalcap](https://avatars.githubusercontent.com/u/264531?v=4)](https://github.com/pardalsalcap "pardalsalcap (1 commits)")[![sinan-aydogan](https://avatars.githubusercontent.com/u/1011324?v=4)](https://github.com/sinan-aydogan "sinan-aydogan (1 commits)") --- Tags laravellocalizationtranslationfilamentZakariaTlilani ### Embed Badge ![Health badge](/badges/zakariatlilani-translation-manager/health.svg) ``` [![Health](https://phpackages.com/badges/zakariatlilani-translation-manager/health.svg)](https://phpackages.com/packages/zakariatlilani-translation-manager) ``` ### Alternatives [kenepa/translation-manager Manage your application's translation strings in Filament. 14792.4k2](/packages/kenepa-translation-manager)[rawilk/profile-filament-plugin Profile & MFA starter kit for filament. 3913.7k](/packages/rawilk-profile-filament-plugin)[stephenjude/filament-jetstream A Laravel starter kit built with Filament inspired by Jetstream. 17758.9k2](/packages/stephenjude-filament-jetstream)[stephenjude/filament-two-factor-authentication Filament Two Factor Authentication: Google 2FA + Passkey Authentication 84192.9k8](/packages/stephenjude-filament-two-factor-authentication)[marcelweidum/filament-passkeys Use passkeys in your filamentphp app 6643.3k1](/packages/marcelweidum-filament-passkeys)[osama-98/laravel-enum-translatable A Laravel package that provides translatable enum functionality with easy-to-use methods for working with enum values and their translations 561.1k](/packages/osama-98-laravel-enum-translatable) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)