- What is hans-thomas/filterable-overview-widget used for?
- It is a Laravel/PHP package that adds a configurable, filterable overview widget for Filament dashboards and admin panels. It helps you show aggregated records, apply custom filters, and tailor queries, columns, and display options for flexible reporting views.
- How do I install hans-thomas/filterable-overview-widget in a Laravel app?
- Install it with Composer using the package name hans-thomas/filterable-overview-widget, then follow the repository README for Filament widget registration and any publishable configuration. Check the README requirements first because Filament setup steps can vary by major version.
- Which Laravel and Filament versions does this package support?
- The repository README and composer.json are the authoritative sources for supported Laravel, PHP, and Filament versions. Review those requirements before installing, especially if your admin panel uses an older or newer Filament major version. If compatibility is unclear, open a repository issue before adopting it.
- How do I add custom filters to the filterable overview widget?
- Define filters through the widget's configuration points and connect each filter to the appropriate query constraints, following the README examples for exact method names. Keep filter logic in reusable query scopes so dashboard behavior stays testable and consistent. Then verify filtered aggregates against known records.
- Can I customize the query, columns, and display options?
- Yes. The package is described as configurable for queries, columns, and display options, so you can tailor reporting views to your admin panel. Use the README to identify the supported configuration methods and test changes with representative data.
- How do I show aggregated records in a Filament dashboard widget?
- Register the filterable overview widget in your Filament panel or dashboard as described in the package README, then configure its query and columns for the records you want to aggregate. Render the dashboard and confirm counts or sums change correctly when filters are applied.
- Is it safe to use in production admin panels?
- It can be suitable for production dashboards and admin panels when it is compatible with your Laravel and Filament versions and your aggregate queries are optimized. Test filters on production-like data volumes, add indexes where needed, and review the repository maintenance activity before relying on it. Avoid exposing sensitive aggregate data to unauthorized users.
- How do I test a filterable stats overview widget?
- Create known records with factories, render the Filament page or widget in a feature test, and assert the visible aggregates for both unfiltered and filtered states. Test each custom filter against expected counts or sums, and cover edge cases such as empty results. Use the package's own tests as a reference if available.
- What are alternatives to this package for Filament stats widgets?
- Filament includes built-in stats overview widgets, and other community packages offer dashboard metrics and filtering. Compare them on required filters, custom queries, column customization, Laravel and Filament compatibility, and maintenance. Choose this package when its filterable overview approach matches your reporting needs.
- Where can I find setup and configuration documentation?
- Use the GitHub repository README at github.com/hans-thomas/filterable-overview-widget for installation, configuration, and usage guidance. Also review composer.json, releases, and issues for version-specific details. The README is the best starting point because the package API and Filament integration steps may change over time.