Skip to content

Render support ticket markdown and ASCII tables as HTML in admin #375

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
simonhamp merged 1 commit into from
May 11, 2026
+195 −1
Merged

Render support ticket markdown and ASCII tables as HTML in admin #375

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
127 changes: 126 additions & 1 deletion app/Filament/Resources/SupportTicketResource.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@
use Filament\Tables;
use Filament\Tables\Table;
use Illuminate\Support\HtmlString;
use Illuminate\Support\Str;

class SupportTicketResource extends Resource
{
Expand Down Expand Up @@ -77,7 +78,10 @@ public static function infolist(Schema $schema): Schema
->label('Subject'),
Infolists\Components\TextEntry::make('message')
->label('Message')
->markdown(),
->formatStateUsing(fn (?string $state): ?HtmlString => $state === null
? null
: new HtmlString(self::renderTicketMessage($state)))
->html(),
Infolists\Components\TextEntry::make('attachments')
->label('Attachments')
->formatStateUsing(function (SupportTicket $record): HtmlString {
Expand Down Expand Up @@ -168,6 +172,127 @@ public static function getRelations(): array
return [];
}

public static function renderTicketMessage(string $message): string
{
$html = Str::markdown(self::convertAsciiTablesToHtml($message), [
'renderer' => [
'soft_break' => "<br />\n",
],
]);

return str_replace('<p>', '<p style="margin: 0 0 1rem 0;">', $html);
}

protected static function convertAsciiTablesToHtml(string $message): string
{
$lines = preg_split('/\R/', $message) ?: [];
$result = [];
$buffer = [];

$flush = function () use (&$result, &$buffer): void {
if ($buffer === []) {
return;
}

$rendered = self::renderAsciiTable($buffer);

if ($rendered === null) {
foreach ($buffer as $bufferedLine) {
$result[] = $bufferedLine;
}
} else {
$result[] = '';
$result[] = $rendered;
$result[] = '';
}

$buffer = [];
};

foreach ($lines as $line) {
if (preg_match('/^\s*[+|]/', $line)) {
$buffer[] = $line;

continue;
}

$flush();
$result[] = $line;
}

$flush();

return implode("\n", $result);
}

protected static function renderAsciiTable(array $lines): ?string
{
$rows = [];
$separatorAfterRow = [];

foreach ($lines as $line) {
$trimmed = ltrim($line);

if (str_starts_with($trimmed, '+')) {
$separatorAfterRow[count($rows)] = true;

continue;
}

if (str_starts_with($trimmed, '|')) {
$rows[] = self::splitAsciiTableRow($trimmed);
}
}

if ($rows === []) {
return null;
}

$hasHeader = count($rows) > 1 && isset($separatorAfterRow[1]);

$tableStyle = 'border-collapse: collapse; width: auto; margin: 0 0 1rem 0; border: 1px solid rgba(127, 127, 127, 0.25);';
$cellStyle = 'padding: 0.25rem 0.75rem; border: 1px solid rgba(127, 127, 127, 0.2); text-align: left; vertical-align: top;';
$headerCellStyle = $cellStyle.' font-weight: 600; background: rgba(127, 127, 127, 0.12);';
$stripeStyle = 'background: rgba(127, 127, 127, 0.06);';

$html = '<table style="'.$tableStyle.'">';

if ($hasHeader) {
$html .= '<thead><tr>';
foreach ($rows[0] as $cell) {
$html .= '<th style="'.$headerCellStyle.'">'.e($cell).'</th>';
}
$html .= '</tr></thead>';
$bodyRows = array_slice($rows, 1);
} else {
$bodyRows = $rows;
}

$html .= '<tbody>';
foreach ($bodyRows as $index => $row) {
$rowStyle = $index % 2 === 1 ? ' style="'.$stripeStyle.'"' : '';
$html .= '<tr'.$rowStyle.'>';
foreach ($row as $cell) {
$html .= '<td style="'.$cellStyle.'">'.e($cell).'</td>';
}
$html .= '</tr>';
}
$html .= '</tbody></table>';

return $html;
}

/**
* @return list<string>
*/
protected static function splitAsciiTableRow(string $line): array
{
$line = trim($line);
$line = trim($line, '|');

return array_map('trim', explode('|', $line));
}

public static function getPages(): array
{
return [
Expand Down
69 changes: 69 additions & 0 deletions tests/Feature/SupportTicketTest.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@

namespace Tests\Feature;

use App\Filament\Resources\SupportTicketResource;
use App\Filament\Resources\SupportTicketResource\Pages\ViewSupportTicket;
use App\Filament\Resources\SupportTicketResource\Widgets\TicketRepliesWidget;
use App\Livewire\Customer\Support\Create;
Expand Down Expand Up @@ -1268,6 +1269,74 @@ public function admin_view_page_shows_name_and_email_when_user_has_name(): void
->assertSee($namedUser->email);
}

#[Test]
public function admin_view_page_renders_message_markdown_and_ascii_tables_as_html_tables(): void
{
$admin = User::factory()->create(['email' => 'admin@test.com']);
config(['filament.users' => ['admin@test.com']]);

$message = "**What I was trying to do:**\nDeploy quickly\n\n"
."**Environment:**\n+--------------------+---------------+\n"
."| Package Version | 3.3.3 |\n"
."| PHP Version (Host) | 8.4.16 |\n"
.'+--------------------+---------------+';

$ticket = SupportTicket::factory()->create(['message' => $message]);

$html = Livewire::actingAs($admin)
->test(ViewSupportTicket::class, ['record' => $ticket->getRouteKey()])
->assertOk()
->assertSeeHtml('<strong>What I was trying to do:</strong>')
->html();

$this->assertMatchesRegularExpression('/<td[^>]*>Package Version<\/td>/', $html);
$this->assertMatchesRegularExpression('/<td[^>]*>3\.3\.3<\/td>/', $html);
}

#[Test]
public function render_ticket_message_converts_ascii_table_without_header_to_html_table(): void
{
$message = "Intro line\n+---+---+\n| a | b |\n| c | d |\n+---+---+\nOutro line";

$html = SupportTicketResource::renderTicketMessage($message);

$this->assertStringContainsString('Intro line', $html);
$this->assertStringNotContainsString('<thead>', $html);
$this->assertMatchesRegularExpression('/<tr><td[^>]*>a<\/td><td[^>]*>b<\/td><\/tr>/', $html);
$this->assertMatchesRegularExpression('/<tr style="[^"]*"><td[^>]*>c<\/td><td[^>]*>d<\/td><\/tr>/', $html);
$this->assertStringContainsString('Outro line', $html);
}

#[Test]
public function render_ticket_message_treats_first_row_as_header_when_separated(): void
{
$message = "+----------+---------+\n| Package | Version |\n+----------+---------+\n| camera | 1.0.2 |\n+----------+---------+";

$html = SupportTicketResource::renderTicketMessage($message);

$this->assertMatchesRegularExpression('/<thead><tr><th[^>]*>Package<\/th><th[^>]*>Version<\/th><\/tr><\/thead>/', $html);
$this->assertMatchesRegularExpression('/<tr><td[^>]*>camera<\/td><td[^>]*>1\.0\.2<\/td><\/tr>/', $html);
}

#[Test]
public function render_ticket_message_applies_paragraph_spacing(): void
{
$html = SupportTicketResource::renderTicketMessage("First paragraph\n\nSecond paragraph");

$this->assertStringContainsString('<p style="margin: 0 0 1rem 0;">First paragraph</p>', $html);
$this->assertStringContainsString('<p style="margin: 0 0 1rem 0;">Second paragraph</p>', $html);
}

#[Test]
public function render_ticket_message_converts_single_newlines_to_line_breaks(): void
{
$message = "Line one\nLine two";

$html = SupportTicketResource::renderTicketMessage($message);

$this->assertStringContainsString("Line one<br />\nLine two", $html);
}

#[Test]
public function guests_cannot_access_ticket_index(): void
{
Expand Down
Loading