atendwa / filament-feedback
Feedback for Filament apps: a public form with anonymous or named submissions, a staff inbox with replies, internal notes and resolution, and "My feedback" for signed-in users.
Requires
- php: ^8.3
- filament/filament: ^5.0
- illuminate/support: ^12.0|^13.0
Requires (Dev)
- larastan/larastan: ^3.0
- laravel/pint: ^1.27
- orchestra/testbench: ^10.0|^11.0
- pestphp/pest: ^4.0
- pestphp/pest-plugin-arch: ^4.0
- pestphp/pest-plugin-laravel: ^4.0
- pestphp/pest-plugin-livewire: ^4.0
- rector/rector: ^2.0
- spatie/laravel-permission: ^6.0
Suggests
- spatie/laravel-permission: Lets the package alert everyone holding the Respond:Feedback permission about new feedback and replies.
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-18 02:39:43 UTC
README
Collects feedback from the people who use a Filament application and lets staff answer it. It has three parts:
- A public form at
/give-feedbackthat anyone can use, signed in or not. People can stay anonymous (they are shown under a generated nickname), and can choose to get replies by email through a private, signed link to the conversation. - A staff inbox (Filament resource) to read feedback, reply, add internal notes, resolve with a closing comment and reopen.
- "My feedback" (Filament resource) where signed-in people see what they sent under their name and continue the conversation.
Requirements
PHP 8.3 or later, Laravel 12 or 13 and Filament 5. The user model needs name and email attributes; to receive in-app
replies it uses Laravel's Notifiable trait.
Installation
composer require atendwa/filament-feedback php artisan migrate
Register the plugin on your panels. Typically the inbox goes on the staff panel and "My feedback" on the panel everyone uses:
use Atendwa\Feedback\Filament\FeedbackPlugin; $panel->plugins([ FeedbackPlugin::make()->inboxOnly(), // staff panel ]); $panel->plugins([ FeedbackPlugin::make()->mineOnly()->loginLink(), // everyone's panel; loginLink() adds "Give feedback" under the login form ]);
Configuration
FeedbackPlugin options: inboxOnly(), mineOnly(), loginLink(), cluster(SomeCluster::class), navigationGroup('Support'), sort(10).
Values can be set in a config/feedback.php of your own or at runtime with config([...]).
| Key | Default | Meaning |
|---|---|---|
feedback.categories |
six general topics | choices on the form |
feedback.notify_email |
env('FEEDBACK_NOTIFY_EMAIL') |
comma-separated addresses alerted about new feedback and replies |
feedback.public_limit |
5 |
submissions per hour from one address |
feedback.path |
give-feedback |
URL of the public form |
feedback.user_model |
the users auth provider model |
model that owns named feedback |
feedback.tenant |
null |
callable returning the tenant for links in alert emails (multi-tenant panels) |
feedback.navigation.* |
cluster, group and sort of the inbox and "My feedback" | |
feedback.public.vite |
null |
Vite entry (string or array) loaded on the public page, for your theme |
feedback.public.head |
null |
Blade component rendered in the public page <head> (for example brand styles) |
feedback.public.logo |
null |
logo path for the public page; the app name is shown when empty |
feedback.public.decoration |
null |
Blade component shown beside the public form on large screens |
Usage
- Staff work in the inbox: reply to the submitter, add internal notes, resolve with a closing comment, or reopen.
- Signed-in people find what they sent under "My feedback" and continue the conversation there.
- Anyone can use the public form at
feedback.path;loginLink()puts a "Give feedback" link under the login form. - To offer the form inside a panel, add the action to a page's header actions:
use Atendwa\Feedback\Filament\Actions\GiveFeedback; protected function getHeaderActions(): array { return [ GiveFeedback::make(), ]; }
Extending
The inbox is guarded by a policy that checks these abilities with $user->can(...), so any authorization setup works
(Filament Shield, spatie/laravel-permission, or your own gates):
| Ability | Allows |
|---|---|
ViewAny:Feedback |
open the inbox |
View:Feedback |
open any feedback (people can always open their own named feedback) |
Respond:Feedback |
reply, add notes, resolve and reopen |
If your user model uses spatie/laravel-permission, everyone with Respond:Feedback is also alerted (in the app and by email)
about new feedback and replies.
Testing
composer install
composer quality # Pint, Rector, PHPStan (max), Pest
Changelog
See CHANGELOG.md.
License
MIT. See LICENSE.md.