- How do I install this package for Filament 4.x?
- Run `composer require watheqalshowaiter/filament-sticky-table-header`, then publish Filament assets with `php artisan filament:assets`. Register the plugin in your `PanelProvider` using `StickyTableHeaderPlugin::make()`. No additional steps are needed for Filament 4.x.
- Does this work with Filament 5.x tables?
- Yes, the package explicitly supports Filament 5.x. The installation and configuration process is identical to other versions—just register the plugin in your `PanelProvider` and ensure you’re using the latest package version from Packagist.
- Will this break my existing table CSS or JavaScript?
- The package uses isolated CSS/JS targeting Filament’s default table classes. If your tables have heavily customized styles (e.g., custom scrollbars or `position: sticky` overrides), test thoroughly. The package avoids conflicts by leveraging Filament’s plugin system.
- Can I enable sticky headers for specific tables only?
- Yes, the plugin supports per-table configuration. Use the `shouldScrollToTopOnPageChanged()` method in your plugin registration to enable or disable the feature globally, or extend the plugin to target specific tables via custom logic in your Filament resources.
- Is this compatible with Laravel 11?
- No, this package requires Laravel 10–12. If you’re using Laravel 11, ensure it’s within the supported PHP (8.1–8.4) and Filament (3.x–5.x) ranges. Check the [Packagist page](https://packagist.org/packages/watheqalshowaiter/filament-sticky-table-header) for updates.
- How do I test sticky headers on mobile devices?
- Test using browser dev tools (Chrome/Firefox) or physical devices. The package is responsive by default, but edge cases (e.g., very narrow screens) may need custom CSS. Inspect the package’s assets in your browser’s dev tools to debug any issues.
- Does this package add any database queries or backend logic?
- No, this is a frontend-only solution. It only adds CSS/JS for sticky headers and scroll-to-top behavior, with zero impact on your database or Laravel backend. It’s purely a UX enhancement for Filament tables.
- Are there any known conflicts with other Filament plugins?
- No major conflicts have been reported, but if you’re using plugins that modify Filament’s table structure (e.g., custom columns or scroll behaviors), test thoroughly. The package is designed to work alongside Filament’s core plugins like Tables, Spatie Permissions, and Nova.
- How do I configure the scroll-to-top behavior?
- Use the `shouldScrollToTopOnPageChanged()` method in your plugin registration. Example: `StickyTableHeaderPlugin::make()->shouldScrollToTopOnPageChanged(true, 'smooth')`. Set `enabled` to `false` to disable it globally, or override it per-table in custom resources.
- What if I upgrade Filament to version 6 in the future?
- The package is actively maintained for Filament 3.x–5.x, but no guarantees exist for Filament 6.x. Monitor the [GitHub repo](https://github.com/WatheqAlshowaiter/filament-sticky-table-header) for updates or consider forking the package to adapt it yourself if needed.