filament-language-switch：Filament面板的多语言切换插件

filament-language-switch：Filament面板的多语言切换插件

filament-language-switchA versatile and user-friendly plugin designed for Filament Panels.项目地址:https://gitcode.com/gh_mirrors/fi/filament-language-switch

1. 项目介绍

filament-language-switch 是一个为 Filament Panels 设计的灵活易用的工具，旨在无缝集成语言切换功能。它支持自定义配置，允许开发者轻松地为用户提供语言选择选项，并可灵活指定哪些面板或路由应包括语言切换器。该插件专为 Filament v3 打造，提供了丰富的API接口，支持在面板内外展示语言选项。迁移至 v3 版本时，需注意对旧版插件进行适当卸载及配置更新。

2. 项目快速启动

要快速启动并集成 filament-language-switch 到你的 Filament 应用中，请遵循以下步骤：

安装插件

首先，在你的项目根目录下，通过 Composer 添加依赖：

composer require bezhansalleh/filament-language-switch

配置插件

发布配置文件和视图：

php artisan vendor:publish --tag="filament-language-switch-config"
php artisan vendor:publish --tag="filament-language-switch-views"

接着，在 AppServiceProvider 中配置语言切换器：

use BezhanSalleh\FilamentLanguageSwitch\LanguageSwitch;
// 在 register 方法或 boot 方法内
public function boot()
{
    LanguageSwitch::configureUsing(function (LanguageSwitch $switch) {
        $switch->locales(['ar', 'en', 'fr']);
    });
}

如果你想控制语言切换器的显示位置或条件，可以使用对应的配置方法，例如设置外置面板路由：

LanguageSwitch::configureUsing(function (LanguageSwitch $switch) {
    $switch->outsidePanelRoutes(fn() => someCondition() ? ['dynamic route'] : ['default route']);
});

3. 应用案例和最佳实践

为了实现一个完全翻译的Filament资源，包含右上角的语言切换下拉菜单，你需要确保Laravel的本地化已正确配置，并使用此插件来呈现界面元素。请参考官方仓库中的Readme文件，获取详细的配置教程和示例代码。购买所有例子或特定项目实例可以提供完整的实践指南。

4. 典型生态项目

尽管本插件主要设计用于增强Filament框架的多语言能力，但它的灵活性意味着它可以成为任何基于Filament构建的应用程序的基石。在Filament社区和相关论坛中，你可以找到更多将此插件与其他Filament组件结合使用的高级实践和技术讨论，这些是构建多语言后台管理系统的理想生态组成部分。

---

这个简明的指南为你介绍了如何开始使用filament-language-switch插件，从安装到配置，以及一些基本应用思路。深入探索项目文档和源码，将帮助你充分利用这一强大的多语言解决方案。

filament-language-switchA versatile and user-friendly plugin designed for Filament Panels.项目地址:https://gitcode.com/gh_mirrors/fi/filament-language-switch