PHPackages                             kenepa/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. kenepa/translation-manager

ActiveLibrary[Localization & i18n](/categories/localization)

kenepa/translation-manager
==========================

Manage your application's translation strings in Filament.

5.0.2(6mo ago)14583.6k↓13.9%34[3 PRs](https://github.com/kenepa/translation-manager/pulls)2MITPHPPHP ^8.2

Since Apr 2Pushed 6mo ago4 watchersCompare

[ Source](https://github.com/kenepa/translation-manager)[ Packagist](https://packagist.org/packages/kenepa/translation-manager)[ Docs](https://github.com/kenepa/translation-manager)[ RSS](/packages/kenepa-translation-manager/feed)WikiDiscussions 5.x Synced 1mo ago

READMEChangelog (10)Dependencies (6)Versions (33)Used By (2)

Translation Manager
===================

[](#translation-manager)

[![filament-translation-manager-art](https://raw.githubusercontent.com/kenepa/Kenepa/main/art/TranslationManager/filament-translation-manager-banner.png)](https://github.com/kenepa/translation-manager)[![Latest Version on Packagist](https://camo.githubusercontent.com/adfa70109f067388f3008c0701565f1e738e6667cbc4822e97a96c8899de2ed4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6b656e6570612f7472616e736c6174696f6e2d6d616e616765722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/kenepa/translation-manager)[![Total Downloads](https://camo.githubusercontent.com/6cd47ec41bb4a383b8bae6c48fa041f91471d1ca88ed740882a4ea9e9bfb662a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6b656e6570612f7472616e736c6174696f6e2d6d616e616765722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/kenepa/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/kenepa/Kenepa/main/art/TranslationManager/translation-manager-promo.png)](https://github.com/kenepa/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> 8.2```
composer require kenepa/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/kenepa/translation-manager/resources/**/*.blade.php';
```

Register the plugin with a panel
--------------------------------

[](#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());
    }
}
```

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 Kenepa\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/kenepa/translation-manager/4.x/.github/language-switcher.png)](https://raw.githubusercontent.com/kenepa/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 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)

- **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/kenepa/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/kenepa/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 Kenepa\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

56

—

FairBetter than 98% of packages

Maintenance67

Regular maintenance activity

Popularity50

Moderate usage in the ecosystem

Community28

Small or concentrated contributor base

Maturity68

Established project with proven stability

 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 ~31 days

Recently: every ~38 days

Total

31

Last Release

195d ago

Major Versions

1.0.5 → 2.0.02023-05-09

2.0.1 → 3.0.02023-05-22

3.0.1 → 4.0.02023-08-17

3.x-dev → 4.0.12023-09-04

4.x-dev → 5.0.02025-09-04

PHP version history (2 changes)1.0.0PHP ^8.1

5.0.0PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/401929a03ca00ed1785ae3f46778422e6b47366ff5eec6f4e8f4a9adc6dfa9a7?d=identicon)[jefta](/maintainers/jefta)

---

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)")[![GoodM4ven](https://avatars.githubusercontent.com/u/121377476?v=4)](https://github.com/GoodM4ven "GoodM4ven (4 commits)")[![mansoorkhan96](https://avatars.githubusercontent.com/u/51432274?v=4)](https://github.com/mansoorkhan96 "mansoorkhan96 (4 commits)")[![musta20](https://avatars.githubusercontent.com/u/46521416?v=4)](https://github.com/musta20 "musta20 (3 commits)")[![Skullbock](https://avatars.githubusercontent.com/u/1104083?v=4)](https://github.com/Skullbock "Skullbock (2 commits)")[![Danoctum](https://avatars.githubusercontent.com/u/18471218?v=4)](https://github.com/Danoctum "Danoctum (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)")[![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)")[![buzkall](https://avatars.githubusercontent.com/u/5702?v=4)](https://github.com/buzkall "buzkall (1 commits)")

---

Tags

laravellocalizationtranslationfilamentKenepa

### Embed Badge

![Health badge](/badges/kenepa-translation-manager/health.svg)

```
[![Health](https://phpackages.com/badges/kenepa-translation-manager/health.svg)](https://phpackages.com/packages/kenepa-translation-manager)
```

###  Alternatives

[abdulmajeed-jamaan/filament-translatable-tabs

Simplifying managing json based translation columns using tabs

3755.2k1](/packages/abdulmajeed-jamaan-filament-translatable-tabs)[craft-forge/filament-language-switcher

Zero-config language switcher for Filament admin panels. Automatically scans available translations, renders dropdown with country flags, persists selection via sessions.

1016.4k](/packages/craft-forge-filament-language-switcher)[andrewdwallo/transmatic

Automate and streamline real-time text translations in your Laravel applications

5511.6k](/packages/andrewdwallo-transmatic)[smousss/laravel-globalize

Make Laravel projects translatable in a matter of seconds!

2266.3k](/packages/smousss-laravel-globalize)[zachleigh/laravel-lang-bundler

Create Laravel translations bundles.

2512.5k](/packages/zachleigh-laravel-lang-bundler)[a2insights/filament-saas

Filament Saas for A2Insights

161.1k](/packages/a2insights-filament-saas)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)