PHPackages                             marshmallow/nova-global-filter - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Admin Panels](/categories/admin)
4. /
5. marshmallow/nova-global-filter

ActiveLibrary[Admin Panels](/categories/admin)

marshmallow/nova-global-filter
==============================

This package allows you to broadcast any of your existing Laravel Nova filters to metrics or custom cards.

v5.0.0(9mo ago)02591MITVuePHP ^8.1CI failing

Since Jan 7Pushed 9mo ago2 watchersCompare

[ Source](https://github.com/marshmallow-packages/nova-global-filter)[ Packagist](https://packagist.org/packages/marshmallow/nova-global-filter)[ RSS](/packages/marshmallow-nova-global-filter/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (2)Versions (4)Used By (0)

Nova Global Filter
==================

[](#nova-global-filter)

This package allows you to emit any of your existing Laravel Nova filters to metrics or custom cards.

[![screenshot](resources/gifs/nova-global-filter.gif)](resources/gifs/nova-global-filter.gif)

Important

This package was originally forked from [nemrutco/nova-global-filter](https://github.com/nemrutco/nova-global-filter). Since we were making many opinionated changes and the owner archived the repository, we decided to continue development in our own version rather than submitting pull requests that might not benefit all users of the original package. You're welcome to use this package, we're actively maintaining it. If you encounter any issues, please don't hesitate to reach out.

Installation
------------

[](#installation)

You can install the package in to a `Laravel` app that uses [Nova](https://nova.laravel.com) via composer:

```
composer require marshmallow/nova-global-filter
```

Usage
-----

[](#usage)

In this example, we are registering few `Metric Cards` and the `Global Filter` with a `Date` filter as:

```
...
use Marshmallow\NovaGlobalFilter\NovaGlobalFilter;
use App\Nova\Filters\Date;

class Store extends Resource
{
  ...
  public function cards(Request $request)
  {
    return [
      new TotalSales // Value Metric

      new Orders, // Trend Metric

      new MostSoldProduct, // Partition Metric

      // NovaGlobalFilter
      new NovaGlobalFilter([
        new Date, // Date Filter
      ]),
    ];
  }
  ...
}
```

And now `metric cards` or any `other cards` optimized to listen `GlobalFilter` can be filtered by using `GlobalFilterable` trait and calling `$this->globalFiltered($model,$filters)` method.

`globalFiltered($model, $filters = [])` method expect `$model` and `$filters` parameters:

```
use Marshmallow\NovaGlobalFilter\GlobalFilterable;
use App\Nova\Filters\Date;
...

class UsersPerDay extends Trend
{
use GlobalFilterable;

  public function calculate(NovaRequest $request)
  {
    // Filter your model with existing filters
    $model = $this->globalFiltered(Store::class,[
      Date::class // DateFilter
    ]);

    // Do your thing with the filtered $model
    return $this->countByDays($request, $model);

  }
...
}
```

And that's it. Cards will be filtered based on passed filter value.

If you want to apply default value on initial request make sure you set default value in your filter as

```
...
// set default date
public function default()
{
    return Carbon::now();
}
...
```

To change layout from `grid` to `inline`

*by default it's set to `grid`*

[![screenshot](resources/gifs/inline-reset-view.png)](resources/gifs/inline-reset-view.png)

```
...
new NovaGlobalFilter([
    // Filters
])->inline(),
...
```

To enable `Reset` button

```
...
new NovaGlobalFilter([
    // Filters
])->resettable(),
...
```

To add multiple `Global Filter`s

```
...
new NovaGlobalFilter([
    // Filters
])->inline()->resettable(),

new NovaGlobalFilter([
    // Filters
])->onlyOnDetail(),
...
```

To listen `Global Filter` on any `Custom Card`s:

```
...
created() {
  Nova.$on("global-filter-changed", filter => {
    // Do your thing with the changed filter
    console.log(filter);
  });
},
...
```

To request all filter states from `Global Filter` on any `Custom Card`s:

```
...
  Nova.$emit("global-filter-request");
...
```

To request spesific filters state from `Global Filter` on any `Custom Card`s:

```
...
created() {
  Nova.$emit("global-filter-request", [
      "App\\Nova\\Filters\\DateFilter",
      "App\\Nova\\Filters\\CountryFilter"
  ]);
},
...
```

To receive filters state from `Global Filter` on any `Custom Card`s:

```
...
created() {
  Nova.$on("global-filter-response", filters => {
    // Do your thing with the filters
    console.log(filters);
  });
},
...
```

Good to know
------------

[](#good-to-know)

- Basic functionality of this package is that it listens all the asigned filters. Once a value of a filter is changed, it emits as `Nova.$on('global-filter-changed', [changed filter and value])`. So any card that listens to this event will recieve the filter and its value.
- This package overwrites Nova's default `Metric Card`s to allow them to listen `"global-filter-changed"` event. Make sure there are no any conflicts with other pacages.
- This package currently does not support Index view filters to be synchronized. So filters in `Global Filter` will not trigger update at the filters in `Filter Menu` of your Index view.
- `Reset` button simply reloads the current page. There is nothing fancy going on behind the scenes.
- If you are willing to support this package, it will be great to get your issues, PRs and thoughts on [Github](https://github.com/nemrutco/). And dont forget to `Star` the package.

Cheers

Made with ❤️ for open source

- [Nemrut Creative Studio](https://nemrut.co)
- [Muzaffer Dede](https://github.com/muzafferdede)
- [nemrutco/nova-global-filter](https://github.com/nemrutco/nova-global-filter)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance58

Moderate activity, may be stable

Popularity14

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 85.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~113 days

Total

3

Last Release

270d ago

Major Versions

v3.0.0.x-dev → v5.0.02025-08-21

PHP version history (2 changes)v3.0.0PHP ^8.0

v5.0.0PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/be33d2624e24c516e73892b0929447cc762f3622c024ab8d0d2a59042e5d2c7f?d=identicon)[marshmallow](/maintainers/marshmallow)

---

Top Contributors

[![LTKort](https://avatars.githubusercontent.com/u/2412670?v=4)](https://github.com/LTKort "LTKort (6 commits)")[![stefvanesch](https://avatars.githubusercontent.com/u/46725619?v=4)](https://github.com/stefvanesch "stefvanesch (1 commits)")

---

Tags

laravelMetricsdashboardcardfiltersnova

### Embed Badge

![Health badge](/badges/marshmallow-nova-global-filter/health.svg)

```
[![Health](https://phpackages.com/badges/marshmallow-nova-global-filter/health.svg)](https://phpackages.com/packages/marshmallow-nova-global-filter)
```

###  Alternatives

[digital-creative/nova-dashboard

The missing dashboard for nova.

7169.3k1](/packages/digital-creative-nova-dashboard)[jubeki/nova-card-linkable

A Linkeable Card for the Laravel Nova Dashboard.

19246.1k](/packages/jubeki-nova-card-linkable)[square1/nova-metrics

Add support for resource-filters on your laravel nova metrics

27278.7k](/packages/square1-nova-metrics)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
