• Features
• Installation
• Registering the Plugin
• Publishing filament assets
• Publishing Migrations
• Usage
• Storage Configuration
• Configuration Options
• Example: Custom Database Storage
• Troubleshooting
  • CSS Styles Not Loading
• Credits
  • Security
• Contributing
  • 📄 License

The Resizable Columns plugin allows you to resize table columns in Filament with persistent width settings. This package provides a seamless way to customize table layouts by letting users adjust column widths according to their preferences.

#Features

• Drag-to-resize column functionality
• Persistent column width settings
• Per-user width preferences
• Session and database storage options
• Easy integration with existing Filament tables
• Customizable storage mechanisms

#Installation

You can install the package via composer:

composer require asmit/resized-column

#Registering the Plugin

Add the plugin to your Filament panel configuration in app/Providers/Filament/AdminPanelProvider.php:

use Asmit\ResizedColumn\ResizedColumnPlugin;
 
public function panel(Panel $panel): Panel
{
    return $panel
        // ... other configuration
        ->plugins([
            // ... other plugins
            ResizedColumnPlugin::make()
                ->preserveOnDB() // Enable database storage (optional)
        ]);
}

#Publishing filament assets

php artisan filament:assets

#Publishing Migrations

# Publish migrations
php artisan vendor:publish --provider="Asmit\ResizedColumn\ResizedColumnServiceProvider" --tag=resized-column-migrations
 
# Run migrations
php artisan migrate

#Usage

To use the Resized Column functionality, simply include the HasResizableColumn trait in your Filament List Page or your custom page class. This will automatically enable the resizable column feature for all tables in that resource.

use Asmit\ResizedColumn\HasResizableColumn;
 
class ListUsers extends ListRecords
{
    use HasResizableColumn;
 
    protected static string $resource = UserResource::class;
 
    // Your existing table definition...
}

#Storage Configuration

The package provides two storage mechanisms:

1. Session Storage (Enabled by default)

   • Stores column widths in the user's session
   • No database required
   • Storage is browser/device specific

2. Database Storage (Optional)

   • Stores column widths in the database
   • Requires migration to create the table_settings table
   • Works across browsers/devices for the same user

You can enable or disable database storage in your panel configuration:

ResizedColumnPlugin::make()
    ->preserveOnDB(true) // Enable database storage

#Configuration Options

You can override any of the following methods in your class to customize behavior:

#Example: Custom Database Storage

use Asmit\ResizedColumn\HasResizableColumn;
 
class ListUsers extends ListRecords
{
    use HasResizableColumn;
 
    protected function persistColumnWidthsToDatabase(): void
    {
        // Your custom database save logic here
        YourCustomModel::updateOrCreate(
            [
                'user_id' => $this->getUserId(),
                'resource' => $this->getResourceModelFullPath(), // e.g., 'App\Models\User'
            ],
            ['settings' => $this->columnWidths]
        );
    }
}

#Troubleshooting

#CSS Styles Not Loading

If the resize handles are not displaying correctly:

1. Make sure you have published the Filament assets:

   php artisan filament:assets

2. Clear your browser cache or try a hard refresh (Ctrl+F5)

#Credits

• Asmit Nepal
• Kishan Sunar

#Security

If you discover a security vulnerability within this package, please send an e-mail to asmitnepali99@gmail.com. All security vulnerabilities will be promptly addressed.

#Contributing

Please see CONTRIBUTING for details.

#📄 License

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