Rating by asign

• Screenshots
• Requirements
• Installation
• Usage
  • Options
  • Tooltips
  • Columns and entries
  • Custom icons
• Accessibility
• Migrating from mokhosh/filament-rating
• Translations
• AI agents
• Testing
• Changelog
• More plugins by asign
• License

Star ratings for Filament 5: a form field, a table column and an infolist entry that look the same everywhere. Half stars, a "no stars" choice, custom icons (hearts, thumbs, anything from Blade Icons), per-value tooltips, an optional "4.5" next to the stars. The field is a real slider for the keyboard and for screen readers ("3 of 5 stars"), mirrors in RTL and follows the panel colours and dark mode. It is the successor of mokhosh/filament-rating, which stopped before Filament 5, with the same class and method names so you migrate by swapping a namespace.

No JavaScript to build and no Tailwind safelist: the interaction is a few lines of inline Alpine, the stylesheet is namespaced (.fi-rating*) and uses Filament's own colour variables. Free (MIT), there is no Pro edition.

#Screenshots

A form with whole stars, half stars and a 10-heart score:

The same ratings in a table (compact) and in an infolist:

Dark mode follows the panel:

#Requirements

• PHP 8.3+
• Laravel 12 or 13
• Filament 5

#Installation

composer require asignua/filament-rating
php artisan filament:assets

php artisan filament-rating:install does the second step too. The plugin class is optional (the field, column and entry work without it); register it if you prefer to list your plugins on the panel:

use Asignua\FilamentRating\RatingPlugin;

$panel->plugin(RatingPlugin::make());

#Usage

use Asignua\FilamentRating\Columns\RatingColumn;
use Asignua\FilamentRating\Components\Rating;
use Asignua\FilamentRating\Entries\RatingEntry;

// Form
Rating::make('rating')->required();

// Table
RatingColumn::make('rating')->sortable();

// Infolist
RatingEntry::make('rating');

The field stores a whole number (4). Store it in an integer column. With half stars it stores 3.5, so use a decimal(2,1) or float column; an empty field is null.

#Options

Every option is available on the field, the column and the entry (and takes a value or a closure), except where noted.

The field is a normal Filament field, so required(), label(), live(), default(), helperText(), hint() and the rest work as usual. It validates that the value is numeric, between the minimum and the number of stars, and on the step (no 2.3 on half stars). The minimum is one step: 1 on whole stars, 0.5 on half stars, or 0 with allowZero(). Blank text counts as empty (null), anything that is not a number is rejected.

#Tooltips

Rating::make('quality')
    ->tooltips([1 => 'Poor', 3 => 'Good', 5 => 'Excellent'])
    ->allowZero();

// half steps need string keys: PHP truncates a float array key
Rating::make('rating')->halfStars()->tooltips(['4.5' => 'Almost perfect']);

// or compute it
Rating::make('rating')->tooltips(fn (float $value): ?string => $value >= 4 ? 'Recommended' : null);

The text shows as a tooltip while hovering that value and is added to the spoken label ("3 of 5 stars - Good").

#Columns and entries

RatingColumn::make('rating')->halfStars()->showValue()->size('xs');

RatingEntry::make('rating')->halfStars()->showValue()->size('lg')->color('warning');

Columns are compact (sm) by default. The stars are rounded to the step of the theme (4.3 shows as 4.5 stars on half stars, 4 on whole stars) and showValue() prints the stored number as it is (one decimal, not clamped to the number of stars). A record without a rating shows empty stars labelled "No rating". Sorting and searching are Filament's own (->sortable()).

#Custom icons

Rating::make('love')->icon('heroicon-s-heart')->emptyIcon('heroicon-o-heart')->color('danger')->stars(7);

#Accessibility

• The field is a single role="slider" tab stop with aria-valuemin/max/now (the real minimum; aria-valuenow is left out while empty) and a spoken value such as "3.5 of 5 stars". Arrow keys change the value by one step (they follow the reading direction in RTL), Home and End jump to the ends, Delete or Backspace clears (with clearable() or allowZero()). The focus ring is visible.
• Columns and entries are role="img" with the same label; the decorative icons are hidden from screen readers.
• Disabled and read-only fields are not focusable and carry aria-disabled / aria-readonly.
• RTL: the filled part and the hover preview mirror automatically.

#Migrating from mokhosh/filament-rating

composer remove mokhosh/filament-rating
composer require asignua/filament-rating
php artisan filament:assets

Then replace the namespace: Mokhosh\FilamentRating\ becomes Asignua\FilamentRating\ (Components\Rating, Columns\RatingColumn, Entries\RatingEntry, RatingTheme keep their names and places).

The stored values are the same (an int, or 3.5 on half stars), so no data migration is needed.

#Translations

The interface ships in English, Ukrainian, German, Spanish, French, Italian, Dutch, Polish, Brazilian Portuguese and Turkish under the filament-rating::filament-rating namespace. A test keeps every language in step with the English keys. Override a string by publishing the translations (--tag=filament-rating-translations) and editing the copy in lang/vendor/filament-rating.

#AI agents

The package ships Laravel Boost guidelines (resources/boost/guidelines/core.blade.php) so a coding agent wires it up correctly.

#Testing

composer install
vendor/bin/phpunit
vendor/bin/phpstan analyse --memory-limit=1G
vendor/bin/pint --test

Try it by hand with the workbench (a Reviews resource with a field, a column and an infolist):

vendor/bin/testbench workbench:build
vendor/bin/testbench filament:assets
vendor/bin/testbench db:seed --class="Workbench\\Database\\Seeders\\DemoSeeder"
vendor/bin/testbench serve --host=0.0.0.0

Open /admin/reviews and log in as [email protected] / password.

#Changelog

See CHANGELOG.md.

#More plugins by asign

• Toggle Icon Column — clickable boolean icon column
• Themes — per-user and per-panel colour themes
• Record Lock — stop two people editing the same record
• Row Layout — column manager for tables

All plugins: https://filamentphp.com/plugins?q=asign

#License

The MIT License (MIT). See LICENSE.md.