Nova standalone action in the menu

To create a standalone action in Laravel Nova that appears in the menu and is not tied to a specific resource, you can follow these steps:

1. Create a Custom Tool: Nova allows you to create custom tools that can be added to the Nova sidebar. This is a good way to implement standalone functionality.

2. Generate the Tool: Use the Artisan command to generate a new tool.

   php artisan nova:tool vendor/name
   

   Replace vendor/name with your desired namespace and tool name.

3. Register the Tool: After generating the tool, you need to register it in the NovaServiceProvider. Open app/Providers/NovaServiceProvider.php and add your tool to the tools method:

   public function tools()
   {
       return [
           new \Vendor\Name\ToolName,
       ];
   }
   

4. Build the Tool: Navigate to the tool's directory and run the following command to compile the tool's assets:

   cd nova-components/ToolName
   npm install
   npm run dev
   

5. Implement the Functionality: In your tool's directory, you can implement the logic for file conversion and download. You might want to create a controller to handle the file processing and return the response.

6. Add a Menu Link: In the tool's resources/js/tool.js file, you can define a menu link that points to your tool's page:

   Nova.booting((Vue, router, store) => {
       router.addRoutes([
           {
               name: 'tool-name',
               path: '/tool-name',
               component: require('./components/ToolComponent'),
           },
       ])
   })
   

7. Create the Vue Component: In the resources/js/components directory, create a Vue component that will serve as the interface for your tool. This component can include a form for file upload and a button to trigger the conversion process.

8. Handle the File Conversion: In your Laravel application, create a controller method to handle the file conversion logic. You can use Laravel's file storage and response features to process the file and return it as a download.

Here's a basic example of how you might set up the controller method:

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Storage;

class FileConversionController extends Controller
{
    public function convert(Request $request)
    {
        // Validate and process the uploaded file
        $request->validate([
            'file' => 'required|file',
        ]);

        $file = $request->file('file');
        $convertedFilePath = $this->convertFile($file);

        // Return the converted file as a download
        return response()->download($convertedFilePath);
    }

    protected function convertFile($file)
    {
        // Implement your file conversion logic here
        // For example, convert the file and save it to storage

        $convertedFilePath = 'path/to/converted/file';
        // ...

        return $convertedFilePath;
    }
}

By following these steps, you can create a standalone tool in Laravel Nova that appears in the menu and provides the functionality you need.