README

Filament Mixpanel

Filament plugin for Mixpanel analytics — tracking script injection and Settings Page to manage Mixpanel configuration directly from your Filament panel. Supports Filament v3, v4, and v5.

Installation

You can install the package via composer:

composer require jeffersongoncalves/filament-mixpanel

This package depends on jeffersongoncalves/laravel-mixpanel which provides the core Mixpanel analytics integration for Laravel applications.

Requirements

• PHP 8.2 or higher
• Laravel 11.0 or higher
• Filament 5.0

Usage

1. Register the Plugin

Add the plugin to your PanelProvider:

use JeffersonGoncalves\Filament\Mixpanel\MixpanelPlugin;

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

This will automatically:

• Inject the Mixpanel tracking script into your panel
• Add a Settings Page to manage your Mixpanel configuration

2. Run Settings Migration

If you haven't already, publish the spatie/laravel-settings migration to create the settings table:

php artisan vendor:publish --provider="Spatie\LaravelSettings\LaravelSettingsServiceProvider" --tag="migrations"

Then publish and run the Mixpanel settings migration:

php artisan vendor:publish --tag=mixpanel-settings-migrations
php artisan migrate

3. Manage Settings

Navigate to Settings > Mixpanel Analytics in your Filament panel to configure:

• Project Configuration — Project Token, API Host, Custom Library URL
• Tracking & Debug — Debug Mode, Autocapture, Track Page Views
• Storage & Cookies — Persistence method, Cookie Expiration, Secure Cookie, Cross Subdomain
• Privacy & Geolocation — IP Geolocation, Property Blacklist, Opt Out by Default, UTM Persistence
• Advanced Features — Session Recording percentage, Heatmap Data collection

Disabling the Settings Page

If you only want the tracking script injection without the settings page:

MixpanelPlugin::make()
    ->settingsPage(false),

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

• Jefferson Goncalves
• All Contributors

License

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