- What is mttzzz/nova-detached-actions used for?
- It lets Laravel Nova actions run from the toolbar without requiring users to select resources with checkboxes. This is useful for tasks like imports, sync jobs, exports, or bulk utilities that do not operate on selected rows. You define the action and register it through your Nova resource or tool.
- How do I install mttzzz/nova-detached-actions in Laravel Nova?
- Install it with Composer using composer require mttzzz/nova-detached-actions. Then register the package as a Nova tool in the tools() array of your NovaServiceProvider, following the repository README for the exact class and options. After registration, publish any assets or configuration only if the README instructs you to.
- How do I register a detached action in a Nova resource?
- Create a normal Nova action class for the logic you want to run, then register it as a detached action using the package's resource or tool integration. The key difference is that the action is available in the toolbar without depending on selected rows. Check the README for the exact registration method and any required trait or interface.
- Can detached actions run without selecting any resources?
- Yes. The package is specifically designed to detach actions from Nova's checkbox selection mechanism, so the action can be triggered without a selected resource. Your action should therefore handle its own input or context rather than relying on a collection of selected models.
- Which Laravel Nova versions does this package support?
- The supported Laravel and Nova versions are constrained in the package's composer.json, so check that file and the repository README before installing. Compatibility can change between releases, especially across major Nova versions. Pin the package version that matches your Nova installation.
- How do I create an import or sync action in Nova with this package?
- Build a Nova action class that performs the import or sync logic, then register it as detached through this package so it appears in the Nova toolbar. Since no rows are selected, the action should get its data from a file upload, configuration, API call, or another explicit input. Avoid assuming selected models are present.
- Do detached actions appear in the Nova toolbar?
- Yes, the package is intended to place detached actions in the Nova toolbar, separate from the normal row-selection action flow. The exact toolbar placement and visibility can depend on how you register the action and your Nova configuration.
- How do I test detached actions in Laravel Nova?
- Test the underlying action class like any other Laravel action, covering its business logic and validation independently of Nova. For Nova integration, use your existing Nova testing approach and verify the detached action is registered and callable without selected resources. The README may provide package-specific testing guidance.
- Is this package suitable for production bulk operations?
- It can be suitable for production bulk operations, but the action itself must be designed for safety: validate input, authorize access, handle long-running work in queues, and avoid timeouts. Detached actions do not have selected resources, so logging and idempotency are especially important. Review the package's maintenance status and test in staging first.
- What are alternatives to nova-detached-actions for running actions without selection?
- Alternatives include building custom Nova toolbar components or tools, using Nova's native actions with custom selection behaviour, or implementing your own controller endpoints and buttons. Choose based on whether you need a reusable action class, toolbar placement, and no-checkbox execution. This package is a focused option for the detached-action pattern.