willis1776 / nova-excel-import

一个批量导入资源的卡片

v3.2.0 2023-02-22 19:07 UTC

README

laravel nova的自定义导入卡片。这个包基本上只是laravel-excel导入的一个UI,但它不是Maatwebsite的官方包。

Nova Import Card Screenshot

安装

您可以通过composer将此包安装到使用Nova的Laravel应用程序中。

composer require willis1776/nova-import-card

接下来,您必须注册该卡片。通常在相应的资源或NovaServiceProvider的card方法中完成此操作。

// in app/Providers/NovaServiceProvider.php or app/Nova/<Resource>.php

// ...

public function card()
{
    return [
        // ...
        new \Willis1776\NovaExcelImport\NovaExcelImport(\App\Nova\User::class),
    ];
}

自定义

要自定义导入过程,请创建一个新的导入类。导入类基本上是laravel-excel包的导入实现。开始的最简单方法是扩展Willis1776\NovaExcelImport\BasicImporter并重写不同的方法。在导入过程中,您可能需要抛出一个带有用户可见错误信息的Willis1776\NovaExcelImport\ImportException异常。您还可以添加一个message(): String方法来自定义成功消息。

自定义导入类可以在全局或资源基础上注册。

// app/Nova/User.php

class User extends Resource
{

    public static $importer = CustomImporter::class;
    
    // ...
}

// or app/config/nova-import-card.php

return [
    'importer' => CustomImporter::class,
    
    // ...
]

测试

composer test

变更日志

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

贡献

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

许可证

MIT许可证(MIT)。有关更多信息,请参阅许可证文件