<p align="center">
<a href="https://larazeus.com"><img src="https://larazeus.com/images/lara-zeus-translatable.webp" /></a>
</p>

<h4 align="center">Lara Zeus Translatable is Filament support for Spatie's Laravel Translatable package.</h4>

> [!IMPORTANT]  
> This plugin is for filament v3 only, if you're looking for filament v4 support, please check the new repo: [spatie translatable](https://github.com/lara-zeus/spatie-translatable).

## Support Filament

<a href="https://github.com/sponsors/danharrin">
<img alt="filament-logo" src="https://larazeus.com/images/filament-sponsor-banner.webp">
</a>

## Introduction

This repository is a fork of the [Filament Spatie Laravel Translatable plugin](https://github.com/filamentphp/spatie-laravel-translatable-plugin), maintained by [Mohamed Sabil](https://github.com/mohamedsabil83) and [Lara Zeus](https://github.com/lara-zeus).

Our objective is to address existing issues, introduce additional features, and enhance the overall functionality of the plugin.

We are committed to providing ongoing improvements and welcome contributions and suggestions from the community.

## Features

- 🔥 Using Spatie translatable package
- 🔥 default translatable locales
- 🔥 Locale Switcher
- 🔥 Support for create, edit, list and view pages
- 🔥 Setting the translatable locales for a particular resource
- 🔥 Translating relation managers

## Full Documentation

> Visit our website to get the complete documentation: https://larazeus.com/docs/translatable

### Important Note on Using the Local Switcher

Please be aware that there are some known limitations when using the local switcher with certain complex field types.

To avoid potential issues, we recommend disabling the local switcher and using the specified field types instead.

#### Available Components for Translatable Fields:

* https://filamentphp.com/plugins/abdulmajeed-jamaan-translatable-tabs
* https://filamentphp.com/plugins/solution-forest-translate-field
* https://filamentphp.com/plugins/mvenghaus-translatable-inline
* https://filamentphp.com/plugins/outerweb-translatable-fields
* https://filamentphp.com/plugins/34ml-translatable-field

You can also create your own custom fields. Please refer to the following example:

* https://github.com/lara-zeus/chaos/blob/1.x/src/Forms/Components/MultiLang.php

## Changelog

Please see [CHANGELOG](CHANGELOG.md) for more information on recent changes.

## Support
available support channels:
* open an issue on [GitHub](https://github.com/lara-zeus/translatable/issues)
* Email us using the [contact center](https://larazeus.com/contact-us)

## Contributing

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

## Security

If you find any security-related issues, please email info@larazeus.com instead of using the issue tracker.

## Credits

-   [Dan Harrin](https://github.com/danharrin)
-   [php coder](https://github.com/atmonshi)
-   [Mohamed Sabil](https://github.com/mohamedsabil83)
-   [All Contributors](../../contributors)

## License

The MIT License (MIT). Please have a look at [License File](LICENSE.md) for more information.
