README

Filament Google Analytics

为 Filament (FilamentAdmin) 提供的 Google Analytics 集成

安装

您可以通过 composer 在使用 Filament 的 Laravel 应用中安装此包

composer require hankiao/filament-google-analytics

目前，请按照 Spatie 的 Laravel Google Analytics 包中的说明获取您的凭证，然后将它们放在这里

yourapp/storage/app/analytics/service-account-credentials.json

同时，将以下内容添加到您的 Filament PHP 应用的 .env 文件中

ANALYTICS_VIEW_ID=

用法

默认情况下，所有小部件都在一个专门的 Google Analytics Dashboard 中启用。您可以从配置 filament-google-analytics 中启用或禁用特定小部件或整个专用仪表板，或者从主 Filament Dashboard 中显示或隐藏一些小部件。

发布配置文件并设置您的设置

php artisan vendor:publish --tag=filament-google-analytics-config

可用小部件

\hankiao\FilamentGoogleAnalytics\Widgets\PageViewsWidget::class,
\hankiao\FilamentGoogleAnalytics\Widgets\VisitorsWidget::class,
\hankiao\FilamentGoogleAnalytics\Widgets\ActiveUsersOneDayWidget::class,
\hankiao\FilamentGoogleAnalytics\Widgets\ActiveUsersSevenDayWidget::class,
\hankiao\FilamentGoogleAnalytics\Widgets\ActiveUsersFourteenDayWidget::class,
\hankiao\FilamentGoogleAnalytics\Widgets\ActiveUsersTwentyEightDayWidget::class,
\hankiao\FilamentGoogleAnalytics\Widgets\SessionsWidget::class,
\hankiao\FilamentGoogleAnalytics\Widgets\SessionsDurationWidget::class,
\hankiao\FilamentGoogleAnalytics\Widgets\SessionsByCountryWidget::class,
\hankiao\FilamentGoogleAnalytics\Widgets\SessionsByDeviceWidget::class,
\hankiao\FilamentGoogleAnalytics\Widgets\MostVisitedPagesWidget::class,
\hankiao\FilamentGoogleAnalytics\Widgets\TopReferrersListWidget::class,

自定义仪表板

虽然这个插件附带了一个默认仪表板，但有时您可能想更改 navigationLabel 或 navigationGroup，禁用一些 widgets 或其他选项。考虑到仪表板是一个简单的 filament page，最简单的解决方案是禁用默认仪表板并创建一个新的 page

php artisan filament:page MyCustomDashboardPage

然后从 可用小部件 列表中选择您想要的组件，在 getHeaderWidgets() 或 getFooterWidgets() 中注册。

<?php

namespace App\Filament\Pages;

use Filament\Pages\Page;
use hankiao\FilamentGoogleAnalytics\Widgets;

class MyCustomDashboardPage extends Page
{
    protected static ?string $navigationIcon = 'heroicon-o-document-text';

    protected static string $view = 'filament.pages.my-custom-dashboard-page';

    protected function getHeaderWidgets(): array
    {
        return [
            Widgets\PageViewsWidget::class,
            Widgets\VisitorsWidget::class,
            Widgets\ActiveUsersOneDayWidget::class,
            Widgets\ActiveUsersSevenDayWidget::class,
            Widgets\ActiveUsersFourteenDayWidget::class,
            Widgets\ActiveUsersTwentyEightDayWidget::class,
            Widgets\SessionsWidget::class,
            Widgets\SessionsDurationWidget::class,
            Widgets\SessionsByCountryWidget::class,
            Widgets\SessionsByDeviceWidget::class,
            Widgets\MostVisitedPagesWidget::class,
            Widgets\TopReferrersListWidget::class,
        ];
    }
}

功能

查看访问者和页面浏览量指标

查看活跃用户指标

查看会话和平均会话持续时间指标

按会话查看设备和国家/地区指标（WIP）

查看最常访问的页面和引用者列表

变更日志

请参阅 CHANGELOG 了解最近更改的详细信息。

贡献

如果您想为此包做出贡献，您可能想在 Filament 项目中进行测试

将此存储库叉到您的 GitHub 账户
在本地创建 Filament 应用
在 Filament 应用的根目录中克隆您的分支
在 /filament-google-analytics 目录中，为您的修复创建一个分支，例如 fix/error-message

在您的应用的 composer.json 中安装包

"require": {
    "hankiao/filament-google-analytics": "dev-fix/error-message as main-dev",
},
"repositories": [
    {
        "type": "path",
        "url": "filament-google-analytics"
    }
]

现在，运行 composer update

有关详细信息，请参阅 CONTRIBUTING

安全漏洞

请查看我们如何报告安全漏洞的安全策略

鸣谢

许可证

MIT 许可证（MIT）。有关更多信息，请参阅许可文件

hankiao / filament-google-analytics

维护者

详情