README

此包将允许您在任何 Laravel Nova Metric 类上访问您的资源过滤器，并在您在资源列表中选择新过滤器时动态更新这些卡片。

图表是显示仪表板上的图形信息的好方法，并且使用 Laravel Nova 可以快速创建漂亮的 Metrics 卡。

您还可以将这些图表用于资源视图。

通常，当您将那些度量添加到任何资源时，您会期望图表是下面列表中看到的数据的表示。目前在 Nova 上这是不可能的——当您更改过滤器选择时，资源列表会更新，但相应的图表不会。

这是因为填充列表的请求与获取度量数据的请求是独立的。这意味着更新过滤器会中断与图表的连接，使它们过时。

此包恢复这种连接，确保屏幕上的图表和数据保持同步。

安装

通过 composer 安装

composer require square1/nova-metrics

用法

您可以使用默认的 nova 命令创建新的度量。

php artisan nova:partition NewPartition
php artisan nova:trend NewTrend
php artisan nova:value NewValue

然后您只需要更新您最近创建的度量类。从以下类之一扩展以访问您的资源过滤器

use Square1\NovaMetrics\CustomTrend;
use Square1\NovaMetrics\CustomValue;
use Square1\NovaMetrics\CustomPartition;

例如

<?php

namespace App\Nova\Metrics;

use App\Post;
use Square1\NovaMetrics\CustomTrend;
use Laravel\Nova\Http\Requests\NovaRequest;

class NewTrend extends CustomTrend
{
    public function calculate(NovaRequest $request)
    {
        // $request->filters
    }
}

假设您有一个 CategoryFilter::class

<?php

namespace App\Nova\Filters;

use Illuminate\Http\Request;
use Laravel\Nova\Filters\Filter;

class CategoryFilter extends Filter
{

    public $component = 'select-filter';


    public function apply(Request $request, $query, $value)
    {
        return $query->where('category', $value);
    }

    public function options(Request $request)
    {
        return [
            'css' => 'css',
            'javascript' => 'javascript',
            'laravel' =>'laravel',
            'php' => 'php',
        ];
    }
}

这是您如何将此过滤器应用于您的 NewTrend::class

class NewTrend extends CustomTrend
{
    public function calculate(NovaRequest $request)
        {
            $model = Post::make();
    
            if (!empty($filters)) {
                if ($request->has('filters')) {
                    // Get the decoded list of filters
                    $filters = json_decode(base64_decode($request->filters));
        
                    foreach ($filters as $filter) {
                        if (empty($filter->value)) {
                            continue;
                        }
                        // Create a new instance of the filter and apply the query to your model
                        $model = (new $filter->class)->apply($request, $model, $filter->value);
                    }
                }
            }
            
            return $this->averageByDays($request, $model, 'pageviews');
        }
}

已知问题

如果您想为此包做出贡献，这是一个好开始的地方 😊

• 等待第一个 resources-loaded 事件被触发以加载卡片。
• 在请求对象中解析 $request->filters。