pxlrbt/filament-translate-action

Translate Action for Filament Admin

v1.0.0 2023-12-08 07:17 UTC

This package is auto-updated.

Last update: 2024-10-31 00:23:52 UTC


README

header

Filament Translate Action

Latest Version on Packagist Software License GitHub Workflow Status Total Downloads

Translate your models with a single action click via DeepL.

Installation

composer require pxlrbt/filament-translate-action

Usage

Set an API Key

Setup a free account on DeepL. You can get your API key from your account page: https://www.deepl.com/de/account/summary.

Then configure the API key in your AppServiceProvider:

use pxlrbt\FilamentTranslateAction\Filament\Actions\TranslateAction

public function boot(): void
{
    // ...
    TranslateAction::apiKey('your-api-key');
    // ...
}

Use the action

Add the action to the header actions for your page. You can specify the sourceLocale otherwise it will default to en.

class EditUser extends \Filament\Resources\Pages\EditRecord
{
    // ...
    protected function getHeaderActions(): array
    {
        return [
            TranslateAction::make()
                ->sourceLocale('de'),
        ];
    }    
}

Contributing

If you want to contribute to this packages, you may want to test it in a real Filament project:

  • Fork this repository to your GitHub account.
  • Create a Filament app locally.
  • Clone your fork in your Filament app's root directory.
  • In the /filament-translate-action directory, create a branch for your fix, e.g. fix/error-message.

Install the packages in your app's composer.json:

"require": {
    "pxlrbt/filament-translate-action": "dev-fix/error-message as main-dev",
},
"repositories": [
    {
        "type": "path",
        "url": "filament-translate-action"
    }
]

Now, run composer update.

Credits