- How do I install schmeits/filament-pan-analytics-widget?
- Install it with Composer using composer require schmeits/filament-pan-analytics-widget, then register the plugin in your Filament panel provider. Version 5.0.0 no longer ships an install command, so setup is manual. Make sure your app meets the Filament 4/5, Laravel 12/13, and PHP 8.3–8.5 requirements first.
- Which Laravel, PHP, and Filament versions does this package support?
- Version 5.0.0 supports Filament 4 and 5, Laravel 12 and 13, and PHP 8.3 through 8.5. That is a deliberately narrow, latest-version-only platform window. Filament 3 applications must stay on the 4.x branch of this package.
- Does this package work with Filament 3?
- No. The 5.0.0 release drops Filament 3 support and pins to Filament 4 and 5. Filament 3 projects should remain on the package's 4.x branch and defer adoption until they complete a Filament 3 to 4 migration.
- How do I register the Pan Analytics widget plugin in a Filament panel?
- Register the widget as a Filament plugin in your panel provider; the removed install command means there is no automated scaffolding in 5.0.0. You can optionally configure behavior with fluent setters such as ->authorize(). This plugin-only registration model matches Filament's idiomatic extension approach.
- How do I restrict who can view the Pan Analytics widget?
- Use the fluent authorize() method, which accepts either a boolean or a Closure. This lets you gate the widget per panel and per role in multi-panel admin surfaces. Because authorization is resolved through the plugin, confirm your closure logic handles panels where the plugin is not registered.
- What breaking changes are in version 5.0.0?
- Version 5.0.0 drops Filament 3, requires Laravel 12/13 and PHP 8.3–8.5, renames getSearchable() to isSearchable(), and removes the "all" page-size option. It also removes the facade, the FilamentPanAnalyticsWidget class, the testing mixin, stubs, the view namespace, and the install command. Review direct references to those removed APIs before upgrading.
- Why is current() returning null in my multi-panel app?
- current() returns null on Filament panels where the Pan Analytics plugin has not been registered. In multi-panel apps, add null checks wherever you resolve the plugin reference instead of assuming a widget instance exists. This is expected behavior and helps scope analytics to panels that opt in.
- Can I publish or override the widget's views?
- No. Version 5.0.0 removes the view namespace and asset pipeline, so there is no supported way to publish or override the widget views. That is acceptable for a read-mostly analytics widget but rules out white-labeling and deep UI customization. If you depend on view overrides, stay on the 4.x branch until you have an alternative.
- How do I test the Filament Pan Analytics widget?
- The dedicated testing mixin was removed in 5.0.0, so test the widget through Filament and Livewire testing utilities in your application. The package itself is maintained with strict types, Larastan 3 at max level on source and tests, and architecture tests. That gives you a reasonable signal of internal quality even without the old mixin.
- How do I change the page size options, and why is the "all" option missing?
- The "all" page-size option was removed in 5.0.0, so users can no longer select a full-dataset view from the widget. If a reporting or export workflow depended on that option, review how page-size preferences are surfaced and provide an alternative. This is a visible behavior change, not just an internal cleanup.