mag/WMS
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

new helpdesk module now with kabann board

Browse Source
This commit is contained in:
Mark Gregory
2026-06-12 11:17:59 +01:00
parent 98c6ee4597
commit f598028fe9
12 changed files with 286 additions and 260 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Modules/Helpdesk/Docs/WMS_SUPPORT_MENU_PATCH.md
+16
View File
@@ -0,0 +1,16 @@
# WMS Support Menu Patch
Add this block to the main application sidebar inside `<nav class="wms-sidebar-nav">`, preferably after the Operations group and before Integration & Reporting.
```blade
@includeIf('helpdesk::partials.sidebar-support-menu')
```
The partial checks that the Helpdesk module is enabled through `nwidart/laravel-modules` when the Module facade exists, and also checks that the Helpdesk routes are registered before showing links.
After adding the include, run:
```bash
artisan optimize:clear
artisan octane:reload
```
Modules/Helpdesk/Http/Controllers/HelpdeskController.php
+8 -2
View File
@@ -6,14 +6,20 @@ namespace Modules\Helpdesk\Http\Controllers;
use App\Http\Controllers\Controller;
use Illuminate\Contracts\View\View;
use Illuminate\Support\HtmlString;
final class HelpdeskController extends Controller
{
/**
* Display the Helpdesk module landing page.
* Display the Helpdesk module landing page inside the application shell.
*
* @return View
*/
public function __invoke(): View
{
return view('helpdesk::index');
return view('layouts.app', [
'title' => __('Helpdesk'),
'slot' => new HtmlString(view('helpdesk::index')->render()),
]);
}
}
Modules/Helpdesk/Livewire/TicketCreate.php
+3 -1
View File
@@ -75,7 +75,9 @@ final class TicketCreate extends Component
session()->flash('success', 'Ticket ' . $ticket->reference . ' has been created.');
return $this->redirectRoute('helpdesk.tickets.show', ['ticket' => $ticket->getKey()]);
return redirect()->route('helpdesk.tickets.show', [
'ticket' => $ticket,
]);
}
/** @return View */
Modules/Helpdesk/Providers/HelpdeskServiceProvider.php
+3
View File
@@ -11,6 +11,7 @@ use Illuminate\Support\Facades\Gate;
use Illuminate\Support\ServiceProvider;
use Livewire\Livewire;
use Modules\Helpdesk\Livewire\HelpdeskDashboardWidget;
use Modules\Helpdesk\Livewire\KanbanBoard;
use Modules\Helpdesk\Livewire\SettingsManager;
use Modules\Helpdesk\Livewire\TicketCreate;
use Modules\Helpdesk\Livewire\TicketIndex;
@@ -79,6 +80,7 @@ final class HelpdeskServiceProvider extends ServiceProvider
Livewire::component('helpdesk.ticket-create', TicketCreate::class);
Livewire::component('helpdesk.ticket-show', TicketShow::class);
Livewire::component('helpdesk.dashboard-widget', HelpdeskDashboardWidget::class);
Livewire::component('helpdesk.kanban-board', KanbanBoard::class);
Livewire::component('helpdesk.settings-manager', SettingsManager::class);
}
@@ -162,6 +164,7 @@ final class HelpdeskServiceProvider extends ServiceProvider
$this->loadViewsFrom(array_merge($this->getPublishableViewPaths(), [$sourcePath]), ModuleInfo::nameLower());
Blade::componentNamespace('Modules\Helpdesk\View\Components', 'helpdesk');
Blade::anonymousComponentPath($sourcePath . '/components', 'helpdesk');
}
/**
Modules/Helpdesk/Resources/views/components/html-editor.blade.php
+29 -29
View File
@@ -4,35 +4,36 @@
'placeholder' => 'Write your message...',
])
@php($model = $attributes->wire('model')->value())
@php
$wireModel = $attributes->wire('model');
$model = $wireModel->value();
$initialValue = $model ? data_get($this, $model, '') : '';
@endphp
<div
{{ $attributes->except(['wire:model'])->merge(['class' => 'space-y-2']) }}
{{ $attributes->whereDoesntStartWith('wire:model')->merge(['class' => 'space-y-2']) }}
x-data="{
value: @entangle($model),
model: @js($model),
value: @js($initialValue),
sync() {
this.value = this.$refs.editor.innerHTML;
if (this.model) {
this.$wire.set(this.model, this.value, false);
}
},
command(action, value = null) {
this.$refs.editor.focus();
document.execCommand(action, false, value);
this.sync();
},
sync() {
this.value = this.$refs.editor.innerHTML;
},
init() {
this.$refs.editor.innerHTML = this.value || '';
this.$watch('value', (nextValue) => {
if (document.activeElement !== this.$refs.editor && this.$refs.editor.innerHTML !== (nextValue || '')) {
this.$refs.editor.innerHTML = nextValue || '';
}
});
}
}"
>
<label class="block text-sm font-medium text-zinc-700 dark:text-zinc-200">{{ $label }}</label>
<input type="hidden" x-model="value" />
<div class="overflow-hidden rounded-xl border border-zinc-300 bg-white shadow-sm dark:border-zinc-700 dark:bg-zinc-950">
<div class="overflow-hidden rounded-xl border border-zinc-300 bg-white shadow-sm dark:border-zinc-700 dark:bg-zinc-950" wire:ignore>
<div class="flex flex-wrap gap-1 border-b border-zinc-200 bg-zinc-50 p-2 dark:border-zinc-800 dark:bg-zinc-900">
<button type="button" x-on:click="command('bold')" class="rounded-lg px-2 py-1 text-sm font-bold hover:bg-zinc-200 dark:hover:bg-zinc-800">B</button>
<button type="button" x-on:click="command('italic')" class="rounded-lg px-2 py-1 text-sm italic hover:bg-zinc-200 dark:hover:bg-zinc-800">I</button>
@@ -44,20 +45,19 @@
<button type="button" x-on:click="command('removeFormat')" class="rounded-lg px-2 py-1 text-sm hover:bg-zinc-200 dark:hover:bg-zinc-800">Clear</button>
</div>
<div wire:ignore>
<div
x-ref="editor"
contenteditable="true"
x-on:input.debounce.500ms="sync"
x-on:blur="sync"
x-on:keydown.enter.stop
class="prose prose-sm min-h-[{{ (int) $rows * 28 }}px] max-w-none bg-white p-4 text-sm text-zinc-900 outline-none dark:prose-invert dark:bg-zinc-950 dark:text-zinc-100"
data-placeholder="{{ $placeholder }}"
></div>
</div>
<div
x-ref="editor"
contenteditable="true"
x-on:input.debounce.300ms="sync"
x-on:blur="sync"
class="prose prose-sm min-h-[{{ (int) $rows * 28 }}px] max-w-none bg-white p-4 text-sm text-zinc-900 outline-none dark:prose-invert dark:bg-zinc-950 dark:text-zinc-100"
data-placeholder="{{ $placeholder }}"
></div>
</div>
@error($model)
<div class="text-sm text-red-600">{{ $message }}</div>
@enderror
@if($model)
@error($model)
<div class="text-sm text-red-600">{{ $message }}</div>
@enderror
@endif
</div>
Modules/Helpdesk/Resources/views/index.blade.php
-2
View File
@@ -1,4 +1,3 @@
<x-app-layout :title="__('Helpdesk')">
<div class="space-y-6">
<div class="overflow-hidden rounded-3xl border border-zinc-200 bg-white shadow-sm dark:border-zinc-700 dark:bg-zinc-900">
<div class="bg-gradient-to-br from-slate-950 via-slate-900 to-blue-950 px-6 py-8 text-white">
@@ -43,4 +42,3 @@
<livewire:helpdesk.dashboard-widget />
</div>
</x-app-layout>
Modules/Helpdesk/Resources/views/livewire/ticket-create.blade.php
+94 -167
View File
@@ -1,176 +1,103 @@
<div>
<div class="space-y-6">
@include('helpdesk::partials.page-header', [
'title' => 'Create Ticket',
'subtitle' => 'Raise a new support request with priority, project, category and full details.',
])
'eyebrow' => 'Helpdesk',
'title' => 'Create Ticket',
'subtitle' => 'Raise a new support request with priority, project, category and full details.',
])
<form wire:submit.prevent="save" class="space-y-6">
<div class="rounded-2xl border border-slate-200 bg-white shadow-sm">
<div class="border-b border-slate-200 px-6 py-4">
<h2 class="text-lg font-semibold text-slate-900">Ticket details</h2>
</div>
<div class="grid gap-6 p-6 lg:grid-cols-2">
<div class="lg:col-span-2">
<label class="block text-sm font-semibold text-slate-700" for="title">
Title
</label>
<input
id="title"
type="text"
wire:model.defer="title"
class="mt-2 block w-full rounded-xl border-slate-300 shadow-sm focus:border-blue-500 focus:ring-blue-500"
>
@error('title')
<p class="mt-2 text-sm text-red-600">{{ $message }}</p>
@enderror
<form wire:submit.prevent="save" class="space-y-6">
<div class="rounded-2xl border border-zinc-200 bg-white shadow-sm dark:border-zinc-700 dark:bg-zinc-900">
<div class="border-b border-zinc-200 px-6 py-4 dark:border-zinc-700">
<h2 class="text-lg font-semibold text-zinc-900 dark:text-zinc-100">Ticket details</h2>
<p class="mt-1 text-sm text-zinc-500 dark:text-zinc-400">Capture the request clearly so the support workflow can route and notify correctly.</p>
</div>
<div>
<label class="block text-sm font-semibold text-slate-700" for="priority_id">
Priority
</label>
<select
id="priority_id"
wire:model.defer="priority_id"
class="mt-2 block w-full rounded-xl border-slate-300 shadow-sm focus:border-blue-500 focus:ring-blue-500"
>
<option value="">Select priority</option>
@foreach ($priorities as $priority)
<option value="{{ $priority->id }}">{{ $priority->name }}</option>
@endforeach
</select>
@error('priority_id')
<p class="mt-2 text-sm text-red-600">{{ $message }}</p>
@enderror
</div>
<div>
<label class="block text-sm font-semibold text-slate-700" for="category_id">
Category
</label>
<select
id="category_id"
wire:model.defer="category_id"
class="mt-2 block w-full rounded-xl border-slate-300 shadow-sm focus:border-blue-500 focus:ring-blue-500"
>
<option value="">Select category</option>
@foreach ($categories as $category)
<option value="{{ $category->id }}">{{ $category->name }}</option>
@endforeach
</select>
@error('category_id')
<p class="mt-2 text-sm text-red-600">{{ $message }}</p>
@enderror
</div>
<div>
<label class="block text-sm font-semibold text-slate-700" for="project_id">
Project
</label>
<select
id="project_id"
wire:model.defer="project_id"
class="mt-2 block w-full rounded-xl border-slate-300 shadow-sm focus:border-blue-500 focus:ring-blue-500"
>
<option value="">Select project</option>
@foreach ($projects as $project)
<option value="{{ $project->id }}">{{ $project->name }}</option>
@endforeach
</select>
@error('project_id')
<p class="mt-2 text-sm text-red-600">{{ $message }}</p>
@enderror
</div>
<div>
<label class="block text-sm font-semibold text-slate-700" for="team_id">
Team
</label>
<select
id="team_id"
wire:model.defer="team_id"
class="mt-2 block w-full rounded-xl border-slate-300 shadow-sm focus:border-blue-500 focus:ring-blue-500"
>
<option value="">Select team</option>
@foreach ($teams as $team)
<option value="{{ $team->id }}">{{ $team->name }}</option>
@endforeach
</select>
@error('team_id')
<p class="mt-2 text-sm text-red-600">{{ $message }}</p>
@enderror
</div>
<div class="lg:col-span-2">
<label class="block text-sm font-semibold text-slate-700" for="details_editor">
Details
</label>
<div wire:ignore class="mt-2">
<textarea id="details_editor">{{ $details }}</textarea>
<div class="grid gap-6 p-6 lg:grid-cols-2">
<div class="lg:col-span-2">
<label class="block text-sm font-semibold text-zinc-700 dark:text-zinc-200" for="subject">Subject</label>
<input id="subject" type="text" wire:model.defer="subject" class="mt-2 block w-full rounded-xl border-zinc-300 shadow-sm focus:border-blue-500 focus:ring-blue-500 dark:border-zinc-700 dark:bg-zinc-950 dark:text-zinc-100" data-dusk="ticket-subject">
@error('subject') <p class="mt-2 text-sm text-red-600">{{ $message }}</p> @enderror
</div>
@error('details')
<p class="mt-2 text-sm text-red-600">{{ $message }}</p>
@enderror
@if($companies->isNotEmpty())
<div>
<label class="block text-sm font-semibold text-zinc-700 dark:text-zinc-200" for="company_id">Company</label>
<select id="company_id" wire:model.defer="company_id" class="mt-2 block w-full rounded-xl border-zinc-300 shadow-sm focus:border-blue-500 focus:ring-blue-500 dark:border-zinc-700 dark:bg-zinc-950 dark:text-zinc-100">
<option value="">Select company</option>
@foreach ($companies as $company)
<option value="{{ $company->id }}">{{ $company->name }}</option>
@endforeach
</select>
@error('company_id') <p class="mt-2 text-sm text-red-600">{{ $message }}</p> @enderror
</div>
@endif
<div>
<label class="block text-sm font-semibold text-zinc-700 dark:text-zinc-200" for="priority_id">Priority</label>
<select id="priority_id" wire:model.defer="priority_id" class="mt-2 block w-full rounded-xl border-zinc-300 shadow-sm focus:border-blue-500 focus:ring-blue-500 dark:border-zinc-700 dark:bg-zinc-950 dark:text-zinc-100" data-dusk="ticket-priority">
<option value="">Select priority</option>
@foreach ($priorities as $priority)
<option value="{{ $priority->id }}">{{ $priority->name }}</option>
@endforeach
</select>
@error('priority_id') <p class="mt-2 text-sm text-red-600">{{ $message }}</p> @enderror
</div>
<div>
<label class="block text-sm font-semibold text-zinc-700 dark:text-zinc-200" for="category_id">Category</label>
<select id="category_id" wire:model.defer="category_id" class="mt-2 block w-full rounded-xl border-zinc-300 shadow-sm focus:border-blue-500 focus:ring-blue-500 dark:border-zinc-700 dark:bg-zinc-950 dark:text-zinc-100">
<option value="">Select category</option>
@foreach ($categories as $category)
<option value="{{ $category->id }}">{{ $category->name }}</option>
@endforeach
</select>
@error('category_id') <p class="mt-2 text-sm text-red-600">{{ $message }}</p> @enderror
</div>
<div>
<label class="block text-sm font-semibold text-zinc-700 dark:text-zinc-200" for="project_id">Project</label>
<select id="project_id" wire:model.defer="project_id" class="mt-2 block w-full rounded-xl border-zinc-300 shadow-sm focus:border-blue-500 focus:ring-blue-500 dark:border-zinc-700 dark:bg-zinc-950 dark:text-zinc-100">
<option value="">Select project</option>
@foreach ($projects as $project)
<option value="{{ $project->id }}">{{ $project->title ?? $project->name }}</option>
@endforeach
</select>
@error('project_id') <p class="mt-2 text-sm text-red-600">{{ $message }}</p> @enderror
</div>
<div>
<label class="block text-sm font-semibold text-zinc-700 dark:text-zinc-200" for="team_id">Team</label>
<select id="team_id" wire:model.defer="team_id" class="mt-2 block w-full rounded-xl border-zinc-300 shadow-sm focus:border-blue-500 focus:ring-blue-500 dark:border-zinc-700 dark:bg-zinc-950 dark:text-zinc-100">
<option value="">Select team</option>
@foreach ($teams as $team)
<option value="{{ $team->id }}">{{ $team->name }}</option>
@endforeach
</select>
@error('team_id') <p class="mt-2 text-sm text-red-600">{{ $message }}</p> @enderror
</div>
<div>
<label class="block text-sm font-semibold text-zinc-700 dark:text-zinc-200" for="due_at">Due date</label>
<input id="due_at" type="date" wire:model.defer="due_at" class="mt-2 block w-full rounded-xl border-zinc-300 shadow-sm focus:border-blue-500 focus:ring-blue-500 dark:border-zinc-700 dark:bg-zinc-950 dark:text-zinc-100">
@error('due_at') <p class="mt-2 text-sm text-red-600">{{ $message }}</p> @enderror
</div>
<div class="lg:col-span-2">
<x-helpdesk::html-editor dusk="ticket-body-editor" wire:model="body" label="Details" rows="10" placeholder="Describe the issue, expected outcome, steps to reproduce and any useful context..." />
</div>
<div class="lg:col-span-2">
<label class="block text-sm font-semibold text-zinc-700 dark:text-zinc-200" for="attachments">Attachments</label>
<input id="attachments" type="file" wire:model="attachments" multiple class="mt-2 block w-full rounded-xl border border-zinc-300 bg-white px-3 py-2 text-sm shadow-sm dark:border-zinc-700 dark:bg-zinc-950 dark:text-zinc-100">
@error('attachments') <p class="mt-2 text-sm text-red-600">{{ $message }}</p> @enderror
@error('attachments.*') <p class="mt-2 text-sm text-red-600">{{ $message }}</p> @enderror
</div>
</div>
<div class="flex items-center justify-end gap-3 border-t border-zinc-200 px-6 py-4 dark:border-zinc-700">
<a href="{{ route('helpdesk.tickets.index') }}" wire:navigate class="rounded-xl border border-zinc-300 px-4 py-2 text-sm font-semibold text-zinc-700 hover:bg-zinc-50 dark:border-zinc-700 dark:text-zinc-200 dark:hover:bg-zinc-800">Cancel</a>
<button type="submit" class="rounded-xl bg-blue-600 px-5 py-2 text-sm font-semibold text-white shadow-sm hover:bg-blue-700" data-dusk="ticket-create-submit">Create Ticket</button>
</div>
</div>
<div class="flex items-center justify-end gap-3 border-t border-slate-200 px-6 py-4">
<a
href="{{ route('helpdesk.tickets.index') }}"
class="rounded-xl border border-slate-300 px-4 py-2 text-sm font-semibold text-slate-700 hover:bg-slate-50"
>
Cancel
</a>
<button
type="submit"
class="rounded-xl bg-blue-600 px-5 py-2 text-sm font-semibold text-white shadow-sm hover:bg-blue-700"
>
Create Ticket
</button>
</div>
</div>
</form>
</form>
</div>
@push('scripts')
<script>
document.addEventListener('livewire:init', function () {
const textarea = document.getElementById('details_editor');
if (!textarea || textarea.dataset.initialised === '1') {
return;
}
textarea.dataset.initialised = '1';
const editor = new EasyMDE({
element: textarea,
spellChecker: false,
status: false,
forceSync: true
});
editor.codemirror.on('change', function () {
@this.set('details', editor.value(), false);
});
});
</script>
@endpush
Modules/Helpdesk/Resources/views/partials/page-header.blade.php
+13 -23
View File
@@ -1,27 +1,17 @@
<div class="mb-8 overflow-hidden rounded-3xl border border-slate-200 bg-white shadow-sm">
<div class="bg-gradient-to-r from-slate-950 via-slate-900 to-blue-950 px-6 py-8 text-white">
<div class="flex flex-col gap-4 lg:flex-row lg:items-center lg:justify-between">
<div>
<p class="text-sm font-semibold uppercase tracking-[0.3em] text-blue-200">
Helpdesk
</p>
<div class="mb-8 overflow-hidden rounded-3xl border border-slate-800 bg-slate-950 shadow-sm">
<div class="px-6 py-8 text-white">
<p class="text-sm font-semibold uppercase tracking-[0.3em] text-blue-300">
{{ $eyebrow ?? 'Helpdesk' }}
</p>
<h1 class="mt-2 text-3xl font-bold tracking-tight">
{{ $title ?? 'Helpdesk' }}
</h1>
<h1 class="mt-3 text-3xl font-bold tracking-tight">
{{ $title ?? 'Helpdesk' }}
</h1>
@isset($subtitle)
<p class="mt-2 max-w-3xl text-sm text-slate-300">
{{ $subtitle }}
</p>
@endisset
</div>
@isset($actions)
<div class="flex flex-wrap items-center gap-3">
{{ $actions }}
</div>
@endisset
</div>
@if(! empty($subtitle))
<p class="mt-2 max-w-3xl text-sm text-slate-300">
{{ $subtitle }}
</p>
@endif
</div>
</div>
Modules/Helpdesk/changelog.yaml
+8
View File
@@ -13,3 +13,11 @@ versions:
- Added Kanban PHPUnit and Dusk coverage.
- Added Kanban navigation links to the dashboard and ticket list.
"1.0.3":
changed:
- Fixed Helpdesk dashboard rendering by removing dependency on missing x-app-layout/x-layouts.app components.
- Registered anonymous Helpdesk Blade components so x-helpdesk component views resolve correctly.
- Registered the Kanban Livewire component in the Helpdesk service provider.
- Rebuilt the ticket create page to use the correct subject/body Livewire properties.
- Stabilised the rich HTML editor so typing no longer clears the field or accidentally submits the ticket form.
- Added root layout support-menu integration instructions for enabled Helpdesk modules.
Modules/Helpdesk/module.json
+1 -1
View File
@@ -13,5 +13,5 @@
"Modules\\Helpdesk\\Providers\\HelpdeskServiceProvider"
],
"files": [],
"version": "1.0.2"
"version": "1.0.3"
}