nova-kit / nova-queued-export-as-csv
Laravel Nova's Queued Export As CSV Action
v2.3.0
2025-02-21 10:23 UTC
Requires
- php: ^8.1
- composer-runtime-api: ^2.2
- illuminate/support: ^10.48.23|^11.35|^12.0
- laravel/serializable-closure: ^1.0|^2.0
- laravie/serialize-queries: ^3.0
- symfony/polyfill-php83: ^1.31
Requires (Dev)
- guzzlehttp/guzzle: ^7.2
- laravel/nova: ^5.2
- laravel/nova-devtool: ^1.6
- laravel/pint: ^1.20
- orchestra/pest-plugin-testbench: ^2.0|^3.0
- orchestra/testbench: ^8.20|^9.0|^10.0
- phpstan/phpstan: ^2.1
Conflicts
- laravel/nova: <5.0.0|>=6.0.0
README
Installation
To install through composer, run the following command from terminal:
composer require "nova-kit/nova-queued-export-as-csv"
Usages
You can replace Laravel\Nova\Actions\ExportAsCsv
with NovaKit\NovaQueuedExportAsCsv\Actions\QueuedExportAsCsv
:
use Laravel\Nova\Actions\ExportAsCsv; use Laravel\Nova\Http\Requests\NovaRequest; use NovaKit\NovaQueuedExportAsCsv\Actions\QueuedExportAsCsv; // ... /** * Get the actions available for the resource. * * @return array<int, \Laravel\Nova\Actions\Action> */ public function actions(NovaRequest $request): array { return [ QueuedExportAsCsv::make(), ]; }
If you would like to change the storage disk to store the CSV file that is available for download, you may invoke the withStorageDisk()
method when registering the action:
use NovaKit\NovaQueuedExportAsCsv\Actions\QueuedExportAsCsv; // ... return [ QueuedExportAsCsv::make()->withStorageDisk('s3'), ];
You can also customise the response message by using the following code:
use Laravel\Nova\Actions\Action; use NovaKit\NovaQueuedExportAsCsv\Actions\QueuedExportAsCsv; // ... return [ QueuedExportAsCsv::make()->then(function () { return response()->json(Action::message('Action has been queued!')); }), ];
In order to handle the stored CSV, you need to listen to NovaKit\NovaQueuedExportAsCsv\Events\QueuedCsvExported
event, as an example you can broadcast to Nova's Notification using the following listener class:
<?php namespace App\Listeners; use Illuminate\Contracts\Queue\ShouldQueue; use Illuminate\Queue\InteractsWithQueue; use Illuminate\Support\Facades\Storage; use Laravel\Nova\Notifications\NovaNotification; use Laravel\Nova\URL; use NovaKit\NovaQueuedExportAsCsv\Events\QueuedCsvExported; class NotifyCsvExported { /** * Handle the event. * * @param \NovaKit\NovaQueuedExportAsCsv\Events\QueuedCsvExported $event * @return void */ public function handle(QueuedCsvExported $event) { $event->user->notify( NovaNotification::make() ->message('Your CSV is ready to download.') ->action('Download', URL::remote(Storage::disk($event->storageDisk)->url($event->filename))) ->icon('download') ->type('info') ); } }