- What does the filament-plausible package do?
- It is a Filament plugin that brings Plausible Analytics directly into your admin panel. It adds a settings page where you store your site domain and API key, plus ready-to-use dashboard widgets for visitors, pageviews, sources, and top pages. You can monitor traffic without leaving Filament or opening the Plausible dashboard in another tab.
- How do I install jeffersongoncalves/filament-plausible?
- Install it with Composer using composer require jeffersongoncalves/filament-plausible. Then register the plugin on your Filament panel in the PanelProvider by calling the plugin class's make() method inside the panel's plugin() chain. No migrations or asset builds are required for the panel integration itself.
- How do I connect my Plausible account to the plugin?
- Open the plugin's settings page in your Filament panel and enter the site domain exactly as it appears in Plausible, for example example.com. Then paste in an API key generated from your Plausible account settings so the widgets can query the Stats API. Once saved, the dashboard widgets start pulling live traffic data for that site.
- Which Laravel and Filament versions are supported?
- The plugin targets Laravel applications running Filament v3 panels, where it is registered through a PanelProvider. Always check the composer.json constraints in the repository before installing, since the supported Laravel range and the filament-analytics-core floor can change between releases. If you are pinned to an older Filament major version, verify compatibility first.
- Do I need to run migrations or publish config files?
- The plugin is a presentation-layer integration for your panel, and the navigationGroup() API in particular adds no migrations, services, or published config. Installation is essentially a Composer require plus a one-line plugin registration in your PanelProvider. Check the README for any optional publishing steps, but you should not need to alter your analytics data flow.
- How do I change the navigation group of the Plausible settings page?
- Call the fluent navigationGroup() method on the plugin instance in your PanelProvider, for example Plugin::make()->navigationGroup('Analytics'). It is an opt-in, additive API, so nothing changes unless you call it. For best results use a group name the panel already registers via Panel::navigationGroups(), otherwise the page may land in an implicitly created group with unexpected ordering.
- Can navigationGroup() accept a Closure for multi-tenant or role-based panels?
- Yes, the parameter is typed as string|Closure, so you can return a group name dynamically based on tenant, role, or a translation lookup. Keep the resolver deterministic and defensive, because it is evaluated during panel and navigation rendering rather than only on the settings page. If the closure throws, it can affect bootstrapping for every page in that panel.
- What happens if I never call navigationGroup()?
- Nothing changes: the settings page keeps rendering under the package's existing translated navigation group. The feature is a minor, opt-in release, so consumers who never call the method see identical behaviour after upgrading. Only teams that explicitly call navigationGroup() get the override.
- Does navigationGroup() require a newer version of filament-analytics-core?
- Yes, the method relies on filament-analytics-core 3.1 or higher, so you should bump that sibling dependency to ^3.1 and confirm your lockfile resolves it before deploying. Running the method against an older core risks a BadMethodCallException at runtime. Treat the upgrade as a hard prerequisite rather than an optional nicety.
- Is this a good privacy-friendly alternative to Google Analytics in production?
- Plausible is a cookieless, privacy-focused analytics service, which is why many teams use it as a GDPR-friendlier alternative to Google Analytics. The plugin only renders the data inside your Filament panel and sends your API key server-side to the Plausible Stats API, so keep that key out of version control and restrict panel access to trusted users. Traffic data is still subject to Plausible's own retention and data-processing terms, so review those against your compliance requirements.