README

为您的 Laravel Eloquent 模型添加关联分析的能力。

$post = Post::find(1);

event(new Viewed($post))

安装

您可以通过 composer 安装此包

composer require starfolksoftware/analytics

包将自动注册自身。

您可以使用以下命令发布迁移

php artisan vendor:publish --provider="StarfolkSoftware\Analytics\AnalyticsServiceProvider" --tag="migrations"

迁移发布后，您可以通过运行迁移来创建 media-table

php artisan migrate

您可以使用以下命令发布配置文件

php artisan vendor:publish --provider="StarfolkSoftware\Analytics\AnalyticsServiceProvider" --tag="config"

要注册 Viewed 事件，CaptureView 和 CaptureVisit 监听器，请按以下方式编辑您的 EventServiceProvider

  ...
  /**
   * The event listener mappings for the application.
   *
   * @var array
   */
  protected $listen = [
    'StarfolkSoftware\Analytics\Events\Viewed' => [
      'StarfolkSoftware\Analytics\Listeners\CaptureView',
      'StarfolkSoftware\Analytics\Listeners\CaptureVisit',
    ],
  ];

使用方法

注册模型

为了让您的模型能够具有分析功能，请将 HasViews、HasVisits 特性添加到模型类中。

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use StarfolkSoftware\Analytics\Traits\{HasViews, HasVisits};

class Post extends Model
{
  use HasViews, HasVisits;
  ...
}

使用方法

要触发模型上的查看事件，您可以使用 event() 辅助方法。它接收 Viewed 的实例。

$post = Post::find(1);

event(new Viewed($post))

此事件将触发 CaptureView 和 CaptureVisit 监听器。

检索分析

使用 HasViews 和 HasVisits 特性的模型可以通过 views 和 visits 关系分别访问其分析

$post = Post::find(1);

// Retrieve
$views = $post->views;
$visits = $post->visits;

测试

composer test

变更日志

请参阅CHANGELOG以获取有关最近更改的更多信息。

贡献

请参阅CONTRIBUTING以获取详细信息。

安全

如果您发现任何与安全相关的问题，请通过电子邮件frknasir@yahoo.com联系，而不是使用问题跟踪器。

鸣谢

• Faruk Nasir
• 所有贡献者

许可证

MIT 许可证（MIT）。请参阅许可证文件以获取更多信息。