Plugins
Badgeable Column
A custom table column that supports prefixed and suffixed badges on column content.
Table Column
Table Builder
Panel Builder
Dark theme support
Yes
Multi language support
No
Compatible with the latest version
Supported versions: 2.x - 3.x
Documentation

Latest Version on Packagist Total Downloads

badgeable-column-og

With Filament Badgeable Column you prepend and append badges to your columns.

#Installation

You can install the package via composer:

composer require awcodes/filament-badgeable-column

In an effort to align with Filament's theming methodology you will need to use a custom theme to use this plugin.

Note If you have not set up a custom theme and are using a Panel follow the instructions in the Filament Docs first. The following applies to both the Panels Package and the standalone Forms package.

Add the plugin's views to your tailwind.config.js file.

content: [
'<path-to-vendor>/awcodes/filament-badgeable-column/resources/**/*.blade.php',
]

#Usage

use Awcodes\FilamentBadgeableColumn\Components\Badge;
use Awcodes\FilamentBadgeableColumn\Components\BadgeableColumn;
 
return $table
->columns([
BadgeableColumn::make('name')
->suffixBadges([
Badge::make('hot')
->label('Hot')
->color('danger')
->visible(fn(Model $record) => $record->qty < 5),
])
->prefixBadges([
Badge::make('brand_name')
->label(fn(Model $record) => $record->status)
->color(function(Model $record) {
return match ($record->status) {
'active' => 'success',
'inactive' => 'danger',
default => 'warning',
};
})
])
]);

You can also define the array of badges via a closure, if you want the array of badges to be based on dynamic data. The closure should return an array of Badge objects, similar to above.

The example below assumes the records have a BelongsToMany relationship called topics, and shows how to display each topic name as a badge.

use Awcodes\FilamentBadgeableColumn\Components\Badge;
use Awcodes\FilamentBadgeableColumn\Components\BadgeableColumn;
 
return $table
->columns([
BadgeableColumn::make('title')
->suffixBadges(function($record) {
return $record->topics->map(function($topic) {
return Badge::make($topic->name)->color($topic->color);
});
})
->searchable()
->sortable(),
]);

#Badgeable Tags Column

Warning The Badgeable Tags Column has been deprecated please use the TextColumn badge() method instead.

#Badge Shape

If you prefer to have a more "rounded" shape you can use the asPills() method to set the shape of the badges.

use Awcodes\FilamentBadgeableColumn\Components\Badge;
use Awcodes\FilamentBadgeableColumn\Components\BadgeableColumn;
 
return $table
->columns([
BadgeableColumn::make('name')
->asPills()
]);

#Separator

The default separator between the column text and the badges is '—'. If you would like to use a different separator, use the separator() method to set character to be used as a separator.

use Awcodes\FilamentBadgeableColumn\Components\Badge;
use Awcodes\FilamentBadgeableColumn\Components\BadgeableColumn;
 
return $table
->columns([
BadgeableColumn::make('name')
->separator(':')
]);

#Changelog

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

#Contributing

Please see CONTRIBUTING for details.

#Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

#Credits

#License

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

Adam Weston

Adam is a full-stack web developer (with a focus on Laravel) who has been coding for close to 20 years. He is a core Filament team member as well and has authored numerous plugins for Filament such as Curator, Tiptap Editor and Table Repeater, to name a few. You can learn more about Adam on his website.

14
Plugins
1,270
Stars
More from this author
Featured Plugins