README

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

Building Assets (For Development)

If you're developing or modifying this package, you'll need to build the assets:

# Install dependencies
npm install

# Build assets
npm run build

Usage

To use the Resized Column functionality, simply include the HasResizableColumn trait in your Filament resource 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)

3. If developing the package, rebuild the assets:

   npm run build

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.