usamamuneerchaudhary/commentify

Easy Laravel Livewire Comments with TailwindCSS UI

2.1 2025-05-24 19:34 UTC

Requires

• php: ^8.3
• guzzlehttp/guzzle: ^7.9
• illuminate/database: ^12.0
• illuminate/support: ^12.0
• laravel/framework: ^12.0
• laravel/telescope: ^5.0
• livewire/flux: ^2.1.1
• livewire/livewire: ^3.0

Requires (Dev)

• orchestra/testbench: ^10.0
• phpunit/phpunit: ^11.0

MIT

• Usama Muneer

• comments
• livewire
• laravel-livewire
• usamamuneerchaudhary
• livewire-comments
• commentify

README

Introduction

Commentify is a powerful Laravel Livewire package designed to provide an easy-to-integrate commenting system for any model in your Laravel application. Powered by Livewire, this package offers a seamless commenting experience that is powered by Tailwind UI, making it easy for users to engage with your content. With features like comments pagination and YouTube-style like/unlike buttons, this package is perfect for applications that require robust commenting capabilities. Additionally, guest users can like and unlike comments based on their IP addresses. Mentions can be used with "@" to tag specific users in replies and edits, while Markdown support allows for rich formatting in comments. Whether you're building a blog, an e-commerce platform, or any other type of web application, Commentify is a powerful tool for enhancing user engagement and collaboration.

Some Features Highlight

• Easy to integrate
• Laravel 12+ support
• Supports Livewire 3
• Livewire powered commenting system
• Tailwind UI
• Read-only mode (configurable via config/commentify.php)
• Add comments to any model
• Nested Comments
• Temporary user comment bans (block users from commenting until a set date)
• Comments Pagination
• Youtube style Like/unlike feature
• Guest like/unlike of comments (based on IP & UserAgent)
• Mention User with @ in Replies/Edits
• Markdown Support
• Full language/translation support (publish and override as needed)
• Customizable views (publish and override as needed)
• Policy-based authorization for all comment actions

Prerequisites

• Livewire
• TailwindCSS
• AlpineJS

Installation Guide

You can install the package via composer:

composer require usamamuneerchaudhary/commentify

Register Service Provider

Add the service provider in config/app.php:

Usamamuneerchaudhary\Commentify\Providers\CommentifyServiceProvider::class,

Run Migrations

Once the package is installed, you can run migrations, php artisan migrate

Publish config, views, and lang files as needed

php artisan vendor:publish --tag="commentify-config"
php artisan vendor:publish --tag=commentify-views
php artisan vendor:publish --tag=commentify-lang
php artisan vendor:publish --tag=commentify-migrations

This will publish commentify.php file in config directory. Here you can configure user route and pagination count etc.

Publish tailwind.config.js file,

This package utilizes TailwindCSS, and use some custom configurations. You can publish package's tailwind.config. js file by running the following command:

php artisan vendor:publish --tag="commentify-tailwind-config"

Usage

In your model, where you want to integrate comments, simply add the Commentable trait in that model. For example:

use Usamamuneerchaudhary\Commentify\Traits\Commentable;

class Article extends Model
{
    use Commentable;
}

Next, in your view, pass in the livewire comment component. For example, if your view file is articles/show.blade. php. We can add the following code:

<livewire:comments :model="$article"/>

Additionally, add the HasUserAvatar trait in App\Models\User, to use avatars:

use Usamamuneerchaudhary\Commentify\Traits\HasUserAvatar;

class User extends Model
{
    use HasUserAvatar;
}

🔒 Read-Only Mode

Temporarily disable all commenting (for maintenance, etc):

• In config/commentify.php:

  'read_only' => true,

🚫 Temporarily Block Users from Commenting

• Add the provided migration to your app to add a comment_banned_until column to your users table.
• Add the HasCommentBan trait to your User model:

  use Usamamuneerchaudhary\Commentify\Traits\HasCommentBan;
  class User extends Authenticatable
  {
      use HasCommentBan;
  }

• Set comment_banned_until to a future date to block a user.

🌍 Language Support

• All strings are translatable.
• Publish lang files and override as needed in lang/vendor/commentify.

🛡️ Authorization

• All comment actions use Laravel policies.
• You can customize permissions and ban logic in your CommentPolicy.

Tests

composer test

Security

If you discover any security related issues, please email [e-mail] instead of using the issue tracker.

Credits

• Laravel
• Tailwind
• Livewire
• FlowBite
• All Contributors

License

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