athphane/relaticle-comments
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: use filament input wrapper for textareas, add alpha callout and preview image, remove redundant introduction page

Browse Source
This commit is contained in:
manukminasyan
2026-03-27 16:02:17 +04:00
parent a4d4418963
commit 35571760d6
7 changed files with 34 additions and 72 deletions
Download Patch File Download Diff File Expand all files Collapse all files

0
docs/content/1.getting-started/2.installation.md → docs/content/1.getting-started/1.installation.md
View File

52
docs/content/1.getting-started/1.introduction.md
View File

@@ -1,52 +0,0 @@
---
title: Introduction
description: A full-featured commenting system for Filament panels.
navigation:
icon: i-lucide-home
seo:
title: Introduction
description: Learn about Comments - a full-featured commenting system for Filament panels with threaded replies, @mentions, emoji reactions, and real-time updates.
ogImage: /preview.png
---
Welcome to **Comments**, a powerful Laravel package that adds a full-featured commenting system to any Filament panel.
## What is Comments?
Comments provides polymorphic commenting on any Eloquent model with deep Filament integration. Add threaded discussions, @mentions, emoji reactions, file attachments, and real-time notifications to your admin panel with minimal setup.
## Why Choose Comments?
::card-group
:::card
---
icon: i-lucide-messages-square
title: Threaded Discussions
---
Nested replies with configurable depth limits keep conversations organized and easy to follow.
:::
:::card
---
icon: i-lucide-clock
title: Quick Setup
---
Add traits to your models, register the plugin, and you have a working comment system in minutes.
:::
:::card
---
icon: i-lucide-puzzle
title: 3 Integration Patterns
---
Use as a slide-over action, table row action, or inline infolist entry - whatever fits your resource.
:::
:::card
---
icon: i-lucide-bell
title: Built-in Notifications
---
Database and mail notifications with subscription management and auto-subscribe for authors and mentioned users.
:::
::

0
docs/content/1.getting-started/3.upgrading.md → docs/content/1.getting-started/2.upgrading.md
View File

8
docs/content/index.md
View File

@@ -37,6 +37,14 @@ Drop-in integration with any Filament resource.
:::
::
::callout{icon="i-lucide-triangle-alert" color="amber"}
**Alpha Software** -- This package is currently in alpha. The API is not stable and breaking changes may occur between releases without prior notice. Do not use in production unless you are prepared to handle upgrades manually.
::
<div class="max-w-5xl mx-auto mt-8">
<img src="/preview.png" alt="Comments - threaded discussions in Filament" class="rounded-lg shadow-lg w-full" />
</div>
::u-page-section
#title
Why choose Comments?

BIN
docs/public/preview.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 330 KiB

26
resources/views/livewire/comment-item.blade.php
View File

@@ -33,9 +33,11 @@
{{-- Body or edit form --}}
@if ($isEditing)
<form wire:submit="saveEdit" class="mt-1">
<textarea wire:model="editBody" rows="3"
class="block w-full rounded-lg border-gray-300 shadow-sm focus:border-primary-500 focus:ring-primary-500 dark:border-gray-600 dark:bg-gray-700 dark:text-gray-300 sm:text-sm"
></textarea>
<x-filament::input.wrapper>
<textarea wire:model="editBody" rows="3"
class="block w-full border-none bg-transparent px-3 py-1.5 text-sm leading-6 text-gray-950 outline-none transition duration-75 placeholder:text-gray-400 focus:ring-0 dark:text-white dark:placeholder:text-gray-500"
></textarea>
</x-filament::input.wrapper>
@error('editBody')
<p class="mt-1 text-sm text-danger-600 dark:text-danger-400">{{ $message }}</p>
@enderror
@@ -167,14 +169,16 @@
});
}
}">
<textarea x-ref="replyInput"
wire:model="replyBody"
@input="handleInput($event)"
@keydown="handleKeydown($event)"
rows="2"
placeholder="Write a reply..."
class="block w-full rounded-lg border-gray-300 shadow-sm focus:border-primary-500 focus:ring-primary-500 dark:border-gray-600 dark:bg-gray-700 dark:text-gray-300 dark:placeholder-gray-400 sm:text-sm"
></textarea>
<x-filament::input.wrapper>
<textarea x-ref="replyInput"
wire:model="replyBody"
@input="handleInput($event)"
@keydown="handleKeydown($event)"
rows="2"
placeholder="Write a reply..."
class="block w-full border-none bg-transparent px-3 py-1.5 text-sm leading-6 text-gray-950 outline-none transition duration-75 placeholder:text-gray-400 focus:ring-0 dark:text-white dark:placeholder:text-gray-500"
></textarea>
</x-filament::input.wrapper>
{{-- Mention autocomplete dropdown --}}
<div x-show="showMentions" x-cloak

20
resources/views/livewire/comments.blade.php
View File

@@ -118,15 +118,17 @@
});
}
}">
<textarea
x-ref="commentInput"
wire:model="newComment"
@input="handleInput($event)"
@keydown="handleKeydown($event)"
rows="3"
placeholder="Write a comment..."
class="block w-full rounded-lg border-gray-300 shadow-sm focus:border-primary-500 focus:ring-primary-500 dark:border-gray-600 dark:bg-gray-700 dark:text-gray-300 dark:placeholder-gray-400 sm:text-sm"
></textarea>
<x-filament::input.wrapper>
<textarea
x-ref="commentInput"
wire:model="newComment"
@input="handleInput($event)"
@keydown="handleKeydown($event)"
rows="3"
placeholder="Write a comment..."
class="block w-full border-none bg-transparent px-3 py-1.5 text-sm leading-6 text-gray-950 outline-none transition duration-75 placeholder:text-gray-400 focus:ring-0 dark:text-white dark:placeholder:text-gray-500"
></textarea>
</x-filament::input.wrapper>
{{-- Mention autocomplete dropdown --}}
<div x-show="showMentions" x-cloak