#Filament Metrics PostHog

PostHog web analytics dashboard widgets for Filament, with a settings page powered by Spatie Laravel Settings to manage your PostHog personal API key, project ID and host directly from the admin panel. Works with PostHog Cloud (US/EU) and self-hosted instances.

Built on top of jeffersongoncalves/laravel-metrics-posthog (HogQL query API).

#Compatibility

#Installation

You can install the package via composer:

composer require jeffersongoncalves/filament-metrics-posthog:"^3.0"

Publish the settings migrations and run them:

php artisan vendor:publish --tag=metrics-posthog-settings-migrations
php artisan migrate

#Usage

Add the plugin to your Filament panel provider:

use JeffersonGoncalves\Filament\MetricsPostHog\PostHogMetricsPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            PostHogMetricsPlugin::make(),
        ]);
}

Then open Settings > PostHog in your panel and fill in a personal API key (with the query:read scope) and the project ID. Change the host under Advanced Settings for the EU cloud or a self-hosted instance.

#Widgets

All widgets cover the last 30 days and are cached (15s for realtime, 5 minutes for the rest):

#Customization

PostHogMetricsPlugin::make()
    ->settingsPage(false) // hide the settings page
    ->widgets(false),     // don't register the dashboard widgets

With widgets(false) you can still place the widget classes on any page yourself.

#Requirements

• PHP 8.2 or higher
• Filament 5.x

#Testing

composer test

#Changelog

Please see CHANGELOG for more information on what has changed recently.

#Contributing

Please see CONTRIBUTING for details.

#Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

#Credits

• Jèfferson Gonçalves
• All Contributors

#License

The MIT License (MIT). Please see License File for more information.