Installation

Run the following command to add the private Composer repository:

composer config 'repositories.ralphjsmit/*' composer https://satis.ralphjsmit.com

The end result should look something like this:

"repositories": [
    {
        "type": "composer",
        "url": "https://satis.ralphjsmit.com"
    }
]

Next, run the following command to require the package:

composer require ralphjsmit/laravel-filament-auto-translator

If you receive a question to allow the plugin to run code, select yes. Next, you will be prompted for your username (which is your e-mail) and your password (which is your license key, e.g. 8c21df8f-6273-4932-b4ba-8bcc723ef500).

composer require ralphjsmit/laravel-filament-auto-translator:^1.0

composer config http-basic.satis.ralphjsmit.com {your_username} {your_password}

The plugin works by generating the translations for all $livewire components that implement RalphJSmit\Filament\AutoTranslator\Contracts\HasTranslations.

Existing project

If you already have an existing project, you will need to choose whether you want to immediately enable the AutoTranslator for all resources, and potentially need to convert some translation keys, or if you only want to enable it for new resources.

For all resources/pages/clusters/widgets that you want to enable the auto translations for, extend the following files provided by the AutoTranslator instead of those provided by Filament. You can easily do this as a global search-and-replace:

Alternatively, if for the above classes you already have your own (abstract) base class in your application, then you can also implement the HasTranslations interface and add the following traits:

Example for an abstract base Resource class in your own project:

use Filament\Resources\Resource as BaseResource;
use RalphJSmit\Filament\AutoTranslator\Concerns\HasResourceTranslations;
use RalphJSmit\Filament\AutoTranslator\Contracts\HasTranslations;

abstract class Resource extends BaseResource implements HasTranslations
{
    use HasResourceTranslations; 
}

New projects

If you are starting a new project, you can either choose for all your resource/page/cluster/widget classes to extend the classes provided by this package, or to start creating an abstract base class for each of the objects that you extend. For example, look at the above Resource class example. In your project, every time you generate a new resource, you will need to make sure to extend the abstract base class that you created. Having an abstract base class can also be very beneficial in the future if you ever need to add any custom code that should apply to every resource/page/cluster/widget, then you already have a base class, which is a good Filament pattern.

Alternatively, it is also perfectly fine to not bother with abstract base classes but to just extend the classes by the AutoTranslator provided above.

Next, you should register the plugin in each of the panels that you want to be translated:

use RalphJSmit\Filament\AutoTranslator\FilamentAutoTranslator;

$panel
    ->plugin(FilamentAutoTranslator::make())