Download the PHP package editmode/laravel-comments without Composer

Laravel Comments

A customizable Laravel package to easily add comments and threaded discussions to any model — ideal for blog posts, user profiles, product reviews, or any other entity in your app.

Supports optional like/dislike reactions, nested replies, and is designed to integrate smoothly with Inertia/React or Blade.

Table of Contents

• Installation
• Quickstart
• Config
• Like/Dislike Feature
• Migrations
• Routes
• Development Tips
• Testing
• Changelog
• Credits
• License

Installation

You can install the package via composer:

Quickstart

After installing the package, it's recommended that you create your own custom Comment model that extends the base model provided by the package. This gives you full flexibility to modify, extend, or customize comment behavior as needed.

1. Install the package

2. Publish the configuration file (optional but recommended):

2.5. Publish the migrations

The package includes migrations to create the comments and comment reactions tables.
You should publish them using:

🛑 Important: If you plan to use the like/dislike feature, make sure to also publish the config file first and enable it in config/comments.php by setting like_dislike_feature to true. Otherwise, the comment_reactions table will not be created during migration.

3. Create your own Comment model by extending the base comment model:

🚨 VERY IMPORTANT
For Laravel's polymorphic relationships to work automatically without manual configuration, your custom model must be named Comment. If you use any other name (like UserComment, PostComment, etc.), morph types like commentable_type will not resolve correctly unless you manually configure a morph map. Laravel automatically handles this when your model is named Comment.

4. Update your configuration file config/comments.php to use your custom Comment model:

This setup allows you to fully control how comments behave in your application while leveraging the core features provided by the package.

5. Attach a comment to a model

You can now attach comments to any model by using the HasComments trait on that model.

Then, to add a comment as the currently authenticated user:

Or explicitly pass a user:

This allows you to associate comments with any model that uses the HasComments trait.

Config

You can publish the config file with:

Like/Dislike Feature

You can optionally enable the like/dislike feature in the package config. To enable this feature:

1. Set like_dislike_feature to true in config/comments.php.
2. Add the HasReactions trait to your custom comment model.

Migrations

You can publish and run the migrations with:

Then run the migrations:

⚠️ The create_comment_reactions_table migration will be skipped unless the like_dislike_feature setting is enabled in your config/comments.php file. If you plan to use the like/dislike feature, make sure to publish the config first and set like_dislike_feature to true before running php artisan migrate.

Routes

You can register the package's routes by calling the macro in your routes/web.php:

This will automatically register routes like GET /comments, and if the like/dislike feature is enabled, also POST /comments/{comment}/react/{type} — where {type} must be either like or dislike.

By default, routes are prefixed with /comments. You can change this by passing a different base URL to Route::comments('your-prefix').

💡 See Development Tips for filtering the route list.

Published Routes:

//: # () //: # ()

Development Tips

Filtering Routes

To list only the routes registered by this package:

This helps when debugging or inspecting how the package integrates into your app.

Testing

Changelog

Please see CHANGELOG for more information on what has changed recently.

//: # ()

//: # ()

Credits

• Nika

License

The MIT License (MIT). Please see License File for more information.