moonshine/import-export

Import/Export Handlers for MoonShine

2.0.0 2025-10-25 17:22 UTC

Requires

• php: ^8.2|^8.3
• ext-curl: *
• ext-json: *
• openspout/openspout: <4.29
• rap2hpoutre/fast-excel: ^5.4

Conflicts

• laravel/framework: <10.48.0
• moonshine/moonshine: <4.0

MIT

• Danil Shutsky

• import
• export
• moonshine

README

Documentation

Requirements

• MoonShine 4+
• Laravel 10+
• PHP 8.2+

Installation

composer require moonshine/import-export

Usage

• In ModelResource add the ImportExportConcern trait and implement the HasImportExportContract interface.

use MoonShine\ImportExport\Contracts\HasImportExportContract;
use MoonShine\ImportExport\Traits\ImportExportConcern;

class CategoryResource extends ModelResource implements HasImportExportContract
{
    use ImportExportConcern;
    
    // ...
}

• Define the fields that will be involved in import and export.

protected function exportFields(): iterable
{
    return [
        ID::make(),
        Position::make(),
        Text::make('Name'),
    ];
}

protected function importFields(): iterable
{
    return [
        ID::make(),
        Text::make('Name'),
    ];
}

• Import Events.

public function beforeImportFilling(array $data): array
{
    return $data;
}

public function beforeImported(mixed $item): mixed
{
    return $item;
}

public function afterImported(mixed $item): mixed
{
    return $item;
}

• Queue.

protected function export(): ?Handler
{
    return ExportHandler::make(__('moonshine::ui.export'))
        ->when(
            $this->isExportToCsv(),
            static fn (ExportHandler $handler): ExportHandler => $handler->csv()
        )
        ->queue();
}

protected function import(): ?Handler
{
    return ImportHandler::make(__('moonshine::ui.import'))->queue();
}