jeffersongoncalves/filament-help-desk

Filament plugins for jeffersongoncalves/laravel-help-desk — User, Operator, and Admin panels for ticket management.

1.x-dev 2026-02-04 04:43 UTC

Requires

• php: ^8.1
• filament/filament: ^3.0
• jeffersongoncalves/laravel-help-desk: ^1.0
• spatie/laravel-package-tools: ^1.16

Requires (Dev)

• larastan/larastan: ^2.0|^3.0
• laravel/pint: ^1.0
• orchestra/testbench: ^8.0|^9.0
• pestphp/pest: ^2.0|^3.0
• pestphp/pest-plugin-laravel: ^2.0|^3.0
• pestphp/pest-plugin-livewire: ^3.0

MIT

• Jefferson Gonçalves

• support
• laravel
• tickets
• help-desk
• customer-support
• filament

README

Filament plugins for jeffersongoncalves/laravel-help-desk — providing User, Operator, and Admin panels for ticket management.

Requirements

• PHP ^8.1
• Laravel ^10 | ^11 | ^12
• Filament ^3.0
• jeffersongoncalves/laravel-help-desk ^1.0

Installation

composer require jeffersongoncalves/filament-help-desk:^1.0

Publish config (optional)

php artisan vendor:publish --tag="filament-help-desk-config"

Publish views (optional)

php artisan vendor:publish --tag="filament-help-desk-views"

Publish translations (optional)

php artisan vendor:publish --tag="filament-help-desk-translations"

Note: Make sure you have already installed and configured jeffersongoncalves/laravel-help-desk (migrations, config, etc.) before using this package.

Setup

1. Add traits to your User model

use JeffersonGoncalves\HelpDesk\Concerns\HasTickets;
use JeffersonGoncalves\HelpDesk\Concerns\IsOperator;

class User extends Authenticatable
{
    use HasTickets;
    use IsOperator; // Only needed for users who act as operators/admins
}

2. Register plugins in your Filament panels

This package provides 3 independent plugins that can be registered in any combination across your panels:

User Plugin

For end-users to create and track their tickets.

use JeffersonGoncalves\FilamentHelpDesk\FilamentHelpDeskUserPlugin;

class UserPanelProvider extends PanelProvider
{
    public function panel(Panel $panel): Panel
    {
        return $panel
            // ...
            ->plugins([
                FilamentHelpDeskUserPlugin::make(),
            ]);
    }
}

Provides:

• Ticket creation form (department, category, priority, attachments)
• Ticket listing with status/priority filters
• Ticket detail view with comment timeline and reply form
• Stats widget: open, pending, resolved, total tickets

Operator Plugin

For support agents to manage and respond to tickets.

use JeffersonGoncalves\FilamentHelpDesk\FilamentHelpDeskOperatorPlugin;

class OperatorPanelProvider extends PanelProvider
{
    public function panel(Panel $panel): Panel
    {
        return $panel
            // ...
            ->plugins([
                FilamentHelpDeskOperatorPlugin::make(),
            ]);
    }
}

Provides:

• Tabbed ticket queue (My Tickets, Unassigned, All)
• Ticket management: change status, priority, assign operators
• Internal notes and canned responses
• Tickets by status chart widget
• Assigned tickets table widget

Admin Plugin

For administrators to configure the help desk system.

use JeffersonGoncalves\FilamentHelpDesk\FilamentHelpDeskAdminPlugin;

class AdminPanelProvider extends PanelProvider
{
    public function panel(Panel $panel): Panel
    {
        return $panel
            // ...
            ->plugins([
                FilamentHelpDeskAdminPlugin::make(),
            ]);
    }
}

Provides:

• Department CRUD with operator management
• Category CRUD with hierarchical support
• Canned response CRUD
• Email channel configuration
• Full ticket management (all tickets, all statuses)
• Stats overview and priority distribution widgets

Tip: You can combine plugins in a single panel. For example, register both FilamentHelpDeskAdminPlugin and FilamentHelpDeskOperatorPlugin in your admin panel.

Configuration

The configuration file config/filament-help-desk.php allows you to customize:

return [
    'user' => [
        'resource' => \JeffersonGoncalves\FilamentHelpDesk\User\Resources\TicketResource::class,
        'navigation_group' => 'Support',
        'navigation_icon' => 'heroicon-o-ticket',
        'navigation_sort' => null,
        'slug' => 'tickets',
    ],
    'operator' => [
        'resource' => \JeffersonGoncalves\FilamentHelpDesk\Operator\Resources\TicketResource::class,
        'navigation_group' => 'Help Desk',
        'navigation_icon' => 'heroicon-o-inbox-stack',
        'slug' => 'tickets',
    ],
    'admin' => [
        'navigation_group' => 'Help Desk',
        'navigation_icon' => 'heroicon-o-cog-6-tooth',
        'resources' => [
            'ticket' => \JeffersonGoncalves\FilamentHelpDesk\Admin\Resources\TicketResource::class,
            'department' => \JeffersonGoncalves\FilamentHelpDesk\Admin\Resources\DepartmentResource::class,
            'category' => \JeffersonGoncalves\FilamentHelpDesk\Admin\Resources\CategoryResource::class,
            'canned_response' => \JeffersonGoncalves\FilamentHelpDesk\Admin\Resources\CannedResponseResource::class,
            'email_channel' => \JeffersonGoncalves\FilamentHelpDesk\Admin\Resources\EmailChannelResource::class,
        ],
    ],
];

Customizing Resources

Override any resource by pointing to your own class in the config:

'user' => [
    'resource' => \App\Filament\User\Resources\CustomTicketResource::class,
],

Your custom resource can extend the default one:

namespace App\Filament\User\Resources;

use JeffersonGoncalves\FilamentHelpDesk\User\Resources\TicketResource as BaseResource;

class CustomTicketResource extends BaseResource
{
    public static function form(Form $form): Form
    {
        return $form->schema([
            ...static::getTicketFormSchema(isUser: true),
            // Add your custom fields
        ]);
    }
}

Translations

The package includes translations for:

• English (en)
• Brazilian Portuguese (pt_BR)

To add or modify translations, publish them and edit the files in resources/lang/vendor/filament-help-desk/.

Testing

composer test

PHPStan

composer analyse

Code Style (Pint)

composer format

Changelog

Please see CHANGELOG for more information on what has changed recently.

License

The MIT License (MIT). Please see License File for more information.