backpack / translation-manager
Backpack 的翻译管理器
Requires
- backpack/crud: ^6.7
- calebporzio/sushi: ^2.4
- outhebox/blade-flags: ^1.2
- spatie/laravel-translation-loader: ^2.8
Requires (Dev)
- larastan/larastan: ^2.9
- orchestra/testbench: ~8.0|~9.0
- phpunit/phpunit: ~10.0|~11.0
This package is auto-updated.
Last update: 2024-08-30 13:04:44 UTC
README
翻译管理器为您的 Backpack 应用提供简单的用户界面,以帮助您处理翻译。快速浏览,一些最相关的功能包括:
- 查看应用程序语言文件中所有现有翻译的列表(包括供应商翻译)。
- 直接从界面编辑翻译。
- 搜索和过滤翻译以轻松管理。
此包在内部使用经过实战检验的 spatie/laravel-translation-loader。
预览
演示
现在尝试它,在我们的在线演示中编辑一些翻译 (点击此处)。
安装
在您的 Laravel + Backpack 项目中
1) 使用 Composer 安装包:
composer require backpack/translation-manager
2) 配置应用程序
如果您已经安装并配置了 spatie/laravel-translation-loader,您可以跳到下一步。否则,请继续。
2.1) 在您的 config/app.php
中,您必须替换 Laravel 的翻译服务提供程序
-Illuminate\Translation\TranslationServiceProvider::class, +Spatie\TranslationLoader\TranslationServiceProvider::class,
2.2) 您必须发布和运行迁移以创建 language_lines
表
php artisan vendor:publish --provider="Spatie\TranslationLoader\TranslationServiceProvider" --tag="migrations" php artisan migrate
3) 可选设置选项
3.1) 在 menu_items.blade.php
中添加菜单项以方便访问
php artisan backpack:add-menu-content "<x-backpack::menu-item title=\"Translation Manager\" icon=\"la la-stream\" :link=\"backpack_url('translation-manager')\" />"
3.2) 发布配置文件
php artisan vendor:publish --provider="Spatie\TranslationLoader\TranslationServiceProvider" --tag="config" php artisan vendor:publish --provider="Backpack\TranslationManager\AddonServiceProvider" --tag="config"
注意:我们强烈建议您与 Language Switcher 包一起使用此包,这样您就可以轻松地在面板之间切换语言。
用法
列表视图
列表视图显示应用程序中所有翻译的完整列表。默认情况下,列表视图中显示所有翻译,包括供应商翻译。如果您不想看到供应商翻译,您可以将配置选项 load_all_registered_translation_paths
设置为 false
在 config/backpack/translation-manager.php
。
此外,如果您已安装 Backpack Pro,则管理员还可以看到并使用过滤器,以快速缩小翻译范围。
编辑视图
可以点击编辑按钮编辑任何翻译。它将打开一个页面,管理员可以输入所有语言的新值。
一旦编辑,更改将保存到数据库以进行持久化。数据库中的所有翻译都优先于语言文件中的翻译。这意味着您可以安全地让管理员在生产中编辑翻译。您的自动部署将继续工作,因为没有文件被编辑,只有数据库条目。
可编辑列
如果您已安装 Editable Columns 包,则管理员可以直接在列表视图中编辑翻译。这提供了出色的 UX - 因为他们可以翻译得更快,而无需切换页面。
如果您不希望这种行为,可以在 config/backpack/translation-manager.php
文件中将 use_editable_columns => false
设置禁用。如果您找不到该文件,请参阅发布配置文件的步骤。
安全
如果您发现任何与安全相关的问题,请通过电子邮件发送至 cristian.tabacitu@backpackforlaravel.com,而不是使用问题跟踪器。
鸣谢
许可证
本项目采用MIT许可证发布,因此您可以在任何Backpack & Laravel项目之上安装它。有关更多信息,请参阅许可证文件。