- How do I install and register leek/filament-right-click?
- Run composer require leek/filament-right-click, then run php artisan filament:assets to publish the package assets. Register the plugin on each panel that should support context menus by adding ->plugin(FilamentRightClickPlugin::make()) to the panel configuration. The assets are loaded on request, so skipping the filament:assets step leaves the menus silently non-functional.
- Which Filament versions does leek/filament-right-click support?
- Version 2.x requires Filament 5.6.4 or newer and drops Filament 4 support entirely. Panels still on Filament 4 must pin the package to ^1.5. Because the support matrix is split, check your panel's Filament version before choosing a constraint.
- How do I add a right-click context menu to a Filament table?
- Call contextMenuActions() inside your table() method and pass an array of ContextMenuItem::for() entries wrapping native Filament actions. Each item can set a label, icon, and color. The wrapped actions are registered as table actions but are not rendered in the normal row action column.
- What is the difference between contextMenuActions() and contextMenuBulkActions()?
- contextMenuActions() defines the menu shown when right-clicking a single record row. contextMenuBulkActions() defines the menu for the current selection and wraps BulkAction instances via ContextMenuItem::forBulkAction(). Bulk items receive the selected records collection, while row items receive a single record.
- Does it support Flowforge Kanban boards?
- Yes. When Flowforge is installed, the package registers a board macro that adds context menus to Kanban cards in addition to table rows. If Flowforge is not part of your stack, the Kanban feature is simply inert and can be ignored during evaluation.
- Do context menu items respect Filament authorization, hidden, and disabled checks?
- Yes. Every menu entry wraps a native Filament Action or BulkAction, so authorization, hidden(), disabled(), validation, confirmation, and notifications are all handled by Filament. Server-side checks still apply even though the item appears in a context menu. Note that an action hidden for a row makes the menu close with no visible feedback, which can look like a bug to users.
- Why does nothing happen when I right-click a Filament table row?
- The most common causes are missing assets and an unregistered plugin. Confirm you ran php artisan filament:assets and that FilamentRightClickPlugin::make() is registered on that specific panel. Also verify the package version matches your Filament version, since 2.x requires Filament 5.6.4 or newer and mount paths can break silently after a Filament minor upgrade.
- Does the right-click menu work on touch devices or tablets?
- Touch and long-press support is explicitly out of scope for v1, so a right-click-only affordance is invisible on tablets and mouse-less setups. Keyboard access is solid, supporting the ContextMenu key, Shift+F10, arrow navigation, Enter or Space to activate, and Escape to close. If you need tablet parity, treat that surface as unsupported for now.
- How do I group context menu items with sections and separators?
- Use ContextMenuSection::make([...])->label('Manage') to group related items under a heading, and ContextMenuSeparator::make() to draw a divider between groups. Items support label(), icon(), and color() for presentation. In v2, ContextMenuItem::mirrors('rowAction') hides items per row and prunes empty sections and dangling separators.
- Is leek/filament-right-click production-ready, and how do I reduce upgrade risk?
- It is MIT licensed and architecturally low-risk, but it has roughly 40 stars, a single maintainer, and near-zero dependent packages, so bus factor and regression coverage are the real costs. Pin a specific version, add a canary test that actually fires a context menu action, and include php artisan filament:assets in your release runbook. Prefer v2 where your Filament version allows, since it adds mirrors() and pruning to soften the silent-failure UX.