Filament Gtag
Filament plugin for managing Google Analytics (Gtag) settings with a Settings Page powered by spatie/laravel-settings. Automatically injects the tracking script into Filament panels.
This plugin is built on top of the laravel-gtag package, which provides the core Google Analytics integration for Laravel applications.
Compatibility
| Branch | Filament | PHP | Laravel |
|---|
| 1.x | 3.x | ^8.2 | ^11.0 | ^12.0 |
| 2.x | 4.x | ^8.2 | ^11.0 | ^12.0 |
| 3.x | 5.x | ^8.2 | ^11.0 | ^12.0 |
Installation
You can install the package via composer:
composer require jeffersongoncalves/filament-gtag
Publish and run the settings migrations:
php artisan vendor:publish --provider="Spatie\LaravelSettings\LaravelSettingsServiceProvider" --tag="migrations"
php artisan vendor:publish --tag=gtag-settings-migrations
php artisan migrate
Usage
Register the plugin in your PanelProvider:
use JeffersonGoncalves\Filament\Gtag\GtagPlugin;
public function panel(Panel $panel): Panel
{
return $panel
->plugins([
GtagPlugin::make(),
]);
}
The plugin will:
- Add a Google Analytics Settings page to your panel (under "Settings" navigation group)
- Automatically inject the gtag tracking script into the panel's
<head>
Disable the Settings Page
If you only want the automatic script injection without the settings page:
GtagPlugin::make()
->settingsPage(false),
Navigation group
Put the settings page in one of your panel's own navigation groups (a string or a closure):
GtagPlugin::make()
->navigationGroup(fn (): string => __('admin.navigation.settings')),
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
License
The MIT License (MIT). Please see License File for more information.
