Aded documentation module

This commit is contained in:
Mark Gregory
2026-06-12 15:32:09 +01:00
parent a2c68bc4dc
commit 1c9ed1a537
18 changed files with 418 additions and 85 deletions
@@ -1,4 +1,4 @@
<div class="mx-auto max-w-[1800px] space-y-6" dusk="helpdesk-kanban-board">
<div class="mx-auto max-w-[1800px] space-y-6" dusk="helpdesk-kanban-board" data-helpdesk-kanban-root>
<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-7 text-white">
<div class="flex flex-col gap-4 lg:flex-row lg:items-center lg:justify-between">
@@ -36,11 +36,11 @@
</select>
</div>
<div class="flex gap-4 overflow-x-auto pb-4" data-helpdesk-kanban-board>
<div class="flex gap-4 overflow-x-auto pb-4">
@foreach ($statuses as $status)
@php($tickets = $ticketsByStatus[$status->id] ?? collect())
<section class="flex min-h-[640px] w-[330px] shrink-0 flex-col overflow-hidden rounded-2xl border border-zinc-200 bg-zinc-100 shadow-sm dark:border-zinc-700 dark:bg-zinc-950" dusk="kanban-column-{{ $status->slug }}">
<section class="flex min-h-[640px] w-[330px] shrink-0 flex-col overflow-hidden rounded-2xl border border-zinc-200 bg-zinc-100 shadow-sm dark:border-zinc-700 dark:bg-zinc-950" dusk="kanban-column-{{ $status->slug }}" wire:key="kanban-column-{{ $status->id }}">
<header class="border-b border-zinc-200 bg-white px-4 py-4 dark:border-zinc-800 dark:bg-zinc-900">
<div class="flex items-start justify-between gap-3">
<div>
@@ -52,16 +52,18 @@
</header>
<div
class="helpdesk-kanban-column min-h-[560px] flex-1 space-y-3 p-3"
class="helpdesk-kanban-column min-h-[560px] flex-1 space-y-3 p-3 transition data-[drop-ready=true]:bg-blue-50 dark:data-[drop-ready=true]:bg-blue-950/30"
data-helpdesk-kanban-column
data-status-id="{{ $status->id }}"
>
@forelse ($tickets as $ticket)
<article
class="group cursor-grab rounded-2xl border border-zinc-200 bg-white p-4 shadow-sm transition hover:-translate-y-0.5 hover:shadow-md active:cursor-grabbing dark:border-zinc-800 dark:bg-zinc-900"
draggable="true"
data-helpdesk-kanban-ticket
data-ticket-id="{{ $ticket->id }}"
dusk="kanban-ticket-{{ $ticket->id }}"
wire:key="kanban-ticket-{{ $ticket->id }}"
>
<div class="flex items-start justify-between gap-3">
<div class="min-w-0">
@@ -106,55 +108,83 @@
@script
<script>
const initialiseHelpdeskKanban = function () {
const boot = function () {
if (!window.Sortable) {
const initialiseHelpdeskNativeKanban = function () {
document.querySelectorAll('[data-helpdesk-kanban-root]').forEach(function (root) {
if (root.dataset.nativeKanbanReady === '1') {
return;
}
document.querySelectorAll('[data-helpdesk-kanban-column]').forEach(function (column) {
if (column.dataset.sortableReady === '1') {
root.dataset.nativeKanbanReady = '1';
root.addEventListener('dragstart', function (event) {
const card = event.target.closest('[data-helpdesk-kanban-ticket]');
if (!card || event.target.closest('a, button, input, select, textarea')) {
return;
}
column.dataset.sortableReady = '1';
event.dataTransfer.effectAllowed = 'move';
event.dataTransfer.setData('text/plain', card.dataset.ticketId);
event.dataTransfer.setData('application/x-helpdesk-ticket', card.dataset.ticketId);
card.classList.add('opacity-50', 'ring-2', 'ring-blue-400');
});
new window.Sortable(column, {
group: 'helpdesk-kanban',
animation: 180,
ghostClass: 'opacity-50',
chosenClass: 'ring-2 ring-blue-400',
dragClass: 'rotate-1',
draggable: '[data-helpdesk-kanban-ticket]',
filter: 'a, button, input, select, textarea',
preventOnFilter: false,
onEnd: function (event) {
const ticketId = event.item.dataset.ticketId;
const statusId = event.to.dataset.statusId;
root.addEventListener('dragend', function (event) {
const card = event.target.closest('[data-helpdesk-kanban-ticket]');
if (!ticketId || !statusId) {
return;
}
if (card) {
card.classList.remove('opacity-50', 'ring-2', 'ring-blue-400');
}
$wire.moveTicket(ticketId, statusId);
},
root.querySelectorAll('[data-helpdesk-kanban-column]').forEach(function (column) {
column.dataset.dropReady = 'false';
});
});
};
if (!window.Sortable) {
const script = document.createElement('script');
script.src = 'https://cdn.jsdelivr.net/npm/sortablejs@1.15.2/Sortable.min.js';
script.onload = boot;
document.head.appendChild(script);
return;
}
root.addEventListener('dragover', function (event) {
const column = event.target.closest('[data-helpdesk-kanban-column]');
boot();
if (!column) {
return;
}
event.preventDefault();
event.dataTransfer.dropEffect = 'move';
column.dataset.dropReady = 'true';
});
root.addEventListener('dragleave', function (event) {
const column = event.target.closest('[data-helpdesk-kanban-column]');
if (column && !column.contains(event.relatedTarget)) {
column.dataset.dropReady = 'false';
}
});
root.addEventListener('drop', function (event) {
const column = event.target.closest('[data-helpdesk-kanban-column]');
if (!column) {
return;
}
event.preventDefault();
column.dataset.dropReady = 'false';
const ticketId = event.dataTransfer.getData('application/x-helpdesk-ticket') || event.dataTransfer.getData('text/plain');
const statusId = column.dataset.statusId;
if (!ticketId || !statusId) {
return;
}
$wire.moveTicket(ticketId, statusId);
});
});
};
initialiseHelpdeskKanban();
document.addEventListener('livewire:navigated', initialiseHelpdeskKanban);
initialiseHelpdeskNativeKanban();
document.addEventListener('livewire:navigated', initialiseHelpdeskNativeKanban);
</script>
@endscript
</div>