README

Filament Service Desk

A Filament plugin for jeffersongoncalves/laravel-service-desk that provides Admin, Agent, and User panels for complete service desk management.

Compatibility

Version	Filament	PHP	Laravel	Tailwind
1.x	^3.0	^8.1	^10.0	3.x
2.x	^4.0	^8.2	^11.0	4.x
3.x	^5.0	^8.2	^11.28	4.x

Installation

You can install the package via composer:

composer require jeffersongoncalves/filament-service-desk:"^3.0"

Publish the configuration (optional):

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

Usage

Admin Panel

Full management capabilities: departments, categories, tags, tickets, SLA, email channels, knowledge base, and service catalog.

use JeffersonGoncalves\FilamentServiceDesk\ServiceDeskPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            ServiceDeskPlugin::make()
                ->knowledgeBase(true)
                ->sla(true)
                ->emailChannels(true)
                ->serviceCatalog(true)
                ->navigationGroup('Service Desk'),
        ]);
}

Resources: Department, Category, Tag, Canned Response, Ticket (with comments, attachments, history, watchers), SLA Policy (with targets, escalation rules), Business Hours Schedule (with time slots, holidays), Email Channel, KB Article (with versions, feedback), KB Category, Service (with form fields), Service Category.

Widgets: Service Desk Overview, SLA Compliance Chart, Tickets by Department Chart.

Agent Panel

Ticket handling and response for support agents.

use JeffersonGoncalves\FilamentServiceDesk\ServiceDeskAgentPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            ServiceDeskAgentPlugin::make(),
        ]);
}

Resources: Ticket (scoped to assigned), Canned Responses (read-only).

Pages: Ticket Queue (claim unassigned tickets), Agent Dashboard.

Widgets: Agent Ticket Stats, SLA Breach Table.

User Panel

Self-service portal for end users.

use JeffersonGoncalves\FilamentServiceDesk\ServiceDeskUserPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            ServiceDeskUserPlugin::make()
                ->knowledgeBase(true)
                ->serviceCatalog(true),
        ]);
}

Resources: Ticket (create/view own), Service Request (wizard with dynamic form).

Pages: Knowledge Base (search, browse, feedback).

Widgets: My Tickets Overview.

Feature Toggles

Each plugin supports fluent feature toggles:

Method	Default	Description
`knowledgeBase(bool)`	`true`	KB articles and categories
`sla(bool)`	`true`	SLA policies, targets, escalation
`emailChannels(bool)`	`true`	Email channel management
`serviceCatalog(bool)`	`true`	Service catalog and requests

Features can also be toggled globally in config/filament-service-desk.php.

Customizing Widgets

Each panel's dashboard widgets can be customized via the configuration file. You can add, remove, or reorder widgets:

// config/filament-service-desk.php
'widgets' => [
    'admin' => [
        \JeffersonGoncalves\FilamentServiceDesk\Admin\Widgets\ServiceDeskOverviewWidget::class,
        \JeffersonGoncalves\FilamentServiceDesk\Admin\Widgets\SlaComplianceWidget::class,
        \JeffersonGoncalves\FilamentServiceDesk\Admin\Widgets\TicketsByDepartmentWidget::class,
        // Add your custom widgets here
    ],
    'agent' => [
        \JeffersonGoncalves\FilamentServiceDesk\Agent\Widgets\AgentTicketStatsWidget::class,
        \JeffersonGoncalves\FilamentServiceDesk\Agent\Widgets\SlaBreachWidget::class,
    ],
    'user' => [
        \JeffersonGoncalves\FilamentServiceDesk\User\Widgets\MyTicketsOverviewWidget::class,
    ],
],

To disable all widgets for a panel, set it to an empty array:

'widgets' => [
    'admin' => [], // No widgets on admin dashboard
],

Attachments Configuration

Configure file upload settings for ticket attachments in the configuration file:

// config/filament-service-desk.php
'attachments' => [
    'allowed_extensions' => ['jpg', 'jpeg', 'png', 'gif', 'webp', 'pdf', 'doc', 'docx', 'xls', 'xlsx', 'csv', 'txt', 'zip', 'rar'],
    'max_file_size' => 10240, // in KB (10MB)
    'disk' => 'local',
],

Option	Default	Description
`allowed_extensions`	Common file types	File extensions resolved to MIME types via Symfony MimeTypes
`max_file_size`	`10240` (10MB)	Maximum file size in kilobytes
`disk`	`local`	Filesystem disk for storing attachments

Localization

Translations are provided for:

English (en)
Brazilian Portuguese (pt_BR)

Publish translations to customize:

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

Testing

composer test

Changelog

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

Contributing

Please see CONTRIBUTING for details.

License

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

jeffersongoncalves / filament-service-desk

Maintainers

Package info

Fund package maintenance!

Statistics

Security