Add comment ratings feature with per-component configuration

Author: ItsMalikJones

README.md

@@ -351,6 +351,36 @@ By default, Commentions ships with the following reactions: `['👍', '❤️',
     ],
 ```
 
+#### Comment Ratings
+
+Commentions can attach an optional star rating to a comment, review-style. Ratings are **disabled by default**.
+
+Enable them globally in your `config/commentions.php` file (or via the matching environment variables):
+
+```php
+    'ratings' => [
+        'enabled' => env('COMMENTIONS_RATINGS_ENABLED', false),
+
+        'max' => (int) env('COMMENTIONS_RATINGS_MAX', 5),
+    ],
+```
+
+You can also enable ratings per component, which overrides the global config. This works on `CommentsEntry`, `CommentsAction`, and `CommentsTableAction`:
+
+```php
+CommentsEntry::make('comments')
+    ->enableRatings()
+    ->maxRating(10)
+```
+
+Available methods:
+
+- `enableRatings(bool|Closure $condition = true)` — enable the rating input for this component.
+- `disableRatings()` — disable the rating input, even if enabled globally.
+- `maxRating(int|Closure $max)` — set the highest selectable rating (defaults to `ratings.max`).
+
+When ratings are enabled, commenters can pick a rating while writing or editing a comment, and each rated comment renders its score as filled stars. The rating is stored in a nullable `rating` column added by the package's `add_rating_to_commentions_comments_table` migration.
+
 ### Configuring the Commenter name
 
 By default, the `name` property will be used to render the mention names. You can customize it either by implementing the Filament `HasName` interface OR by implementing the optional `getCommenterName` method.

phpstan.neon

@@ -9,7 +9,6 @@ parameters:
         - tests/
 
     excludePaths:
-        - src/Filament/Actions/CommentsTableAction.php
         - src/Filament/Actions/SubscriptionTableAction.php
 
     # Level 10 is the highest level

resources/lang/en/comments.php

@@ -21,6 +21,10 @@
     'add_reaction' => 'Add Reaction',
     'show_more' => 'Show More',
 
+    'rating_input_label' => 'Rating',
+    'rate_stars' => 'Rate :count star|Rate :count stars',
+    'rating_display_label' => 'Rated :rating out of :max',
+
     'notifications' => 'Notifications',
     'unsubscribe' => 'Unsubscribe',
     'subscribe' => 'Subscribe',

resources/views/comment-list.blade.php

@@ -21,6 +21,8 @@ class="comm:w-8 comm:h-8 comm:text-gray-400 comm:dark:text-gray-500"
             :comment="$comment"
             :mentionables="$mentionables"
             :tip-tap-css-classes="$tipTapCssClasses"
+            :ratings-enabled="$ratingsEnabled"
+            :max-rating="$maxRating"
         />
     @endforeach
 

resources/views/comment.blade.php

@@ -91,6 +91,10 @@ class="comm:text-xs comm:text-gray-300 comm:ml-1"
 
         @if ($editing)
             <div class="comm:mt-2">
+                @if ($this->ratingsAreEnabled())
+                    @include('commentions::partials.rating-input', ['maxRating' => $this->getMaxRating()])
+                @endif
+
                 <div class="tip-tap-container comm:mb-2" wire:ignore>
                     <div x-data="editor(@js($commentBody), @js($mentionables), 'comment', null, @js($this->getTipTapCssClasses()), @js($commentionsComponentPrefix . 'comment'))">
                         <div x-ref="element"></div>
@@ -116,8 +120,13 @@ class="comm:text-xs comm:text-gray-300 comm:ml-1"
             </div>
         @else
             @if ($comment->isComment() && $comment->rating)
-                <div class="comm:mt-1 comm:flex comm:items-center comm:gap-0.5" title="{{ $comment->rating }}/{{ \Kirschbaum\Commentions\Config::getMaxRating() }}">
-                    @for ($ratingStar = 1; $ratingStar <= \Kirschbaum\Commentions\Config::getMaxRating(); $ratingStar++)
+                <div
+                    class="comm:mt-1 comm:flex comm:items-center comm:gap-0.5"
+                    role="img"
+                    title="{{ $comment->rating }}/{{ $this->getMaxRating() }}"
+                    aria-label="{{ __('commentions::comments.rating_display_label', ['rating' => $comment->rating, 'max' => $this->getMaxRating()]) }}"
+                >
+                    @for ($ratingStar = 1; $ratingStar <= $this->getMaxRating(); $ratingStar++)
                         <x-filament::icon
                             icon="heroicon-s-star"
                             @class([

resources/views/comments.blade.php

@@ -6,25 +6,7 @@
         @if (Config::resolveAuthenticatedUser()?->can('create', Config::getCommentModel()))
             <form wire:submit.prevent="save" x-cloak>
                 @if ($this->ratingsAreEnabled())
-                    <div class="comm:mb-2 comm:flex comm:items-center comm:gap-0.5" x-data="{ hover: 0 }">
-                        @for ($ratingStar = 1; $ratingStar <= $this->getMaxRating(); $ratingStar++)
-                            <button
-                                type="button"
-                                wire:key="comment-rating-star-{{ $ratingStar }}"
-                                x-on:click="$wire.rating = ($wire.rating === {{ $ratingStar }} ? null : {{ $ratingStar }})"
-                                x-on:mouseenter="hover = {{ $ratingStar }}"
-                                x-on:mouseleave="hover = 0"
-                                class="commentions-rating-star"
-                                :class="{ 'commentions-rating-star-active': (hover || $wire.rating) >= {{ $ratingStar }} }"
-                            >
-                                <x-filament::icon icon="heroicon-s-star" class="comm:h-5 comm:w-5" />
-                            </button>
-                        @endfor
-                    </div>
-
-                    @error('rating')
-                        <p class="comm:mb-2 comm:text-xs comm:text-red-600">{{ $message }}</p>
-                    @enderror
+                    @include('commentions::partials.rating-input', ['maxRating' => $this->getMaxRating()])
                 @endif
 
                 {{-- tiptap editor --}}
@@ -64,6 +46,8 @@ class="commentions-rating-star"
             :load-more-label="$loadMoreLabel ?? __('commentions::comments.show_more')"
             :per-page-increment="$perPageIncrement ?? null"
             :tip-tap-css-classes="$tipTapCssClasses"
+            :ratings-enabled="$this->ratingsAreEnabled()"
+            :max-rating="$this->getMaxRating()"
         />
     </div>
 

resources/views/partials/rating-input.blade.php

@@ -0,0 +1,26 @@
+<div
+    class="comm:mb-2 comm:flex comm:items-center comm:gap-0.5"
+    x-data="{ hover: 0 }"
+    role="group"
+    aria-label="{{ __('commentions::comments.rating_input_label') }}"
+>
+    @for ($ratingStar = 1; $ratingStar <= $maxRating; $ratingStar++)
+        <button
+            type="button"
+            wire:key="comment-rating-star-{{ $ratingStar }}"
+            x-on:click="$wire.rating = ($wire.rating === {{ $ratingStar }} ? null : {{ $ratingStar }})"
+            x-on:mouseenter="hover = {{ $ratingStar }}"
+            x-on:mouseleave="hover = 0"
+            class="commentions-rating-star"
+            :class="{ 'commentions-rating-star-active': (hover || $wire.rating) >= {{ $ratingStar }} }"
+            :aria-pressed="($wire.rating === {{ $ratingStar }}).toString()"
+            aria-label="{{ trans_choice('commentions::comments.rate_stars', $ratingStar, ['count' => $ratingStar]) }}"
+        >
+            <x-filament::icon icon="heroicon-s-star" class="comm:h-5 comm:w-5" />
+        </button>
+    @endfor
+</div>
+
+@error('rating')
+    <p class="comm:mb-2 comm:text-xs comm:text-red-600">{{ $message }}</p>
+@enderror

src/Comment.php

@@ -188,6 +188,7 @@ public function getContentHash(): string
     {
         return md5(json_encode([
             'body' => $this->body,
+            'rating' => $this->rating,
             'reactions' => $this->reactions->pluck('id'),
         ]));
     }

src/CommentionsServiceProvider.php

@@ -10,6 +10,7 @@
 use Illuminate\Support\Facades\View;
 use Kirschbaum\Commentions\Comment as CommentModel;
 use Kirschbaum\Commentions\Events\UserWasMentionedEvent;
+use Kirschbaum\Commentions\Filament\Actions\TableAction;
 use Kirschbaum\Commentions\Listeners\SendUserMentionedNotification;
 use Kirschbaum\Commentions\Livewire\Comment;
 use Kirschbaum\Commentions\Livewire\CommentList;
@@ -44,6 +45,11 @@ public function configurePackage(Package $package): void
             ]);
     }
 
+    public function packageRegistered(): void
+    {
+        $this->aliasTableAction();
+    }
+
     public function packageBooted(): void
     {
         $prefix = Config::getComponentPrefix();
@@ -83,4 +89,24 @@ public function packageBooted(): void
             Event::listen(UserWasMentionedEvent::class, $listenerClass);
         }
     }
+
+    /**
+     * Bridge the package's {@see TableAction} to the correct Filament base class.
+     *
+     * Filament 4 unified actions under `Filament\Actions\Action`, removing the
+     * `Filament\Tables\Actions\Action` base that table actions extend on
+     * Filament 3. The bundled TableAction class already extends the unified base
+     * (correct for Filament 4/5); on Filament 3 it must instead resolve to the
+     * legacy table-action base, so alias it before CommentsTableAction loads.
+     */
+    protected function aliasTableAction(): void
+    {
+        if (class_exists(TableAction::class, false)) {
+            return;
+        }
+
+        if (class_exists('Filament\Tables\Actions\Action')) {
+            class_alias('Filament\Tables\Actions\Action', TableAction::class);
+        }
+    }
 }

src/Config.php

@@ -49,6 +49,11 @@ public static function getCommentSubscriptionTable(): string
         return config('commentions.tables.comment_subscriptions', 'comment_subscriptions');
     }
 
+    public static function ratingsAreEnabled(): bool
+    {
+        return (bool) config('commentions.ratings.enabled', false);
+    }
+
     public static function getMaxRating(): int
     {
         return (int) config('commentions.ratings.max', 5);