A Filament plugin that adds an app overview widget to your admin panel.
You can install the package via composer:
composer require awcodes/overlook
Then add the widget to your dashboard class or the Filament config file.
'widgets' => [
'namespace' => 'App\\Filament\\Widgets',
'path' => app_path('Filament/Widgets'),
'register' => [
\Awcodes\Overlook\Overlook::class,
...
],
],
By default, Overlook will display any resource registered with Filament, while still honoring the canViewAny
policy. This can be undesired and also slow down the dashboard. To prevent this behavior publish the config file with:
php artisan vendor:publish --tag="overlook-config"
Inside the config you will have options to either "include" or "exclude" resources from being displayed. These are not meant to work together, you should use one of the other.
You can also choose to convert the count to a human-readable format. For example, 1000 will be converted to 1k. This is the default behavior.
Converted counts will also have a tooltip that displays the full count. This can be disabled by setting enable_convert_tooltip
to false.
return [
'includes' => [
App\Filament\Resources\Blog\AuthorResource::class,
App\Filament\Resources\Blog\CategoryResource::class,
App\Filament\Resources\Blog\PostResource::class,
],
'excludes' => [
// App\Filament\Resources\Blog\AuthorResource::class,
],
'should_convert_count' => true,
'enable_convert_tooltip' => true,
];
Should you need to reorder the location of the widget or want to enable polling, you can make your own version of the Overlook widget and register it instead.
namespace App\Filament\Widgets;
use Awcodes\Overlook\Overlook;
class CustomOverlookWidget extends Overlook
{
protected static ?int $sort = 10;
protected static ?string $pollingInterval = '10s';
}
Please see CHANGELOG for more information on what has changed recently.
Please see CONTRIBUTING for details.
Please review our security policy on how to report security vulnerabilities.
The MIT License (MIT). Please see License File for more information.