Remember Table

• Requirements
• Installation
• Usage
  • Preset views
  • Several tables on one page
• What is saved
• Configuration
• How it behaves
• Customizing the actions
• Testing
• Roadmap
• Changelog
• License

Let your users save the way they like a Filament table (filters, search, sorting, grouping, visible columns) as named views, and switch between them in one click.

• Save the current table as a named view
• Switch views from a dropdown in the page header
• Update, rename, reorder and delete views
• Set a default view that opens automatically
• Define preset views in code
• Share a view with every user of the panel
• Shareable links: the active view lives in the URL (?view=12)
• Multi-tenancy aware
• English and Arabic translations, RTL friendly

#Requirements

• PHP 8.2+
• Filament 5.x

#Installation

composer require sehsah/filament-remember-table
php artisan filament-remember-table:install

The install command publishes the config and migration and asks to run the migration. You can also do it by hand:

php artisan vendor:publish --tag="filament-remember-table-config"
php artisan vendor:publish --tag="filament-remember-table-migrations"
php artisan migrate

#Usage

Add the trait to a page that has a table (usually a resource's list page) and put the actions in the header:

use Filament\Actions\CreateAction;
use Filament\Resources\Pages\ListRecords;
use Sehsah\FilamentRememberTable\Concerns\HasRememberTable;

class ListOrders extends ListRecords
{
    use HasRememberTable;

    protected static string $resource = OrderResource::class;

    protected function getHeaderActions(): array
    {
        return [
            ...$this->getTableViewActions(),
            CreateAction::make(),
        ];
    }
}

That's it. A Views button appears in the page header.

#Preset views

Views defined in code show up for everyone and can't be edited or deleted by users:

use Sehsah\FilamentRememberTable\PresetView;

public function getPresetTableViews(): array
{
    return [
        PresetView::make('Pending orders')
            ->icon('heroicon-o-clock')
            ->filters(['status' => ['value' => 'pending']])
            ->sort('created_at', 'desc')
            ->default(), // used when the user has no default of their own

        PresetView::make('Big spenders')
            ->filters(['total' => ['total_from' => 1000]])
            ->hiddenColumns(['notes'])
            ->visibleColumns(['customer.email'])
            ->grouping('customer.name'),
    ];
}

filters() takes the raw filter form state, keyed by filter name. For a SelectFilter or TernaryFilter that is ['value' => ...]; for a multiple SelectFilter it is ['values' => [...]]; for a custom filter it is whatever its form fields are named.

Other preset options: search(), tab() (a key from the list page's getTabs()), perPage() and key() (a stable id for the URL).

#Several tables on one page

Views are stored per page class. If you reuse the same page class for different tables, override the key:

public function getTableViewsKey(): string
{
    return static::class . ':' . $this->type;
}

#What is saved

Turn parts on or off in config/remember-table.php under remember.

Saved views are validated when they are applied: filters, columns, groups and tabs that no longer exist on the table are ignored, and columns you added after a view was saved still show up.

#Configuration

return [
    'table_name' => 'remember_table_views',
    'model' => \Sehsah\FilamentRememberTable\Models\TableView::class,

    'remember' => [ /* see table above */ ],

    'allow_public_views' => true,        // "Share with everyone" toggle
    'apply_default_view_on_load' => true,
    'scope_to_tenant' => true,           // separate views per Filament tenant
    'max_views_per_table' => 50,         // per user; null for no limit
];

#How it behaves

• Default view: applied when a user opens the table, unless the URL already has table state (?filters=, ?search=, ?sort=, ?tab=...), so links to a filtered table keep working.
• Modified indicator: after applying a view, changing the table shows View name (modified) on the button, and Update current view appears for views the user owns.
• Shared views: other users can apply them, and they are labelled Shared. Only the owner can update, rename or delete them.
• Reset table: clears the active view and puts the table back to its defaults.

#Customizing the actions

Each action is a normal Filament action. To tweak one, alias the trait method and wrap it:

use HasRememberTable {
    saveTableViewAction as baseSaveTableViewAction;
}

public function saveTableViewAction(): \Filament\Actions\Action
{
    return $this->baseSaveTableViewAction()->modalWidth('lg');
}

Available: saveTableViewAction(), updateTableViewAction(), manageTableViewsAction(), resetTableViewAction().

#Testing

composer test

#Roadmap

• Team-level sharing (share with specific roles or users)
• Record count badges on views
• Views as tabs above the table
• A panel page listing all views
• Import / export views as JSON

#Changelog

See CHANGELOG.

#License

The MIT License (MIT). See License File.