Installation

Get started with Comments in minutes.

Requirements

PHP: 8.2+
Laravel: 12+
Filament: 4.x / 5.x
Livewire: 3.5+ / 4.x

Quick Setup

Install Package

composer require relaticle/comments

Publish and Run Migrations

php artisan vendor:publish --tag=comments-migrations
php artisan migrate

Include CSS Assets

Prerequisite: You need a custom Filament theme to include the Comments styles.

If you haven't set up a custom theme for Filament, follow the Filament Docs first.

Add the plugin's views to your theme CSS file:

@source "../../../../vendor/relaticle/comments/resources/views/**/*.blade.php";

Register the Plugin

use Relaticle\Comments\CommentsPlugin;

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

Set Up Your Models

Add the HasComments trait to any model you want to comment on:

use Relaticle\Comments\Concerns\HasComments;
use Relaticle\Comments\Contracts\Commentable;

class Project extends Model implements Commentable
{
    use HasComments;
}

Add the IsCommenter trait to your User model:

use Relaticle\Comments\Concerns\IsCommenter;
use Relaticle\Comments\Contracts\Commenter;

class User extends Authenticatable implements Commenter
{
    use IsCommenter;
}

Add to Your Resources

Use the slide-over action on view or edit pages:

use Relaticle\Comments\Filament\Actions\CommentsAction;

protected function getHeaderActions(): array
{
    return [
        CommentsAction::make(),
    ];
}

Done! Visit your Filament panel to see comments in action.

Optional Configuration

<th>
  Action
</th>

<td>
  Publish the configuration file
</td>

<td>
  Publish the Blade views for customization
</td>

<td>
  Publish the translation files
</td>

Command
`php artisan vendor:publish --tag=comments-config`
`php artisan vendor:publish --tag=comments-views`
`php artisan vendor:publish --tag=comments-translations`

2.7 KiB Raw Blame History