https://github.com/emiliogrv/nova-batch-load

A Laravel Nova XLS & CSV importer
https://github.com/emiliogrv/nova-batch-load

Last synced: about 2 months ago
JSON representation

A Laravel Nova XLS & CSV importer

• Host: GitHub
• URL: https://github.com/emiliogrv/nova-batch-load
• Owner: emiliogrv
• License: mit
• Created: 2019-07-05T17:32:33.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2022-02-26T14:56:42.000Z (almost 3 years ago)
• Last Synced: 2024-03-23T08:21:34.107Z (10 months ago)
• Language: Vue
• Size: 1.98 MB
• Stars: 15
• Watchers: 2
• Forks: 4
• Open Issues: 15
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# A Laravel Nova XLS & CSV importer

[![Latest Version on Packagist](https://img.shields.io/packagist/v/emiliogrv/nova-batch-load.svg?style=flat-square)](https://packagist.org/packages/emiliogrv/nova-batch-load)

[![Total Downloads](https://img.shields.io/packagist/dt/emiliogrv/nova-batch-load.svg?style=flat-square)](https://packagist.org/packages/emiliogrv/nova-batch-load)

## Description

This Package allow you to create many new entries at once, loading a file from creating resource screen.

Validation, fields and creating events are same that you declared into yours Resource's fields function.

## Install

```

composer require emiliogrv/nova-batch-load

```

## Usage

```php

// in your Nova's Resources

// ...

use Emiliogrv\NovaBatchLoad\BatchLoadField;

// ...

public function fields(Request $request)

{

    return [

        // ...

        BatchLoadField::make()

            ->accept('.xlsx') // Optional

            ->defaultTabActive(1) // Optional

            ->ignoreAttributes('some_attribute_name') // Optional

            ->keepOriginalFields('belongs|select|boolean'), // Optional

        // ...

    ];

}

```

## i18n

To translate add this to your `resources/lang/vendor/nova/xx.json`

```json

    "File empty!": "Archivo vacío",

    "Load per file": "Carga por archivo",

    "Manual loading": "Carga manual",

    "Upload file": "Subir archivo",

    "Upload file & Add Another": "Subir archivo y Añadir Otro"

```

## API

| Function                | Type      | Default             | Description                                                   |

| ----------------------- | --------- | ------------------- | ------------------------------------------------------------- |

| `accept`                | `String`  | `.xlsx, .xls, .csv` | Set the accepted file formats by extensions.                  |

| `defaultTabActive`      | `Integer` | `0`                 | Set the tab default when the component is mounted.            |

| `ignoreAttributes`      | `String`  |                     | Set attribute names that will be ignored and will not appear. |

| `keepOriginalFields`    | `String`  | `belongs\|morph`    | Set which fields keep as original Nova format and options.    |

| `withoutOriginalFields` |           |                     | Do not show any original fields.                              |

## Screenshots

![Screenshot from 2019-07-05 15 12 44](https://user-images.githubusercontent.com/13983577/60739532-a82cbd00-9f38-11e9-90bf-879d112a7669.png)

![Screenshot from 2019-07-05 15 13 12](https://user-images.githubusercontent.com/13983577/60739533-a82cbd00-9f38-11e9-8580-e007f37001be.png)

![Screenshot from 2019-07-05 15 13 56](https://user-images.githubusercontent.com/13983577/60739534-a82cbd00-9f38-11e9-9625-276ce2799ce7.png)

## Contributing

Thank you for considering contributing! Please leave your [PR](https://github.com/emiliogrv/nova-batch-load/pulls) or [issue](https://github.com/emiliogrv/nova-batch-load/issues).

## Tested with Laravel Nova 2.\*

# License

[MIT](https://opensource.org/licenses/MIT)