Lara Zeus Spatie Translatable

https://github.com/lara-zeus/spatie-translatable
Admin
Lara Zeus Spatie Translatable is a Filament plugin that provides enhanced support for Spatie's...
Tokens:43,172
Snippets:362
Trust Score:8
License:MIT
Update:4 weeks ago
Show doc for...
Tokens:
Raw
### Install with Composer

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/docs/getting-started/installation.md

Install the plugin via Composer.

```bash
composer require lara-zeus/spatie-translatable
```

--------------------------------

### persist() usage example

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatablePlugin.md

Example of enabling locale persistence by calling persist() without arguments.

```php
SpatieTranslatablePlugin::make()->persist();
```

--------------------------------

### Example: getLocaleLabel usage

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatablePlugin.md

Example of calling getLocaleLabel on a plugin instance to get a locale label, e.g., 'German' for 'de'.

```php
$plugin = SpatieTranslatablePlugin::make();
$label = $plugin->getLocaleLabel('de'); // e.g. "German"
```

--------------------------------

### Usage example: translatable relation manager with LocaleSwitcher

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/RelationManagers-Translatable.md

Full usage example of a translatable relation manager with a LocaleSwitcher header action.

```php
use LaraZeus\SpatieTranslatable\Resources\RelationManagers\Concerns\Translatable;
use Filament\Resources\RelationManagers\RelationManager;

class BlogPostsRelationManager extends RelationManager
{
    use Translatable;

    protected static string $relationship = 'blogPosts';

    public function table(Table $table): Table
    {
        return $table
            ->columns([/* ... */])
            ->headerActions([
                \LaraZeus\SpatieTranslatable\Actions\LocaleSwitcher::make(),
            ]);
    }
}
```

--------------------------------

### defaultLocales() usage example

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatablePlugin.md

Example usage of the defaultLocales() setter to configure default locales for the plugin.

```php
SpatieTranslatablePlugin::make()->defaultLocales(['en', 'de', 'fr']);
```

--------------------------------

### getLocaleLabelUsing() usage example

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatablePlugin.md

Example of registering a callback that returns custom labels for English and Spanish locales, falling back to intl display names for others.

```php
SpatieTranslatablePlugin::make()
    ->getLocaleLabelUsing(
        fn (string $locale, ?string $displayLocale): ?string => match ($locale) {
            'en' => 'English',
            'es' => 'Español',
            default => null, // fall back to intl display name
        }
    );
```

--------------------------------

### Example: custom label provider with fallback

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatablePlugin.md

Shows how to register a custom label provider using getLocaleLabelUsing, which returns a config value or null to fall back to the default behavior.

```php
// With a custom label provider and a fallback:
SpatieTranslatablePlugin::make()
    ->getLocaleLabelUsing(function (string $locale): ?string {
        return config("app.extra_locale_names.{$locale}") ?? null;
    });
```

--------------------------------

### Example EditRecord class with Translatable trait

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/Pages-EditRecord-Translatable.md

Example of a custom EditRecord page using the Translatable trait and a LocaleSwitcher header action.

```php
class EditBlogPost extends EditRecord
{
    use Translatable;

    protected static string $resource = BlogPostResource::class;

    protected function getHeaderActions(): array
    {
        return [LocaleSwitcher::make()];
    }
}
```

--------------------------------

### LocaleSwitcher Action

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/Actions-LocaleSwitcher.md

Documentation for the `LocaleSwitcher` action class, including its methods and usage examples.

```APIDOC
## `LocaleSwitcher::getDefaultName()`

### Description
Returns the default action name for the `LocaleSwitcher` action, which is `'activeLocale'`. This name corresponds to the Livewire property that the action updates.

### Method
`getDefaultName`

### Signature
```php
public static function getDefaultName(): ?string
```

### Parameters
None.

### Return Value
`?string` — always the string `'activeLocale'`.

### Example
```php
$name = LocaleSwitcher::getDefaultName(); // 'activeLocale'
```
```

```APIDOC
## `LocaleSwitcher::setUp()`

### Description
Filament lifecycle hook called after construction. Sets the action label from the translation key `lara-zeus-spatie-translatable::actions.active_locale.label` and populates the select options from the host page's translatable locales.

### Method
`setUp`

### Signature
```php
protected function setUp(): void
```

### Parameters
None.

### Behavior
- Sets the label to the translated string (default English: `'Locale'`).
- Calls `setTranslatableLocaleOptions()` to populate the select options.

### Example
```php
protected function setUp(): void
{
    parent::setUp();
    $this->label(__('lara-zeus-spatie-translatable::actions.active_locale.label'));
    $this->setTranslatableLocaleOptions();
}
```
```

```APIDOC
## `LocaleSwitcher::make()` — Header Action on a Resource Page

### Description
Registers the `LocaleSwitcher` as a header action on a Filament resource page (e.g., CreateRecord). When the user selects a locale, the Livewire `activeLocale` property updates, triggering the `updatingActiveLocale`/`updatedActiveLocale` hooks.

### Method
`make`

### Signature
```php
LocaleSwitcher::make(): static
```

### Parameters
None.

### Example
```php
use Filament\Actions;
use Filament\Resources\Pages\CreateRecord;
use LaraZeus\SpatieTranslatable\Actions\LocaleSwitcher;
use LaraZeus\SpatieTranslatable\Resources\Pages\CreateRecord\Concerns\Translatable;

class CreateBlogPost extends CreateRecord
{
    use Translatable;

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

```APIDOC
## `LocaleSwitcher::make()` — Header Action on a Table (Relation Manager)

### Description
Registers the `LocaleSwitcher` as a header action on a Filament table (e.g., relation manager). The action renders a dropdown of available translatable locales.

### Method
`make`

### Signature
```php
LocaleSwitcher::make(): static
```

### Parameters
None.

### Example
```php
use Filament\Tables\Table;
use LaraZeus\SpatieTranslatable\Actions\LocaleSwitcher;

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

--------------------------------

### BlogPostResource with Translatable concern

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/Resources-Translatable.md

Complete resource wiring example showing how to use the Translatable concern in a Filament resource, including the getTranslatableLocales method returning the locales.

```php
use LaraZeus\SpatieTranslatable\Resources\Concerns\Translatable;
use Filament\Resources\Resource;

class BlogPostResource extends Resource
{
    use Translatable;

    protected static ?string $model = BlogPost::class;

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

--------------------------------

### Make Filament resource pages translatable with Translatable trait and LocaleSwitcher

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/docs/getting-started/usage.md

Apply the corresponding Translatable trait and add a LocaleSwitcher header action to each resource page (ListRecords, CreateRecord, EditRecord, ViewRecord, or ManageRecords for simple resources). The ManageRecords example extends ListRecords as shown in the source.

```php
use Filament\Actions;
use Filament\Resources\Pages\ListRecords;
use LaraZeus\SpatieTranslatable\Resources\Pages\ListRecords\Concerns\Translatable;
use LaraZeus\SpatieTranslatable\Actions\LocaleSwitcher;

class ListBlogPosts extends ListRecords
{
    use Translatable;
    
    protected function getHeaderActions(): array
    {
        return [
            LocaleSwitcher::make(),
            // ...
        ];
    }
    
    // ...
}
```

```php
use Filament\Actions;
use Filament\Resources\Pages\CreateRecord;
use LaraZeus\SpatieTranslatable\Resources\Pages\CreateRecord\Concerns\Translatable;
use LaraZeus\SpatieTranslatable\Actions\LocaleSwitcher;

class CreateBlogPost extends CreateRecord
{
    use Translatable;
    
    protected function getHeaderActions(): array
    {
        return [
            LocaleSwitcher::make(),
            // ...
        ];
    }
    
    // ...
}
```

```php
use Filament\Actions;
use Filament\Resources\Pages\EditRecord;
use LaraZeus\SpatieTranslatable\Resources\Pages\EditRecord\Concerns\Translatable;
use LaraZeus\SpatieTranslatable\Actions\LocaleSwitcher;

class EditBlogPost extends EditRecord
{
    use Translatable;
    
    protected function getHeaderActions(): array
    {
        return [
            LocaleSwitcher::make(),
            // ...
        ];
    }
    
    // ...
}
```

```php
use Filament\Actions;
use Filament\Resources\Pages\ViewRecord;
use LaraZeus\SpatieTranslatable\Resources\Pages\ViewRecord\Concerns\Translatable;
use LaraZeus\SpatieTranslatable\Actions\LocaleSwitcher;

class ViewBlogPost extends ViewRecord
{
    use Translatable;
    
    protected function getHeaderActions(): array
    {
        return [
            LocaleSwitcher::make(),
            // ...
        ];
    }
    
    // ...
}
```

```php
use Filament\Actions;
use Filament\Resources\Pages\ManageRecords;
use LaraZeus\SpatieTranslatable\Resources\Pages\ManageRecords\Concerns\Translatable;
use LaraZeus\SpatieTranslatable\Actions\LocaleSwitcher;

class ManageBlogPosts extends ListRecords
{
    use Translatable;
    
    protected function getHeaderActions(): array
    {
        return [
            LocaleSwitcher::make(),
            // ...
        ];
    }
    
    // ...
}
```

--------------------------------

### LocaleSwitcher label usage

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatableServiceProvider.md

Consumes the translation key in the LocaleSwitcher action's setUp() method.

```php
$this->label(__('lara-zeus-spatie-translatable::actions.active_locale.label'));
```

--------------------------------

### Enable fallback locale with useFallbackLocale

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatablePlugin.md

Example usage of the useFallbackLocale setter. Omit the argument to enable fallback-locale reading. The returned plugin instance is passed as the named argument useFallbackLocale: to Model::getTranslation() in SpatieTranslatableContentDriver::getRecordAttributesToArray() and in HasTranslatableFormWithExistingRecordData::fillForm().

```php
SpatieTranslatablePlugin::make()->useFallbackLocale();
```

--------------------------------

### Example override of LocaleSwitcher label

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatableServiceProvider.md

After publishing, edit the published file to change the label to 'Language' without code changes.

```php
return [
    'active_locale' => [
        'label' => 'Language',
    ],
];
```

--------------------------------

### Register SpatieTranslatablePlugin in Filament panel

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatablePlugin.md

Example usage in a Filament panel provider. Registers the plugin with default locales and enables validation of all locales.

```php
use LaraZeus\SpatieTranslatable\SpatieTranslatablePlugin;

// app/Providers/Filament/AdminPanelProvider.php
public function panel(Panel $panel): Panel
{
    return $panel
        ->plugin(
            SpatieTranslatablePlugin::make()
                ->defaultLocales(['en', 'es'])
                ->validateAllLocales()
        );
}
```

--------------------------------

### Enable all-locales validation with validateAllLocales

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatablePlugin.md

Example usage of the validateAllLocales setter. Omit the argument to enable all-locales validation. The plugin instance is used by CreateRecord\Concerns\Translatable::handleRecordCreation() and EditRecord\Concerns\Translatable::handleRecordUpdate() to decide which locales to validate based on filament('spatie-translatable')->getValidateAllLocales(). When false, only locales present in $otherLocaleData are validated.

```php
SpatieTranslatablePlugin::make()
    ->defaultLocales(['en', 'es'])
    ->validateAllLocales();
```

--------------------------------

### Inherit parent page's locale reactively

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/RelationManagers-Translatable.md

Example of inheriting the parent page's locale reactively by declaring a `#[Reactive]` property. No LocaleSwitcher is needed in the table.

```php
use LaraZeus\SpatieTranslatable\Resources\RelationManagers\Concerns\Translatable;
use Filament\Resources\RelationManagers\RelationManager;
use Livewire\Attributes\Reactive;

class BlogPostsRelationManager extends RelationManager
{
    use Translatable;

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

    // No LocaleSwitcher needed in table() — the locale follows the page.
}
```

--------------------------------

### register() and boot() methods

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatablePlugin.md

Both methods are required by the Filament\Contracts\Plugin contract and are intentionally empty in this implementation.

```php
public function register(Panel $panel): void
public function boot(Panel $panel): void
```

--------------------------------

### register(Panel $panel) / boot(Panel $panel)

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatablePlugin.md

Lifecycle methods required by the Filament Plugin contract. Both are intentionally empty.

```APIDOC
## `register(Panel $panel)` / `boot(Panel $panel)`

```php
public function register(Panel $panel): void
public function boot(Panel $panel): void
```

Both are required by the `Filament\Contracts\Plugin` contract and are intentionally empty in this implementation.

### Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `$panel` | `Filament\Panel` | yes | — | The panel instance supplied by the Filament plugin system. |
```

--------------------------------

### boot() method body

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatableServiceProvider.md

Registers translation publishing only in console and loads translations from the package's resources/lang directory under the namespace 'lara-zeus-spatie-translatable'.

```php
public function boot(): void
{
    if ($this->app->runningInConsole()) {
        $this->publishes([
            __DIR__ . '/../resources/lang' => lang_path('vendor/lara-zeus/spatie-translatable-translations'),
        ], 'lara-zeus-spatie-translatable-translations');
    }

    $this->loadTranslationsFrom(__DIR__ . '/../resources/lang', 'lara-zeus-spatie-translatable');
}
```

--------------------------------

### boot() method signature

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatableServiceProvider.md

Declares the boot() method with a void return type. Runs during Laravel's boot phase.

```php
public function boot(): void
```

--------------------------------

### Instantiate SpatieTranslatableContentDriver with locale

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatableContentDriver.md

Shows how to create a driver instance for the 'en' locale. Consumers normally never construct this class — Filament does so internally per active locale.

```php
$driver = new SpatieTranslatableContentDriver('en');
```

--------------------------------

### getOldActiveLocale() method

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/Resources-Translatable.md

Returns the previous active locale at the moment a locale switch starts.

```php
public function getOldActiveLocale(): ?string
```

--------------------------------

### bootTranslatable() method signature

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/Pages-CreateRecord-Translatable.md

The Livewire boot hook for the trait.

```php
/**
 * @throws Throwable
 */
public function bootTranslatable(): void
```

--------------------------------

### Override getTranslatableLocales() in a relation manager

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/RelationManagers-Translatable.md

Example of overriding `getTranslatableLocales()` in a relation manager to define custom locales.

```php
use LaraZeus\SpatieTranslatable\Resources\RelationManagers\Concerns\Translatable;
use Filament\Resources\RelationManagers\RelationManager;

class BlogPostsRelationManager extends RelationManager
{
    use Translatable;

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

--------------------------------

### Protected state: oldActiveLocale property

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/Resources-Translatable.md

Stores the previous locale when a locale switch starts, written by updatingActiveLocale().

```php
protected ?string $oldActiveLocale = null;
```

--------------------------------

### handleRecordCreation() method signature

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/Pages-CreateRecord-Translatable.md

Overrides Filament's create hook. Core flow (abbreviated from source):

1. `$record = new ($this->getModel())($data);`
2. `$translatableAttributes = static::getResource()::getTranslatableAttributes();`
3. `$record->fill(Arr::except($data, $translatableAttributes));`
4. For each translatable key in `$data`: `$record->setTranslation($key, $this->activeLocale, $value);`
5. Computes `$localesToValidate`:
   - `filament('spatie-translatable')->getValidateTranslatable()`

```php
public function mountTranslatable(): void
```

```php
$this->activeLocale = $this->getStoredActiveLocale() ?? static::getResource()::getDefaultTranslatableLocale();
```

```php
public function getTranslatableLocales(): array
```

```php
protected function handleRecordCreation(array $data): Model
```

--------------------------------

### mountTranslatable() method and its logic

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/RelationManagers-Translatable.md

Initializes the active locale on mount. It sets the locale only when it is blank or not in the configured translatable locales, allowing a parent resource page to pre-set the locale reactively.

```php
public function mountTranslatable(): void
```

```php
if (
    blank($this->activeLocale) ||
    (! in_array($this->activeLocale, $this->getTranslatableLocales(), true))
) {
    $this->setActiveLocale();
}
```

--------------------------------

### bootTranslatable() host class validation

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/Pages-CreateRecord-Translatable.md

Validation logic within the boot hook to ensure the trait is used on a valid Filament CreateRecord class.

```php
throw_unless(
    is_subclass_of(static::class, CreateRecord::class),
    new RuntimeException('dont use the trait "' . Translatable::class . '" with "' . static::class . '"')
);
```

--------------------------------

### bootTranslatable()

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/Pages-ListRecords-Translatable.md

Boot method that validates the trait is used on a ListRecords subclass, throwing a RuntimeException otherwise.

```APIDOC
## bootTranslatable()

### Description
Boots the trait by verifying the host class is a subclass of `Filament\Resources\Pages\ListRecords`. Throws a RuntimeException if not.

### Method
bootTranslatable

### Parameters
None.

### Return Value
void

### Throws
- **RuntimeException** - If the trait is used on a class that is not a subclass of `Filament\Resources\Pages\ListRecords`.
```

--------------------------------

### Full driver flow — makeRecord, updateRecord, getRecordAttributesToArray

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatableContentDriver.md

Shows the complete lifecycle of the driver as used by a Create page: instantiate with a locale, create a record with mixed translatable and plain attributes, update it, then read the translated value back. The title is stored via setTranslation('title', 'es', 'Hola') while is_published goes through fill().

```php
use LaraZeus\SpatieTranslatable\SpatieTranslatableContentDriver;

$driver = new SpatieTranslatableContentDriver('es');

$record = $driver->makeRecord(BlogPost::class, [
    'title' => 'Hola',        // translatable
    'is_published' => true,   // plain attribute
]);

// title stored via setTranslation('title', 'es', 'Hola'),
// is_published via fill()
$driver->updateRecord($record, ['title' => 'Hola mundo']);
echo $driver->getRecordAttributesToArray($record)['title']; // 'Hola mundo'

```

--------------------------------

### Configure SpatieTranslatablePlugin with fluent options

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/configuration.md

Configure the SpatieTranslatablePlugin with fluent setters for default locales, fallback locale usage, validation of all locales, session persistence, and a custom locale label resolver. All setters return static for chaining and are registered on the panel.

```php
->plugin(
    SpatieTranslatablePlugin::make()
        ->defaultLocales(['en', 'es'])
        ->useFallbackLocale()
        ->validateAllLocales()
        ->persist()
        ->getLocaleLabelUsing(fn (string $locale): ?string => null)
)
```

--------------------------------

### Default English translation file

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatableServiceProvider.md

Contains the only translation key used by the package: 'active_locale.label'.

```php
return [

    'active_locale' => [
        'label' => 'Locale',
    ],

];
```

--------------------------------

### fillForm() implementation

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/Resources-Translatable.md

Resolves the active locale (session first, then default), reads translations for each locale and attribute using Spatie's getTranslation() with the plugin's useFallbackLocale flag, stores non-active locales in $otherLocaleData after mutateFormDataBeforeFill(), and fills the form only for the active locale.

```php
// check for session first, then fall back to default locale
$this->activeLocale ??= $this->getStoredActiveLocale() ?? $this->getDefaultTranslatableLocale();

$record = $this->getRecord();
$translatableAttributes = static::getResource()::getTranslatableAttributes();

foreach ($this->getTranslatableLocales() as $locale) {
    $translatedData = [];

    foreach ($translatableAttributes as $attribute) {
        $translatedData[$attribute] = $record->getTranslation(
            $attribute,
            $locale,
            useFallbackLocale: filament('spatie-translatable')->getUseFallbackLocale()
        );
    }

    if ($locale !== $this->activeLocale) {
        $this->otherLocaleData[$locale] = $this->mutateFormDataBeforeFill($translatedData);

        continue;
    }

    /** @internal Read the DocBlock above the following method. */
    $this->fillFormWithDataAndCallHooks($record, $translatedData);
}
```

--------------------------------

### Add plugin to panel

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/docs/getting-started/installation.md

Add the plugin to a Filament panel by calling the plugin() method in the panel configuration.

```php
use LaraZeus\SpatieTranslatable\SpatieTranslatablePlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        // ...
        ->plugin(SpatieTranslatablePlugin::make());
}
```

--------------------------------

### mountTranslatable() method signature

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/Pages-EditRecord-Translatable.md

Public method signature for initializing translatable state in an EditRecord page.

```php
public function mountTranslatable(): void
```

--------------------------------

### mountTranslatable() method signature

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/Pages-CreateRecord-Translatable.md

Mount hook that initializes the active locale. Called automatically when the page mounts.

```php
public function mountTranslatable(): void
{
    $this->activeLocale = $this->getStoredActiveLocale() ?? static::getResource()::getDefaultTranslatableLocale();
}
```

--------------------------------

### Apply Translatable trait to resource

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/docs/getting-started/installation.md

Apply the Translatable trait to your resource class to make it translatable.

```php
use LaraZeus\SpatieTranslatable\Resources\Concerns\Translatable;
use Filament\Resources\Resource;

class BlogPostResource extends Resource
{
    use Translatable;
    
    // ...
}
```

--------------------------------

### Publish translations with artisan vendor:publish

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/configuration.md

Publishes the translation files for the package to the application's lang directory. The translations are registered by SpatieTranslatableServiceProvider::boot() and the publish target is lang_path('vendor/lara-zeus/spatie-translatable-translations').

```bash
php artisan vendor:publish --tag=lara-zeus-spatie-translatable-translations
```

--------------------------------

### bootTranslatable() method signature

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/Pages-ListRecords-Translatable.md

Declares the bootTranslatable method that throws a Throwable. It is called during the boot process of the list page trait.

```php
/**
 * @throws Throwable
 */
public function bootTranslatable(): void

```

--------------------------------

### getLocaleLabelUsing(?Closure $callback)

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatablePlugin.md

Registers a callback to produce human-readable labels for locale options in the LocaleSwitcher action. Despite its getter-like name, this is a setter and returns the plugin instance for chaining.

```APIDOC
## `getLocaleLabelUsing(?Closure $callback)`

### Description
Registers a callback used to produce human-readable labels for locale options in the `LocaleSwitcher` action. Despite its getter-like name, this is a **setter** and returns the plugin instance for chaining. It does **not** return the currently registered closure.

### Method
`getLocaleLabelUsing`

### Signature
php
public function getLocaleLabelUsing(?Closure $callback): static


### Parameters
- `$callback` (?Closure) - Required - Signature: `function (string $locale, ?string $displayLocale): ?string`. Returns the label to display, or `null` to fall back to `locale_get_display_name()`.

### Return Value
`static` - the plugin instance, for chaining.

### Example
php
SpatieTranslatablePlugin::make()
    ->getLocaleLabelUsing(
        fn (string $locale, ?string $displayLocale): ?string => match ($locale) {
            'en' => 'English',
            'es' => 'Español',
            default => null, // fall back to intl display name
        }
    );


### Notes
- Backing property: `protected ?Closure $getLocaleLabelUsing = null`.
```

--------------------------------

### TranslatableContentDriver contract methods implemented by SpatieTranslatableContentDriver

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/types.md

Method signatures of the Filament\Support\Contracts\TranslatableContentDriver contract as implemented by SpatieTranslatableContentDriver. The constructor takes a driver-scoped locale; makeRecord returns an unsaved model, updateRecord saves, and applySearchConstraintToQuery adds a JSON-path LIKE constraint for pgsql or json_extract by default.

```php
public function __construct(protected string $activeLocale);
public function isAttributeTranslatable(string $model, string $attribute): bool;
public function makeRecord(string $model, array $data): Model;
public function setRecordLocale(Model $record): Model;
public function updateRecord(Model $record, array $data): Model;
public function getRecordAttributesToArray(Model $record): array;
public function applySearchConstraintToQuery(Builder $query, string $column, string $search, string $whereClause, ?bool $isCaseInsensitivityForced = null): Builder;
```

--------------------------------

### SpatieTranslatablePlugin::make()

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatablePlugin.md

Static factory method to create or resolve a SpatieTranslatablePlugin instance from the Laravel container.

```APIDOC
## SpatieTranslatablePlugin::make()

### Description
Static factory method that resolves a `SpatieTranslatablePlugin` instance from the Laravel application container. It is the primary way to obtain a plugin instance for configuration and registration in a Filament panel.

### Method
`make`

### Signature
`public static function make(): static`

### Parameters
None.

### Return Value
A new `SpatieTranslatablePlugin` instance (or a container-bound instance if one was previously resolved/bound).

### Example
```php
use LaraZeus\SpatieTranslatable\SpatieTranslatablePlugin;

// app/Providers/Filament/AdminPanelProvider.php
public function panel(Panel $panel): Panel
{
    return $panel
        ->plugin(
            SpatieTranslatablePlugin::make()
                ->defaultLocales(['en', 'es'])
                ->validateAllLocales()
        );
}
```
```

--------------------------------

### persist(bool $persistLocale = true)

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatablePlugin.md

Enables or disables storing the user's selected locale in the session. When enabled, the locale is stored under the key 'spatie_translatable_active_locale' on every locale switch and restored on later visits.

```APIDOC
## `persist(bool $persistLocale = true)`

### Description
Enables or disables session persistence of the active locale. When enabled, the user's selected locale is stored in the session under the key `spatie_translatable_active_locale` on every locale switch, and is restored as the initial active locale on later visits.

### Method
`persist`

### Signature
php
public function persist(bool $persistLocale = true): static


### Parameters
- `$persistLocale` (bool) - Optional - Default: `true` - Omit the argument to enable persistence; pass `false` to disable it.

### Return Value
`static` - the plugin instance, for chaining.

### Example
php
SpatieTranslatablePlugin::make()->persist();


### Notes
- Backing property: `protected bool $persistLocale = false`.
- Consumption: `HasActiveLocaleSwitcher::updatedActiveLocale()` writes the session value only when `getPersistLocale()` is `true`; `HasActiveLocaleSwitcher::getStoredActiveLocale()` returns the session locale only when it is `true` and the stored locale is one of the translatable locales.
```

--------------------------------

### getDefaultLocales() method

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatablePlugin.md

Returns the configured default locales, or null if defaultLocales(null) was called. The initial value before any configuration is [] (an empty array). This value is consumed by LaraZeus\SpatieTranslatable\Resources\Concerns\Translatable::getTranslatableLocales() and by the relation-manager trait.

```php
public function getDefaultLocales(): ?array
```

--------------------------------

### Constructor: SpatieTranslatableContentDriver::__construct

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatableContentDriver.md

Defines the constructor that stores the active locale. Filament injects the page's active locale when it instantiates the driver.

```php
public function __construct(protected string $activeLocale) {}
```

--------------------------------

### bootTranslatable() method signature

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/Pages-ViewRecord-Translatable.md

Declares the bootTranslatable method that throws a Throwable. It is the boot hook used by the trait to initialize translatable behavior on a Filament ViewRecord page.

```php
/**
 * @throws Throwable
 */
public function bootTranslatable(): void

```

```php
throw_unless(
    is_subclass_of($this, ViewRecord::class),
    fn () => throw new ilament
esources
esources
elationManagers
elationManager::class
);
```

--------------------------------

### SpatieTranslatablePlugin::__construct()

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatablePlugin.md

The final empty constructor. Instances are resolved from the Laravel container via `make()`, never constructed directly.

```APIDOC
## SpatieTranslatablePlugin::__construct()

### Description
The constructor is `final` and empty. Instances are resolved from the Laravel container via `make()`, never constructed directly.

### Method
`__construct`

### Signature
`final public function __construct()`

### Parameters
None.

### Return Value
No return value (constructor).
```

--------------------------------

### getRecord() method signature

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/Resources-Translatable.md

Returns the raw record when activeLocale is blank; otherwise returns the record with the active locale set so attribute reads resolve to the active locale.

```php
public function getRecord(): Model
```

--------------------------------

### HasActiveLocaleSwitcher public state properties

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/types.md

Declared in the HasActiveLocaleSwitcher trait. $activeLocale is Livewire-bound and drives the schema, table, and content driver; $oldActiveLocale stores the locale before an in-flight switch.

```php
public ?string $activeLocale = null;

protected ?string $oldActiveLocale = null;
```

--------------------------------

### Public state: activeLocale property

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/Resources-Translatable.md

Livewire-bound active locale property, updated by the LocaleSwitcher action. Remains null until mounted.

```php
public ?string $activeLocale = null;
```

--------------------------------

### defaultLocales(?array $defaultLocales = null)

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatablePlugin.md

Sets the default locales for translation. Returns the plugin instance for chaining.

```APIDOC
## `defaultLocales(?array $defaultLocales = null)` — setter

```php
public function defaultLocales(?array $defaultLocales = null): static
```

Sets the locales available for translation. Passing `null` (or omitting the argument) sets the internal `$defaultLocales` property to `null`. Backing property: `protected ?array $defaultLocales = []`.

### Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `$defaultLocales` | `?array` | no | `null` | Indexed array of locale strings, e.g. `['en', 'es']`. |

### Return value

`static` — the plugin instance, for chaining.

### Example

```php
SpatieTranslatablePlugin::make()->defaultLocales(['en', 'de', 'fr']);
```
```

--------------------------------

### SpatieTranslatablePlugin constructor

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatablePlugin.md

The constructor is final and empty. Instances are resolved from the Laravel container via make(), never constructed directly.

```php
final public function __construct()
```

--------------------------------

### validateAllLocales(bool $validateAllLocales = true)

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatablePlugin.md

Controls whether form validation runs for every configured translatable locale. Returns the plugin instance for chaining.

```APIDOC
## `validateAllLocales(bool $validateAllLocales = true)` — setter

### Description
When enabled, form validation runs for every configured translatable locale before a record is created or updated — not only the locales the user visited. On failure with this option enabled, the form switches to the failing locale and re-throws the `ValidationException`.

### Method
`validateAllLocales`

### Signature
```php
public function validateAllLocales(bool $validateAllLocales = true): static
```

### Parameters
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `$validateAllLocales` | `bool` | no | `true` | Omit the argument to enable all-locales validation; pass `false` to disable it. |

### Return Value
`static` — the plugin instance, for chaining.

### Example
```php
SpatieTranslatablePlugin::make()
    ->defaultLocales(['en', 'es'])
    ->validateAllLocales();
```
```

--------------------------------

### Composer discovery for SpatieTranslatableServiceProvider

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatableServiceProvider.md

Registers the service provider automatically via Laravel's package discovery. No manual provider registration is needed.

```json
"extra": {
    "laravel": {
        "providers": [
            "LaraZeus\\SpatieTranslatable\\SpatieTranslatableServiceProvider"
        ]
    }
}
```

--------------------------------

### useFallbackLocale(bool $useFallbackLocale = true)

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatablePlugin.md

Controls whether translations fall back to the fallback locale when a value is missing in the active locale. Returns the plugin instance for chaining.

```APIDOC
## `useFallbackLocale(bool $useFallbackLocale = true)` — setter

### Description
Controls whether translations fall back to the fallback locale when a value is missing in the active locale.

### Method
`useFallbackLocale`

### Signature
```php
public function useFallbackLocale(bool $useFallbackLocale = true): static
```

### Parameters
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `$useFallbackLocale` | `bool` | no | `true` | Omit the argument to enable fallback-locale reading; pass `false` to disable it. |

### Return Value
`static` — the plugin instance, for chaining.

### Example
```php
SpatieTranslatablePlugin::make()->useFallbackLocale();
```
```

--------------------------------

### bootTranslatable() guard with throw_unless

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/Pages-ListRecords-Translatable.md

Validates that the trait is used on a ListRecords subclass, throwing a RuntimeException otherwise. The message is: dont use the trait 

```php
throw_unless(
    is_subclass_of(static::class, ListRecords::class),
    new RuntimeException('dont use the trait "' . Translatable::class . '" with "' . static::class . '")
);
```

--------------------------------

### Filament Plugin contract methods implemented by SpatieTranslatablePlugin

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/types.md

Method signatures of the Filament\Contracts\Plugin contract as implemented by SpatieTranslatablePlugin. Return types are string, Filament\Panel, and void as declared in src/SpatieTranslatablePlugin.php.

```php
public static function make(): static;
public function getId(): string;
public function register(Panel $panel): void;
public function boot(Panel $panel): void;
```

--------------------------------

### setTranslatableLocaleOptions()

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/Actions-LocaleSwitcher.md

Declares the select's options as a deferred closure. It reads the host Livewire component's translatable locales and builds an associative array of locale codes to labels.

```APIDOC
## setTranslatableLocaleOptions()

### Description
Declares the select's options as a deferred closure. It reads the host Livewire component's translatable locales and builds an associative array of locale codes to labels.

### Method
setTranslatableLocaleOptions

### Endpoint
N/A (PHP method)

### Parameters
None.

### Return Value
`static` - the action instance, for chaining.

### Behavior
- Reads the host Livewire component via the action's `getLivewire()`.
- If the component has no `getTranslatableLocales()` method, options default to `[]`.
- Otherwise, builds an associative `locale => label` map using `SpatieTranslatablePlugin::getLocaleLabel()` (custom label callback or `locale_get_display_name`), falling back to the raw locale code when the label is `null`.

### Example
```php
public function setTranslatableLocaleOptions(): static
{
    $this->options(function (): array {
        /** @var object $livewire */
        $livewire = $this->getLivewire();

        if (! method_exists($livewire, 'getTranslatableLocales')) {
            return [];
        }

        $locales = [];

        /** @var SpatieTranslatablePlugin $plugin */
        $plugin = filament('spatie-translatable');

        foreach ($livewire->getTranslatableLocales() as $locale) {
            $locales[$locale] = $plugin->getLocaleLabel($locale) ?? $locale;
        }

        return $locales;
    });
}
```
```

--------------------------------

### Catch ValidationException and RuntimeException around handleRecordCreation()

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/errors.md

Wrap handleRecordCreation() in a try/catch to distinguish user-facing validation errors from misconfiguration errors. ValidationException indicates the page has already switched to the failing locale and $e->errors() contains per-field messages; RuntimeException signals a misconfigured model or trait misuse, e.g. missing Spatie\Translatable\HasTranslations, and should abort with a 500 response.

```php
use Illuminate\Validation\ValidationException;
use RuntimeException;

try {
    $page->handleRecordCreation($data);
} catch (ValidationException $e) {
    // User-facing form errors; the page has already switched to the failing locale.
    // $e->errors() contains the per-field messages.
    report($e->getMessage());
} catch (RuntimeException $e) {
    // Misconfigured model or trait misuse (see tables above).
    // e.g. "Model [App\Models\Post] must use trait [Spatie\Translatable\HasTranslations]."
    abort(500, $e->getMessage());
}
```

--------------------------------

### Set default translatable locales

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/docs/getting-started/installation.md

Set the default translatable locales by passing an array of locales to the defaultLocales() method.

```php
use LaraZeus\SpatieTranslatable\SpatieTranslatablePlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        // ...
        ->plugin(
            SpatieTranslatablePlugin::make()
                ->defaultLocales(['en', 'es']),
        );
}
```

--------------------------------

### Validate host class with throw_unless

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/Pages-EditRecord-Translatable.md

Throws a RuntimeException if the trait is used on a class that is not a subclass of Filament\Resources\Pages\EditRecord. The message includes the trait and host class names.

```php
throw_unless(
    is_subclass_of(static::class, EditRecord::class),
    new RuntimeException('dont use the trait "' . Translatable::class . '" with "' . static::class . '"')
);
```

--------------------------------

### updatingActiveLocale() method signature

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/Pages-CreateRecord-Translatable.md

Declares the Livewire pre-update hook that records the current locale before the switch.

```php
public function updatingActiveLocale(): void
```

--------------------------------

### getId() method

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatablePlugin.md

Returns the plugin identifier string 'spatie-translatable' used by the Filament plugin system and by filament('spatie-translatable').

```php
public function getId(): string
```

--------------------------------

### setTranslatableLocaleOptions() method signature

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/Actions-LocaleSwitcher.md

Declares the select's options as a deferred closure. Takes no parameters and returns the current instance for chaining.

```php
public function setTranslatableLocaleOptions(): static
```

--------------------------------

### makeRecord(string $model, array $data)

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatableContentDriver.md

Creates an unsaved model instance pre-filled for the active locale. Non-translatable attributes are mass-filled, while translatable attributes are set via setTranslation(). The returned record is not saved.

```APIDOC
## makeRecord(string $model, array $data)

### Description
Creates an unsaved model instance pre-filled for the active locale. Non-translatable attributes are mass-filled, while translatable attributes are set via setTranslation(). The returned record is not saved.

### Method
makeRecord

### Endpoint
makeRecord(string $model, array $data)

### Parameters
#### Path Parameters
- **$model** (string) - Required - Model class-name.
- **$data** (array<string, mixed>) - Required - Raw form data; translatable keys are split out from the rest.

### Return Value
- **Illuminate\Database\Eloquent\Model** - The new, unsaved model with the active locale set and translatable attributes stored via setTranslation().
```

--------------------------------

### Override $activeLocale with Livewire Reactive attribute

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/docs/getting-started/usage.md

Override the `$activeLocale` property and add Livewire's `Reactive` attribute to inherit the locale of the `Translatable` resource page that the relation manager is displayed on.

```php
use LaraZeus\SpatieTranslatable\Resources\RelationManagers\Concerns\Translatable;
use Filament
esources
elationManagers
elationManager;

class BlogPostsRelationManager extends RelationManager
{
    use Translatable;
    
    // ...
}
```

--------------------------------

### updateRecord(Model $record, array $data) method signature

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatableContentDriver.md

Updates an existing model for the active locale. Sets the locale, fills non-translatable attributes, applies translatable values via setTranslation, then saves the model. Unlike makeRecord, this method saves the model.

```php
/**
 * @param  array<string, mixed>  $data
 */
public function updateRecord(Model $record, array $data): Model
{
    // ...
}
```

--------------------------------

### getLocaleLabelUsing() method signature

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatablePlugin.md

Signature for the getLocaleLabelUsing() setter method. Registers a callback to generate locale labels.

```php
public function getLocaleLabelUsing(?Closure $callback): static
```

--------------------------------

### getId()

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatablePlugin.md

Returns the plugin identifier string used by the Filament plugin system.

```APIDOC
## `getId()`

```php
public function getId(): string
```

Plugin identifier used by the Filament plugin system and by `filament('spatie-translatable')`.

### Return value

Always the string `'spatie-translatable'`.
```

--------------------------------

### Public state properties

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/Pages-CreateRecord-Translatable.md

Properties used to manage locale switching and store translation data for non-active locales.

```php
protected ?string $oldActiveLocale = null;
```

```php
#[Locked]
public array $otherLocaleData = [];
```

--------------------------------

### getDefaultLocales()

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatablePlugin.md

Returns the configured default locales, or null if explicitly set to null. Initially returns an empty array.

```APIDOC
## `getDefaultLocales()`

```php
public function getDefaultLocales(): ?array
```

### Return value

`?array` — the configured default locales, or `null` if `defaultLocales(null)` was called. Note the initial value before any configuration is `[]` (an empty array).

This value is consumed by `LaraZeus\SpatieTranslatable\Resources\Concerns\Translatable::getTranslatableLocales()` and by the relation-manager trait, so it effectively defines the locale list for every resource and relation manager unless overridden per resource.
```

--------------------------------

### getLocaleLabel(string $locale, ?string $displayLocale = null)

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/api-reference/SpatieTranslatablePlugin.md

Resolves the display label for a locale, used to build the LocaleSwitcher options. The method first checks for a custom callback registered via getLocaleLabelUsing(), then falls back to the intl function locale_get_display_name().

```APIDOC
## `getLocaleLabel(string $locale, ?string $displayLocale = null)`

### Description
Resolves the display label for a locale, used to build the `LocaleSwitcher` options. The resolution order is: first, if a callback was registered via `getLocaleLabelUsing()`, its return value is used (unless `null`); otherwise, or when the callback returned `null`, the `intl` function `locale_get_display_name($locale, $displayLocale)` is used; if that also evaluates empty, `null` is returned.

### Method
GET

### Endpoint
`getLocaleLabel`

### Parameters
#### Path Parameters
- **$locale** (string) - Required - The locale code to label, e.g. `'en'`.
- **$displayLocale** (?string) - Optional - Locale in which to render the name. When `null`, the session locale (`spatie_translatable_active_locale`) is used if present, otherwise `app()->getLocale()`.

### Request Example
```php
$plugin = SpatieTranslatablePlugin::make();
$label = $plugin->getLocaleLabel('de'); // e.g. "German"
```

### Response
#### Success Response (200)
- **return** (?string) - The display name, or `null` when neither the callback nor `locale_get_display_name()` produced a value. Requires the PHP `ext-intl` extension.

#### Response Example
```php
"German"
```

### Error Handling
- If the callback returns `null` and `locale_get_display_name()` returns an empty value, `null` is returned.
- The PHP `ext-intl` extension is required; otherwise, the method may fail.
```

--------------------------------

### SpatieTranslatablePlugin protected config state

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/_autodocs/types.md

Protected configuration state on SpatieTranslatablePlugin. Exposed via getter/setter pairs; defaults are [] for defaultLocales and false for the boolean flags.

```php
protected ?array $defaultLocales = [];

protected bool $useFallbackLocale = false;

protected bool $persistLocale = false;

protected ?Closure $getLocaleLabelUsing = null;

protected bool $validateAllLocales = false;
```

--------------------------------

### Override getTranslatableLocales() to set per-resource locales

Source: https://github.com/lara-zeus/spatie-translatable/blob/2.x/docs/getting-started/usage.md

Override getTranslatableLocales() in the resource class to customize the translatable locales for a particular resource, instead of using the global plugin configuration.

```php
use LaraZeus\SpatieTranslatable\Resources\Concerns\Translatable;
use Filament\Resources\Resource;

class BlogPostResource extends Resource
{
    use Translatable;
    
    // ...
    
    public static function getTranslatableLocales(): array
    {
        return ['en', 'fr'];
    }
}
```
Tokens:
Raw