README

此 Laravel Nova 允许您使任何输入字段 astrotomic/laravel-translatable 兼容并可本地化。

要求

PHP: >=8.0
laravel/nova: ^4.12
astrotomic/laravel-translatable: ^11.10

功能

支持几乎所有字段（包括第三方字段）
自动支持默认验证
易于实现，只需进行最小代码更改（在 astrotomic/laravel-translatable 支持之后）
区域设置标签，用于在相同字段的区域设置值之间切换
双击标签以切换所有字段到该区域设置
支持 nova-settings 包

已知不工作的字段

Image 和 File
- 解决方案
  - outl1ne/nova-media-hub
  - 或任何使用 XHR 上传图像/文件的库

限制

以下方法不能使用，因为此包内部使用它们
- resolveUsing
- fillUsing

截图

安装

首先，设置 astrotomic/laravel-translatable。

通过 Composer 在 Laravel Nova 项目中安装此包

# Install nova-astrotranslatable
composer require kiritokatklian/nova-astrotranslatable

# 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() 并将 HandlesTranslatable 特性添加到您的 Nova 资源中。

->rulesFor 接受 array|string|callable 区域和 array|callable 规则。

use Kiritokatklian\NovaAstrotranslatable\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-astrotranslatable-config"

从配置选项填充其他区域设置

配置选项 fill_other_locales_from 允许您从单个区域设置预先填充其他区域设置。这要求资源也具有 HandlesTranslatable 特性。

一个选择所有字段的页面

如果您不想在每个字段旁边显示区域设置选择，可以将 display_type 设置为 none 并将 Kiritokatklian\NovaAstrotranslatable\Fields\LocaleSelect 字段添加到您的 Nova 资源中。这将渲染一个用于所有字段的单个选择。

边缘情况

属于多个允许DuplicateRelations的边缘情况

当您使用此字段作为具有 ->allowDuplicateRelations() 的 BelongsToMany 作为连接字段，并且您想要使用 NotExactlyAttached 规则过滤出精确匹配时，请使用 BelongsToManyTranslatable 字段而不是常规的 BelongsToMany。

致谢

许可证

此项目是开源软件，许可协议为 MIT 许可证。

kr1tokatklian / nova-astrotranslatable

维护者

详细信息