aw codes icon logo
Docs Hub

Search across every project.

Curator Switch project

A media picker plugin for FilamentPHP.

5.x Current

On this page

Table column

CuratorColumn renders media in a table. It extends Filament's ImageColumn, so everything that works there works here.

use Awcodes\Curator\Components\Tables\CuratorColumn;

CuratorColumn::make('featured_image')
    ->size(40);

Multiple images

For a relationship holding several images, control how many are shown and how they stack:

use Awcodes\Curator\Components\Tables\CuratorColumn;

CuratorColumn::make('product_pictures')
    ->ring(2)
    ->overlap(4)
    ->limit(3);

ring() accepts 0, 1, 2 or 4, and overlap() accepts 0, 2, 3 or 4.

Avoiding N+1 queries

A column backed by a relationship will query once per row unless you eager load it. In a panel resource's list page:

protected function getTableQuery(): Builder
{
    return parent::getTableQuery()->with(['featured_image', 'product_pictures']);
}

Or from a table class:

public static function configure(Table $table): Table
{
    return $table
        ->modifyQueryUsing(fn (Builder $query) => $query->with('media', 'gallery'));
}