manogi / nova-translatable
用于 Laravel Nova 的 laravel-translatable 扩展。
Requires
- php: ^8.0.2|^8.1
- laravel/nova: ^4.0
- spatie/laravel-translatable: ^4.0 || ^5.0 || ^6.0
- dev-master
- v2.0.0
- 1.12.0
- 1.11.1
- 1.11.0
- 1.10.1
- 1.10.0
- 1.9.1
- 1.9.0
- 1.8.4
- 1.8.3
- 1.8.2
- 1.8.1
- 1.8.0
- 1.7.2
- 1.7.1
- 1.7.0
- 1.6.12
- 1.6.11
- 1.6.10
- 1.6.9
- 1.6.8
- 1.6.7
- 1.6.6
- 1.6.5
- 1.6.4
- 1.6.3
- 1.6.2
- 1.6.1
- 1.6.0
- 1.5.7
- 1.5.6
- 1.5.5
- 1.5.4
- 1.5.3
- 1.5.2
- 1.5.1
- 1.5.0
- 1.4.1
- 1.4.0
- 1.3.2
- 1.3.1
- 1.3.0
- 1.2.0
- 1.1.2
- 1.1.1
- 1.1.0
- 1.0.0
- dev-dependabot/npm_and_yarn/minimist-1.2.6
This package is auto-updated.
Last update: 2024-09-06 20:39:56 UTC
README
这个 Laravel Nova 允许您使任何输入字段与 spatie/laravel-translatable
兼容并可本地化。
要求
laravel/nova: ^4.0
spatie/laravel-translatable: ^5.0 || ^6.0
特性
- 支持几乎所有字段(包括第三方字段)
- 自动支持默认验证
- 简单实现,只需进行最小的代码更改(在
spatie/laravel-translatable
支持之后) - 地区标签以在相同字段的不同的地区值之间切换
- 双击标签以切换所有字段到该地区
- 支持 nova-settings 包
已知无法工作的字段
Image
和File
- 解决方案
- optimistdigital/nova-media-field
- 或任何使用 XHR 上传图片/文件的库
- 解决方案
限制
- 以下方法不能使用,因为该包内部使用了它们
resolveUsing
fillUsing
displayUsing
(可能最终会修复)
截图
安装
首先,设置 spatie/laravel-translatable。
使用 Composer 在 Laravel Nova 项目中安装此包
# Install nova-translatable composer require optimistdigital/nova-translatable # Publish configuration (optional, but useful for setting default locales) php artisan vendor:publish --tag="nova-translatable-config"
用法
在任何字段上调用 ->translatable()
,如下所示
// Any Nova field Text::make('Name') ->rules('required', 'min:2') ->translatable(), // Any third-party input field Multiselect::make('Football teams') ->rules('required') ->translatable(), // Optionally pass custom locales on a per-field basis Number::make('Population') ->translatable([ 'en' => 'English', 'et' => 'Estonian', ]),
验证
可以定义特定地区的验证规则。
为此,请在您的字段上添加 ->rulesFor()
并在您的 Nova 资源上添加 HandlesTranslatable
特性。
->rulesFor
接受 array|string|callable
地区和 array|callable
规则。
use KraenkVisuell\NovaTranslatable\HandlesTranslatable; class Product extends Resource { use HandlesTranslatable; public function fields(Request $request) { return [ Text::make(__('Name'), 'name') ->sortable() ->translatable() ->rules(['max:255']) ->rulesFor('en', [ 'required', ]) ->rulesFor(['en', 'et'], function ($locale) { return ["unique:products,name->$locale{{resourceId}}"]; }), ]; } }
在这个例子中,规则将被添加到以下值
max: name.* required: name.en unique: name.en & name.et
配置
您可以在配置文件中定义所有 translatable
字段的基本地区。配置文件可以通过以下方式发布
php artisan vendor:publish --tag="nova-translatable-config"
从配置选项填充其他地区
配置选项 fill_other_locales_from
允许您从单个地区预先填充其他地区。这需要资源也具有 HandlesTranslatable
特性。
页面上的所有字段的单选框
如果您不想在每个字段旁边显示地区选择,可以将 display_type
设置为 none
并将 KraenkVisuell\NovaTranslatable\Fields\LocaleSelect
字段添加到您的 Nova 资源中。这将渲染一个用于所有字段的单个选择。
边缘情况
BelongsToMany allowDuplicateRelations 边缘情况
当您使用此字段作为 BelongsToMany 中的枢轴字段并具有 ->allowDuplicateRelations()
,并且您想使用 NotExactlyAttached
规则过滤出精确匹配时,请使用 BelongsToManyTranslatable
字段而不是常规的 BelongsToMany
。
致谢
许可证
此项目是开源软件,受 MIT 许可证 许可。