digital-creative / nova-detached-actions
A Laravel Nova tool to allow for placing actions in the Nova toolbar detached from the checkbox selection mechanism.
Installs: 16 172
Dependents: 0
Suggesters: 0
Security: 0
Stars: 4
Watchers: 3
Forks: 50
Language:Vue
Requires
- php: >=7.1.0
This package is auto-updated.
Last update: 2024-12-10 02:33:59 UTC
README
A Laravel Nova tool to allow for placing actions in the Nova toolbar, detached from the checkbox selection mechanism.
⚠️ Keep in mind, since the action is detached from the row selection checkboxes in the resource table, you will not have a collection of models to iterate over. Detached actions are intended to be independent of the selection in the table.
Installation
You can install the package in to a Laravel app that uses Nova via composer:
composer require digital-creative/nova-detached-actions
Usage
Create a custom Nova Action file:
php artisan nova:action ExportUsers
Instead of extending the ExportUsers
class with the Laravel\Nova\Actions\Action
class, swap it with the DigitalCreative\DetachedActions\DetachedAction
class.
Since we won't receive a collection of $models
, you can remove the variable from the handle
method, so that the signature is public function handle(ActionFields $fields)
.
You can also customize the button label, by overriding the label()
method. If you do not override the label, it will 'humanize' the class name, in the example ExportUsers
would become Export Users
.
Here's a full example:
<?php namespace App\Nova\Actions; use DigitalCreative\DetachedActions\DetachedAction; use Illuminate\Bus\Queueable; use Illuminate\Queue\SerializesModels; use Illuminate\Queue\InteractsWithQueue; use Illuminate\Contracts\Queue\ShouldQueue; use Laravel\Nova\Fields\ActionFields; class ExportUsers extends DetachedAction { use InteractsWithQueue, Queueable, SerializesModels; /** * Get the displayable label of the button. * * @return string */ public function label() { return __('Export Users'); } /** * Perform the action. * * @param ActionFields $fields * * @return mixed */ public function handle(ActionFields $fields) { // Do work to export records return DetachedAction::message('It worked!'); } /** * Get the fields available on the action. * * @return array */ public function fields() { return []; } }
Register the action on your resource:
... /** * Get the actions available for the resource. * * @param \Illuminate\Http\Request $request * @return array */ public function actions(Request $request) { return [ new App\Nova\Actions\ExportUsers ]; } ...
Usage with the Laravel Nova Excel DownloadExcel
action
You can easily integrate the DetachedAction
tool with the Laravel Nova Excel DownloadExcel
action by simply passing some additional data along using withMeta()
.
... /** * Get the actions available for the resource. * * @param \Illuminate\Http\Request $request * @return array */ public function actions(Request $request) { return [ (new DownloadExcel)->withHeadings()->askForWriterType()->withMeta([ 'detachedAction' => true, 'label' => 'Export' ])->confirmButtonText('Export'), ]; } ...
License
The MIT License (MIT). Please see License File for more information.