PHPackages ssntpl/laravel-comments - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. ssntpl/laravel-comments ActiveLibrary[Utility & Helpers](/categories/utility) ssntpl/laravel-comments ======================= Polymorphic comments for Eloquent models: threading, reactions, per-comment files, opt-in edit history, mentions, and lifecycle events. v0.1.0(1mo ago)4107MITPHPPHP ^8.1 Since Jan 15Pushed 1mo ago2 watchersCompare [ Source](https://github.com/ssntpl/laravel-comments)[ Packagist](https://packagist.org/packages/ssntpl/laravel-comments)[ RSS](/packages/ssntpl-laravel-comments/feed)WikiDiscussions main Synced today READMEChangelog (7)Dependencies (5)Versions (10)Used By (0) laravel-comments ================ [](#laravel-comments) This is a simple package to associate comments with your eloquent model in laravel. This package is providing functionality for adding, retrieving, editing, and deleting comments along with its associated files if any on various entities: Installation ------------ [](#installation) You can install the package via composer: ``` composer require ssntpl/laravel-comments ``` Run the migrations with: ``` php artisan migrate ``` Optionally, You can publish and run the migrations with: ``` php artisan vendor:publish --tag="laravel-comments-migrations" php artisan migrate ``` Publish the config to customise behaviour (user model, edit history, mention pattern, etc.): ``` php artisan vendor:publish --tag="laravel-comments-config" ``` > Apps that already own a `comments` table (and manage the schema themselves) can set `comments.auto_load_migrations` to `false` so the package does not register its own migrations. Usage ----- [](#usage) Add the `HasComments` trait to your model. ``` namespace App\Models; use Ssntpl\LaravelComments\Traits\HasComments; class Post extends Model { use HasComments; } ``` Add new comment to the model. ``` $model = Post::find(1); $comment = $model->createComment([ // type: Optional. It represents the type of comment. 'type' => 'commentType', // body: This is the body of the comment. // (The `text` and `comment` keys are still accepted as backward-compatible aliases.) 'body' => 'This is the body of the comment', // user_id: Optional. This is a foreign key belonging to that entity who is making the comment. For e.g:Users(so it will be the id of User who is making the comment). 'user_id' => 1, // created_at: The created_at timestamp is automatically managed by Eloquent. Represents the time at which the comment is made. Otherwise one can manually assign a value to created_at when creating a new comment. 'created_at' => '2025-01-17 05:14:13', ]); ``` Accessing the comment model. ``` $card = Card::find(1);//comments can be added on a card $card->comments; //return all the comments linked with the card $card->comments() // returns the Illuminate\Database\Eloquent\Relations\MorphMany relation $card->comments()->where('user_id',1)->get() //Accessing all comments of the card made for particular user $comment = $card->comments()->where('id',3)->first() // One can access the specific comment of card // to create an attachment on that comment $comment->createFile([ 'key' => 'path/filename.jpg', 'name' => 'filename.jpg' ]); $comment->file //To access the first or only attachment with that comment on the card $comment->files //To access all the attachments related to that comment on that card //One can update particular comment by adding id as one of the params $card->createComment(['id' => 23, 'user_id' => 2,'body'=> "This is a new comment"]) // The comment body is stored in the `body` column. For backward compatibility, // `$comment->text` and `$comment->comment` both read from / write to `body`. $comment->body; // "This is a new comment" $comment->text; // same value (alias) $comment->comment; // same value (alias) //Like this one can delete all the comments along with its attachment on the card $comments = $card->comments()->get(); foreach($comments as $comment) { $comment->delete(); } ``` ### Threading (replies) [](#threading-replies) A comment can reply to another via `reply_to_comment_id`: ``` $reply = $card->createComment([ 'user_id' => 2, 'body' => 'I agree', 'reply_to_comment_id' => $comment->id, ]); $reply->replyToComment; // the parent comment $comment->replies; // replies to this comment $card->rootComments(); // top-level comments only (excludes replies) ``` ### Reactions [](#reactions) One reaction per user per comment (re-reacting changes it): ``` $comment->react($user, 'thumbsup'); // add or change $user's reaction $comment->unreact($user); // remove it $comment->reactions; // all reactions on the comment ``` ### Edit history (opt-in) [](#edit-history-opt-in) Set `comments.changelog` to `true` to snapshot each edit. On every change to `body`, the *previous* body is stored in `comment_changelogs`, so the changelog table holds all prior versions and the model holds the current one — the full history is reconstructable. ``` $comment->changelogs; // prior versions, newest first ``` ### Mentions [](#mentions) The package parses `@handles` out of the body; resolving them to users and delivering notifications is your app's job (typically in a listener on the events below). ``` $comment->mentionedHandles(); // ['bob', 'carol.dev'] ``` The pattern is configurable via `comments.mentions.pattern`. ### Events [](#events) The package fires framework-agnostic events so your app can send notifications, broadcast, or record activity without the package knowing about any of that: EventWhen`CommentCreated`a comment is created`CommentUpdated`a comment's body is edited (carries `previousBody`)`CommentDeleted`a comment is deleted`ReactionAdded`a user reacts (or changes their reaction)`ReactionRemoved`a user removes their reaction``` Event::listen(\Ssntpl\LaravelComments\Events\CommentCreated::class, function ($event) { // $event->comment->mentionedHandles(), notify, broadcast, ... }); ``` ### Overriding models [](#overriding-models) Point `comments.models.*` at your own subclasses to add behaviour. Custom classes **must extend** the package base (`Comment` / `CommentReaction` / `CommentChangelog`). Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](../../security/policy) on how to report security vulnerabilities. Credits ------- [](#credits) - [Jyotsana Sharma](https://github.com/JYOTSANASHARMAA) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 42 — FairBetter than 88% of packages Maintenance92 Actively maintained with recent releases Popularity14 Limited adoption so far Community10 Small or concentrated contributor base Maturity44 Maturing project, gaining track record Bus Factor1 Top contributor holds 85.7% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~88 days Recently: every ~118 days Total 7 Last Release 38d ago PHP version history (2 changes)v0.0.1PHP ^7.4|^8.0 v0.1.0PHP ^8.1 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/6224763?v=4)[Sword Software N Technologies Pvt. Ltd.](/maintainers/ssntpl)[@ssntpl](https://github.com/ssntpl) --- Top Contributors [![JYOTSANASHARMAA](https://avatars.githubusercontent.com/u/116160861?v=4)](https://github.com/JYOTSANASHARMAA "JYOTSANASHARMAA (12 commits)")[![sambhav-aggarwal](https://avatars.githubusercontent.com/u/4591834?v=4)](https://github.com/sambhav-aggarwal "sambhav-aggarwal (2 commits)") ### Embed Badge ![Health badge](/badges/ssntpl-laravel-comments/health.svg) ``` [![Health](https://phpackages.com/badges/ssntpl-laravel-comments/health.svg)](https://phpackages.com/packages/ssntpl-laravel-comments) ``` ### Alternatives [monsieurbiz/sylius-cms-page-plugin This plugins allows you to add manage CMS pages using the Rich Editor 44138.1k1](/packages/monsieurbiz-sylius-cms-page-plugin)[pre/plugin 951.6k15](/packages/pre-plugin) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)