👀 See who's viewing a resource in Filament PHP ðŸ”
This package allows you to display when other users are viewing the same resource in Filament PHP.
https://packagist.org/packages/discoverydesign/filament-gaze
composer require discoverydesign/filament-gaze
\DiscoveryDesign\FilamentGaze\FilamentGazePlugin::make()
to your Filament Panel provider.$panel->plugins([ \DiscoveryDesign\FilamentGaze\FilamentGazePlugin::make()])
php artisan filament:assets
.use DiscoveryDesign\FilamentGaze\Forms\Components\GazeBanner
.GazeBanner
form component to your form with GazeBanner::make()
.php artisan vendor:publish --tag=filament-gaze-translations
.<?php namespace App\Filament\Resources; use DiscoveryDesign\FilamentGaze\Forms\Components\GazeBanner;// ... class OrderResource extends Resource{ // ... public static function form(Form $form): Form { return $form ->schema([ GazeBanner::make(), // ... ]); } // ...}
GazeBanner::make() ->pollTimer(10),
GazeBanner::make() ->identifier('any-order'),
GazeBanner::make() ->lock()
GazeBanner::make() ->lock() ->canTakeControl(fn() => auth()->user()->isAdmin())
GazeBanner::make() ->hidden(fn (?Order $record) => $record === null),
There is also a helper function
GazeBanner::make() ->hideOnCreate(),
->pollTimer($timeInSecs)
polltimer
can be used to set how often the browser should inform Filament that the user is still viewing the page, along with getting an updated list of other users also viewing. It is advised not to put this value too short, as it can cause rate limiting issues. But also not to have this value too long, as it will result in a delayed update of new users viewing the page.
timeInSeconds
- (int) The amount of time in seconds between each poll. Default is 30 seconds.
->identifier($fnc)
identifier
is used as a unique identifier for this gaze banner. Any other gaze banners with the same identifier will share the same list of active users. This can be useful if you want 2 or more difference resources to share the same list of active viewing users.
fnc
- (optional, closure | string) The name of the identifier. Default is the resource's model class combines with model Id.
->lock($fnc)
lock
can be used to lock the resource for anyone but the current person editing the form. This can be useful if you want to prevent multiple people from editing the same resource at the same time. The designated controller is the first person to access the resource, or the person who has taken control of the resource. If you enable this after recently accessing a resource, you may need to run php artisan cache:clear
as it is possible that the current cached viewers don't have a marked controller (This is only an issue for development).
fnc
- (optional, closure | bool) If the resource is lockable or not.
->canTakeControl($fnc)
canTakeControl
can be used to allow the user to take control of the resource if it is locked by someone else. This can be useful if you want to allow the user to take control of the resource.
fnc
- (optional, closure | bool) If the user can take control of the resource. Default is true. If a closure is passed, it should return a bool.
->hideOnCreate()
hideOnCreate
is a helper function that can be used to hide the banner on create forms.
To customize the icons in the banner, you may use the following aliases:
filament-gaze::banner.locked
for the lock iconfilament-gaze::banner.view
for the eye icon🚀 Discovery Design