README

Nova Inline Relationship

Nova Inline Relationship 允许您直接从父对象的创建/编辑界面管理（添加/编辑/更新/删除/重新排序）对象的关系。通过将关系作为行内属性呈现，您可以提供内容编辑人员一个简化和高效的流程来管理复杂数据。

需求

此包需要 Laravel Nova 4.0。

安装

您可以通过 composer 在使用 Nova 的 Laravel 应用中安装此包

composer require kirschbaum-development/nova-inline-relationship

用法

要在您的模型资源中使用 NovaInlineRelationship，只需向相关模型资源字段的常规语法中添加一个行内方法即可。

假设一个 BlogPost 模型与 Image 模型有一个一对多关系，那么您的 BlogPost 资源将如下所示

namespace App\Nova;

use Laravel\Nova\Fields\Image;

class BlogPost extends Resource
{
    //...
    public function fields(Request $request)
    {
        return [
            //...

            HasMany::make('Images', 'images', Image::class)->inline(),
        ];
    }
}

注意： 您需要为 Image 添加一个 Nova 资源 - 所有字段和规则都将从指定的资源检索。您必须将资源指定为关系字段的第三个参数，如上所示。

添加相关模型

设置后，您可以直接在创建基础模型时添加新的相关模型。您可以使用“添加新 Image”按钮将新的 Image 添加到 BlogPost。

查看相关模型

相关模型现在也将以行内方式显示。

更新相关模型

您还可以更新、重新排列（对于一对多关系）和删除相关模型。

您可以使用 sortUsing() 方法添加拖放功能以更新相关模型以更新其顺序。在以下代码示例中，我们使用名为 order 的字段来存储 Images 模型的排序顺序。

HasMany::make('Images')->inline()->sortUsing('order'),

必需的关系

偶尔，您可能希望在创建模型时要求子关系。为此，只需使用 requireChild() 方法。例如，您可能希望创建一个新用户并强制创建该用户的新的配置文件。

HasOne::make('Profile', 'profile', Profile::class)->inline()->requireChild(),

第三方包支持

我们已经提供了一种简单的方法来解决第三方包偶尔无法与 Nova Inline Relationships 工作的问题。这些包偶尔会以略微不同的方式处理它们返回的字段子集。我们有一种简单的方法来集成这些包的功能。这可能不适用于所有情况，但应该允许大多数第三方包。

您必须使用以下命令发布此包的配置

php artisan vendor:publish

这将发布一个配置文件 config/nova-inline-relationships.php。在 third-party 数组中添加您自定义的命名空间路径。例如

'third-party' => [
    'App\Nova\ThirdPartyIntegrations',
    'KirschbaumDevelopment\NovaInlineRelationship\Integrations',
]

在该命名空间内创建一个新类，如下所示

<?php

namespace App\Nova\ThirdPartyIntegrations;

use KirschbaumDevelopment\NovaInlineRelationship\Integrations\ThirdParty;
use KirschbaumDevelopment\NovaInlineRelationship\Integrations\Contracts\ThirdPartyContract;

class SomeThirdPartyField extends ThirdParty implements ThirdPartyContract
{
    /**
     * Fields array from object.
     *
     * @return array
     */
    public function fields(): array
    {
        // The following is just an example and should be updated to meet your needs.
        return $this->field->customFieldArray;
    }
}

类的名称非常重要。它应该与 Nova 资源中使用的字段名称相同。如果字段类是 CustomField，则第三方集成类也应称为 CustomField。

fields() 方法应返回一个包含所有自定义字段或包字段的数组。

如果您认为您创建的第三方集成应该包含在此包中，请创建一个 pull request，我们将审查它！

支持的关系

以下 Eloquent 关系目前受到支持

• BelongsTo
• HasOne
• HasMany
• 形态一
• 形态多

支持字段

以下原生Nova 2.0字段已确认可以正常使用。

• 布尔值
• 代码
• 国家
• 货币
• 日期
• 日期时间
• Markdown
• 数字
• 密码
• 地点
• 选择
• 文本
• 文本区域
• 时区
• Trix
• 头像
• 图片
• 文件

变更日志

有关最近更改的更多信息，请参阅变更日志。

贡献

有关详细信息，请参阅贡献指南。

安全

如果您发现任何与安全相关的问题，请通过电子邮件navneet@kirschbaumdevelopment.com或nathan@kirschbaumdevelopment.com联系我们，而不是使用问题跟踪器。

赞助

此包的开发由Kirschbaum Development Group赞助，这是一家以解决问题、团队建设和社区为中心的开发者驱动型公司。了解更多关于我们或加入我们！

许可证

MIT许可证（MIT）。有关更多信息，请参阅许可证文件。