PHPackages                             huuhadev/filament-translatable - 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. huuhadev/filament-translatable

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

huuhadev/filament-translatable
==============================

Filament support for `spatie/laravel-translatable`.

v1.0.0(1y ago)0147MITPHPPHP ^8.2

Since Nov 3Pushed 1y ago1 watchersCompare

[ Source](https://github.com/huuhadev/filament-translatable)[ Packagist](https://packagist.org/packages/huuhadev/filament-translatable)[ Docs](https://github.com/huuhadev)[ RSS](/packages/huuhadev-filament-translatable/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (4)Versions (2)Used By (0)

Filament Translatable Plugin
============================

[](#filament-translatable-plugin)

[![Filament Translatable](https://raw.githubusercontent.com/huuhadev/filament-translatable/master/art/filament-translatable.jpg)](https://raw.githubusercontent.com/huuhadev/filament-translatable/master/art/filament-translatable.jpg)

Installation
------------

[](#installation)

Install the plugin with Composer:

```
composer require huuhadev/filament-translatable
```

After the package is installed, if you wish to use flag images, you can publish the assets using the following command:

```
php artisan filament-translatable:install
```

Adding the plugin to a panel
----------------------------

[](#adding-the-plugin-to-a-panel)

To add a plugin to a panel.

```
use HuuHaDev\FilamentTranslatable\FilamentTranslatablePlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        // ...
        ->plugins([
            FilamentTranslatablePlugin::make()
                ->locales([
                    'en' => asset('/vendor/filament-translatable/assets/flags/gb.svg'),
                    'ar' => asset('/vendor/filament-translatable/assets/flags/ar.svg')
                ])
                ->onlyFlag() // Default: false
                ->rounded(false) // Default: true
                ->renderHook('panels::global-search.before') // Default: 'panels::global-search.after'
                ->displayLocale('ar') // Display locale as an optional parameter to get the language names in a specific language. If no display locale is specified, the application's current locale is used.
                ->labels(['en' => 'English (EN)', 'ar' => 'Arabic (AR)']) // Custom text labels for each locale that your application supports. Default use PHP's native function locale_get_display_name()
                ->size('lg') // By default, the avatar will be "medium" size. You can set the size to either sm, md, or lg using the size attribute: `w-8 h-8`
                ->buttonClasses('rounded-full') // Default: 'rounded-lg',
        ])
}
```

Translate Action
----------------

[](#translate-action)

This only supports TextInput, Textarea, and RichEditor fields.

```
TextInput::make('name')
    ->translator('Auto translate') // This line to make field translatable,
```

Preparing your model class
--------------------------

[](#preparing-your-model-class)

You need to make your model translatable. You can read how to do this in [Spatie's documentation](https://spatie.be/docs/laravel-translatable/installation-setup#content-making-a-model-translatable).

Preparing your resource class
-----------------------------

[](#preparing-your-resource-class)

You must apply the `Huuhadev\FilamentTranslatable\Concerns\ResourcesTranslatable` trait to your resource class:

```
use HuuHaDev\FilamentTranslatable\Concerns\ResourcesTranslatable;
use Filament\Resources\Resource;

class PostResource extends Resource
{
    use ResourcesTranslatable;

    // ...
}
```

Making resource pages translatable
----------------------------------

[](#making-resource-pages-translatable)

```
use Filament\Resources\Pages\ListRecords;
use HuuHaDev\FilamentTranslatable\Actions\SelectLocale;
use HuuHaDev\FilamentTranslatable\Concerns\ListRecordsTranslatable;

class ListPosts extends ListRecords
{
    use ListRecordsTranslatable;

    protected function getHeaderActions(): array
    {
        return [
            SelectLocale::make(),
            // ...
        ];
    }

    // ...
}
```

Translating Manager Records
---------------------------

[](#translating-manager-records)

```
use Filament\Resources\Pages\ManageRecords;
use HuuHaDev\FilamentTranslatable\Actions\SelectLocale;
use HuuHaDev\FilamentTranslatable\Concerns\ManageRecordsTranslatable;

class ManageAuthors extends ManageRecords
{
    use ManageRecordsTranslatable;

    protected function getHeaderActions(): array
    {
        return [
            SelectLocale::make(),
            // ...
        ];
    }

    // ...
}
```

Translating create page
-----------------------

[](#translating-create-page)

```
use Filament\Resources\Pages\CreateRecord;
use HuuHaDev\FilamentTranslatable\Actions\SelectLocale;
use HuuHaDev\FilamentTranslatable\Concerns\CreateRecordTranslatable;

class CreateBlogPost extends CreateRecord
{
    use CreateRecordTranslatable;

    protected function getHeaderActions(): array
    {
        return [
            SelectLocale::make(),
            // ...
        ];
    }

    // ...
}
```

Translating edit page
---------------------

[](#translating-edit-page)

```
use Filament\Resources\Pages\EditRecord;
use HuuHaDev\FilamentTranslatable\Actions\SelectLocale;
use HuuHaDev\FilamentTranslatable\Concerns\EditRecordTranslatable;

class EditBlogPost extends EditRecord
{
    use EditRecordTranslatable;

    protected function getHeaderActions(): array
    {
        return [
            SelectLocale::make(),
            // ...
        ];
    }

    // ...
}
```

Translating view page
---------------------

[](#translating-view-page)

```
use Filament\Resources\Pages\ViewRecord;
use HuuHaDev\FilamentTranslatable\Actions\SelectLocale;
use HuuHaDev\FilamentTranslatable\Concerns\ViewRecordTranslatable;

class ViewBlogPost extends ViewRecord
{
    use ViewRecordTranslatable;

    protected function getHeaderActions(): array
    {
        return [
            SelectLocale::make(),
            // ...
        ];
    }

    // ...
}
```

### Setting the translatable locales for a particular resource

[](#setting-the-translatable-locales-for-a-particular-resource)

Customize the translatable locales for a particular resource by overriding the `getTranslatableLocales()` method in your resource class:

```
use Filament\Resources\Resource;
use HuuHaDev\FilamentTranslatable\Concerns\ResourceTranslatable;

class PostResource extends Resource
{
    use ResourceTranslatable;

    // ...

    public static function getTranslatableLocales(): array
    {
        return ['en', 'fr'];
    }
}
```

Translating relation managers
-----------------------------

[](#translating-relation-managers)

```
use Filament\Resources\RelationManagers\RelationManager;
use HuuHaDev\FilamentTranslatable\Concerns\RelationManagersTranslatable;

class PostsRelationManager extends RelationManager
{
    use RelationManagersTranslatable;

    // ...
}
```

Now, you can add a new `TableSelectLocale` action to the header of the relation manager's `table()`:

```
use Filament\Tables\Table;
use HuuHaDev\FilamentTranslatable\Actions\Tables\TableSelectLocale;

public function table(Table $table): Table
{
    return $table
        ->columns([
            // ...
        ])
        ->headerActions([
            // ...
            TableSelectLocale::make(),
        ]);
}
```

Override the `$activeLocale` property and add Livewire's `Reactive` attribute to it:

```
use Filament\Resources\RelationManagers\RelationManager;
use Livewire\Attributes\Reactive;
use HuuHaDev\FilamentTranslatable\Concerns\RelationManagersTranslatable;

class PostsRelationManager extends RelationManager
{
    use RelationManagersTranslatable;

    #[Reactive]
    public ?string $activeLocale = null;

    // ...
}
```

If you do this, you no longer need a `SelectLocale` action in the `table()`.

### Setting the translatable locales for a particular relation manager

[](#setting-the-translatable-locales-for-a-particular-relation-manager)

Customize the translatable locales for a particular relation manager by overriding the `getTranslatableLocales()` method in your relation manager class:

```
use Filament\Resources\RelationManagers\RelationManager;
use HuuHaDev\FilamentTranslatable\Concerns\RelationManagersTranslatable;

class PostsRelationManager extends RelationManager
{
    use RelationManagersTranslatable;

    // ...

    public function getTranslatableLocales(): array
    {
        return ['en', 'ar'];
    }
}
```

### After the trait is applied on the model you can do these things:

[](#after-the-trait-is-applied-on-the-model-you-can-do-these-things)

```
$newsItem = new NewsItem;
$newsItem
   ->setTranslation('name', 'en', 'Name in English')
   ->setTranslation('name', 'nl', 'Naam in het Nederlands')
   ->save();

$newsItem->name; // Returns 'Name in English' given that the current app locale is 'en'
$newsItem->getTranslation('name', 'nl'); // returns 'Naam in het Nederlands'

app()->setLocale('nl');

$newsItem->name; // Returns 'Naam in het Nederlands'

// If you want to query records based on locales, you can use the `whereLocale` and `whereLocales` methods.

NewsItem::whereLocale('name', 'en')->get(); // Returns all news items with a name in English

NewsItem::whereLocales('name', ['en', 'nl'])->get(); // Returns all news items with a name in English or Dutch

// Returns all news items that has name in English with value `Name in English`
NewsItem::query()->whereJsonContainsLocale('name', 'en', 'Name in English')->get();

// Returns all news items that has name in English or Dutch with value `Name in English`
NewsItem::query()->whereJsonContainsLocales('name', ['en', 'nl'], 'Name in English')->get();

// The last argument is the "operand" which you can tweak to achieve something like this:

// Returns all news items that has name in English with value like `Name in...`
NewsItem::query()->whereJsonContainsLocale('name', 'en', 'Name in%', 'like')->get();

// Returns all news items that has name in English or Dutch with value like `Name in...`
NewsItem::query()->whereJsonContainsLocales('name', ['en', 'nl'], 'Name in%', 'like')->get();
```

Translator
----------

[](#translator)

### Default

[](#default)

By default, the package use Google Translator is the default, The plugin allows integration with other translation services. For integration, create a class that adheres to the `Huuhadev\FilamentTranslatable\Contracts\Translator` contract and update the `filament-translatable.php` config file accordingly.

### AWS Translate Integration

[](#aws-translate-integration)

Ensure you've set the necessary configurations as specified in the [AWS Service Provider for Laravel](https://github.com/aws/aws-sdk-php-laravel) documentation, and have the following environment variables:

```
AWS_ACCESS_KEY_ID=your-access-key-id
AWS_SECRET_ACCESS_KEY=your-secret-access-key
AWS_REGION=your-region  # default is us-east-1
```

Publishing
----------

[](#publishing)

You can publish the views file with:

```
php artisan vendor:publish --tag=filament-translatable-views
```

You can publish the config file with:

```
php artisan vendor:publish --tag=filament-translatable-config
```

```
php artisan vendor:publish --tag=filament-translatable-translations
```

Screenshots
-----------

[](#screenshots)

### Application language switcher

[](#application-language-switcher)

[![Language switcher](https://raw.githubusercontent.com/huuhadev/filament-translatable/master/art/ap-language-switcher.png)](https://raw.githubusercontent.com/huuhadev/filament-translatable/master/art/ap-language-switcher.png)

### Content language switcher

[](#content-language-switcher)

[![Content language switcher](https://raw.githubusercontent.com/huuhadev/filament-translatable/master/art/content-language-selector.png)](https://raw.githubusercontent.com/huuhadev/filament-translatable/master/art/content-language-selector.png)

### Translator field

[](#translator-field)

[![Translator](https://raw.githubusercontent.com/huuhadev/filament-translatable/master/art/auto-translator.png)](https://raw.githubusercontent.com/huuhadev/filament-translatable/master/art/auto-translator.png)

### Google translate

[](#google-translate)

[![Google Translator](https://raw.githubusercontent.com/huuhadev/filament-translatable/master/art/google-translator.png)](https://raw.githubusercontent.com/huuhadev/filament-translatable/master/art/google-translator.png)

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance38

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

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

Unknown

Total

1

Last Release

555d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c641b548f03a21aa6665f36ddce6655faa0e4f822ed8473bf5da1f91d26ce456?d=identicon)[huuhadev](/maintainers/huuhadev)

### Embed Badge

![Health badge](/badges/huuhadev-filament-translatable/health.svg)

```
[![Health](https://phpackages.com/badges/huuhadev-filament-translatable/health.svg)](https://phpackages.com/packages/huuhadev-filament-translatable)
```

###  Alternatives

[outerweb/filament-translatable-fields

Filament integration for spatie/laravel-translatable

3582.9k8](/packages/outerweb-filament-translatable-fields)[bezhansalleh/filament-language-switch

Zero config Language Switch(Changer/Localizer) plugin for filamentphp admin

3431.0M16](/packages/bezhansalleh-filament-language-switch)[statikbe/laravel-filament-chained-translation-manager

A translation manager tool for Laravel Filament, that makes use of the Laravel Chained Translator.

92108.7k](/packages/statikbe-laravel-filament-chained-translation-manager)[kenepa/translation-manager

Manage your application's translation strings in Filament.

14583.6k2](/packages/kenepa-translation-manager)[34ml/filament-translatable-field

A laravel filament field that handle translation

182.7k](/packages/34ml-filament-translatable-field)

PHPackages © 2026

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