Add email notifications and grant UI for all Filament resources

simonhamp · claude · simonhamp · commit 61d436adfe21 · 2026-03-20T22:23:18.000Z
- Add PluginGranted and BundleGranted notifications with markdown templates
- Add "Grant to User" action to PluginResource index page
- Send email notifications from all Filament grant actions
- Use Blade markdown templates for proper button and link rendering

Co-Authored-By: Claude Opus 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/app/Filament/Resources/PluginBundleResource.php b/app/Filament/Resources/PluginBundleResource.php
@@ -9,6 +9,7 @@
 use App\Models\PluginBundle;
 use App\Models\PluginLicense;
 use App\Models\User;
+use App\Notifications\BundleGranted;
 use Filament\Forms;
 use Filament\Forms\Form;
 use Filament\Notifications\Notification;
@@ -190,7 +191,7 @@ public static function table(Table $table): Table
                             $user = User::findOrFail($data['user_id']);
                             $record->loadMissing('plugins');
 
-                            $grantedCount = 0;
+                            $grantedPlugins = collect();
 
                             foreach ($record->plugins as $plugin) {
                                 $existingLicense = $user->pluginLicenses()
@@ -211,13 +212,17 @@ public static function table(Table $table): Table
                                     'purchased_at' => now(),
                                 ]);
 
-                                $grantedCount++;
+                                $grantedPlugins->push($plugin);
                             }
 
                             $user->getPluginLicenseKey();
 
+                            if ($grantedPlugins->isNotEmpty()) {
+                                $user->notify(new BundleGranted($record, $grantedPlugins));
+                            }
+
                             Notification::make()
-                                ->title("Granted {$grantedCount} plugin license(s) to {$user->name}")
+                                ->title("Granted {$grantedPlugins->count()} plugin license(s) to {$user->name}")
                                 ->success()
                                 ->send();
                         })
diff --git a/app/Filament/Resources/PluginResource.php b/app/Filament/Resources/PluginResource.php
@@ -10,6 +10,9 @@
 use App\Jobs\ReviewPluginRepository;
 use App\Jobs\SyncPlugin;
 use App\Models\Plugin;
+use App\Models\PluginLicense;
+use App\Models\User;
+use App\Notifications\PluginGranted;
 use App\Notifications\PluginReviewChecksIncomplete;
 use Filament\Forms;
 use Filament\Forms\Form;
@@ -272,6 +275,62 @@ public static function table(Table $table): Table
                                 ->send();
                         }),
 
+                    Tables\Actions\Action::make('grantToUser')
+                        ->label('Grant to User')
+                        ->icon('heroicon-o-gift')
+                        ->color('success')
+                        ->form([
+                            Forms\Components\Select::make('user_id')
+                                ->label('User')
+                                ->searchable()
+                                ->getSearchResultsUsing(function (string $search): array {
+                                    return User::query()
+                                        ->where('name', 'like', "%{$search}%")
+                                        ->orWhere('email', 'like', "%{$search}%")
+                                        ->limit(50)
+                                        ->get()
+                                        ->mapWithKeys(fn (User $user) => [$user->id => "{$user->name} ({$user->email})"])
+                                        ->toArray();
+                                })
+                                ->required(),
+                        ])
+                        ->action(function (Plugin $record, array $data): void {
+                            $user = User::findOrFail($data['user_id']);
+
+                            $existingLicense = $user->pluginLicenses()
+                                ->where('plugin_id', $record->id)
+                                ->exists();
+
+                            if ($existingLicense) {
+                                Notification::make()
+                                    ->title('User already has a license for this plugin')
+                                    ->warning()
+                                    ->send();
+
+                                return;
+                            }
+
+                            PluginLicense::create([
+                                'user_id' => $user->id,
+                                'plugin_id' => $record->id,
+                                'price_paid' => 0,
+                                'currency' => 'USD',
+                                'is_grandfathered' => true,
+                                'purchased_at' => now(),
+                            ]);
+
+                            $user->getPluginLicenseKey();
+                            $user->notify(new PluginGranted($record));
+
+                            Notification::make()
+                                ->title("Granted '{$record->name}' license to {$user->name}")
+                                ->success()
+                                ->send();
+                        })
+                        ->modalHeading('Grant Plugin to User')
+                        ->modalDescription(fn (Plugin $record): string => "Grant '{$record->name}' to a user for free.")
+                        ->modalSubmitActionLabel('Grant'),
+
                     Tables\Actions\Action::make('runReviewChecks')
                         ->label('Run Review Checks')
                         ->icon('heroicon-o-clipboard-document-check')
diff --git a/app/Filament/Resources/PluginResource/Pages/EditPlugin.php b/app/Filament/Resources/PluginResource/Pages/EditPlugin.php
@@ -10,6 +10,7 @@
 use App\Jobs\SyncPluginReleases;
 use App\Models\PluginLicense;
 use App\Models\User;
+use App\Notifications\PluginGranted;
 use Filament\Actions;
 use Filament\Forms;
 use Filament\Notifications\Notification;
@@ -143,6 +144,7 @@ protected function getHeaderActions(): array
                         ]);
 
                         $user->getPluginLicenseKey();
+                        $user->notify(new PluginGranted($this->record));
 
                         Notification::make()
                             ->title("Granted '{$this->record->name}' license to {$user->name}")
diff --git a/app/Filament/Resources/ProductResource.php b/app/Filament/Resources/ProductResource.php
@@ -7,6 +7,7 @@
 use App\Models\Product;
 use App\Models\ProductLicense;
 use App\Models\User;
+use App\Notifications\ProductGranted;
 use Filament\Forms;
 use Filament\Forms\Form;
 use Filament\Notifications\Notification;
@@ -197,6 +198,8 @@ public static function table(Table $table): Table
                                 'purchased_at' => now(),
                             ]);
 
+                            $user->notify(new ProductGranted($record));
+
                             Notification::make()
                                 ->title("Granted {$record->name} to {$user->name}")
                                 ->success()
diff --git a/app/Notifications/BundleGranted.php b/app/Notifications/BundleGranted.php
@@ -0,0 +1,60 @@
+<?php
+
+namespace App\Notifications;
+
+use App\Models\PluginBundle;
+use Illuminate\Bus\Queueable;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Notifications\Messages\MailMessage;
+use Illuminate\Notifications\Notification;
+use Illuminate\Support\Collection;
+
+class BundleGranted extends Notification implements ShouldQueue
+{
+    use Queueable;
+
+    /**
+     * @param  Collection<int, \App\Models\Plugin>  $grantedPlugins
+     */
+    public function __construct(
+        public PluginBundle $bundle,
+        public Collection $grantedPlugins,
+    ) {}
+
+    /**
+     * @return array<int, string>
+     */
+    public function via(object $notifiable): array
+    {
+        return ['mail'];
+    }
+
+    public function toMail(object $notifiable): MailMessage
+    {
+        $pluginUrls = $this->grantedPlugins->mapWithKeys(function ($plugin) {
+            $params = $plugin->routeParams();
+
+            return [$plugin->id => "https://nativephp.com/plugins/{$params['vendor']}/{$params['package']}"];
+        })->toArray();
+
+        return (new MailMessage)
+            ->subject("You've been granted the {$this->bundle->name} bundle!")
+            ->markdown('mail.bundle-granted', [
+                'bundle' => $this->bundle,
+                'grantedPlugins' => $this->grantedPlugins,
+                'pluginUrls' => $pluginUrls,
+            ]);
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function toArray(object $notifiable): array
+    {
+        return [
+            'bundle_id' => $this->bundle->id,
+            'bundle_name' => $this->bundle->name,
+            'granted_plugin_ids' => $this->grantedPlugins->pluck('id')->toArray(),
+        ];
+    }
+}
diff --git a/app/Notifications/PluginGranted.php b/app/Notifications/PluginGranted.php
@@ -0,0 +1,53 @@
+<?php
+
+namespace App\Notifications;
+
+use App\Models\Plugin;
+use Illuminate\Bus\Queueable;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Notifications\Messages\MailMessage;
+use Illuminate\Notifications\Notification;
+
+class PluginGranted extends Notification implements ShouldQueue
+{
+    use Queueable;
+
+    public function __construct(
+        public Plugin $plugin,
+    ) {}
+
+    /**
+     * @return array<int, string>
+     */
+    public function via(object $notifiable): array
+    {
+        return ['mail'];
+    }
+
+    public function toMail(object $notifiable): MailMessage
+    {
+        $parts = explode('/', $this->plugin->name ?? '');
+        $vendor = $parts[0] ?? '';
+        $package = $parts[1] ?? '';
+
+        $pluginUrl = "https://nativephp.com/plugins/{$vendor}/{$package}";
+
+        return (new MailMessage)
+            ->subject("You've been granted access to {$this->plugin->name}!")
+            ->greeting('Great news!')
+            ->line("You've been granted access to **{$this->plugin->name}**.")
+            ->action('Check it out', $pluginUrl)
+            ->line('Thank you for being a NativePHP customer!');
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function toArray(object $notifiable): array
+    {
+        return [
+            'plugin_id' => $this->plugin->id,
+            'plugin_name' => $this->plugin->name,
+        ];
+    }
+}
diff --git a/app/Notifications/ProductGranted.php b/app/Notifications/ProductGranted.php
@@ -28,9 +28,10 @@ public function toMail(object $notifiable): MailMessage
     {
         return (new MailMessage)
             ->subject("You've been granted access to {$this->product->name}!")
-            ->greeting('Great news!')
-            ->line("You've been granted access to **{$this->product->name}**.")
-            ->line('Thank you for being a NativePHP customer!');
+            ->markdown('mail.product-granted', [
+                'product' => $this->product,
+                'url' => route('products.show', $this->product),
+            ]);
     }
 
     /**
diff --git a/resources/views/mail/bundle-granted.blade.php b/resources/views/mail/bundle-granted.blade.php
@@ -0,0 +1,11 @@
+<x-mail::message>
+# Great news!
+
+You've been granted access to the **{{ $bundle->name }}** bundle, which includes the following plugins:
+
+@foreach ($grantedPlugins as $plugin)
+- [{{ $plugin->name }}]({{ $pluginUrls[$plugin->id] }})
+@endforeach
+
+Thank you for being a NativePHP customer!
+</x-mail::message>
diff --git a/resources/views/mail/product-granted.blade.php b/resources/views/mail/product-granted.blade.php
@@ -0,0 +1,11 @@
+<x-mail::message>
+# Great news!
+
+You've been granted access to **{{ $product->name }}**.
+
+<x-mail::button :url="$url">
+Check it out
+</x-mail::button>
+
+Thank you for being a NativePHP customer!
+</x-mail::message>

Original file line number	Diff line number	Diff line change
`@@ -28,9 +28,10 @@ public function toMail(object $notifiable): MailMessage`
`28`	`28`	`{`
`29`	`29`	`return (new MailMessage)`
`30`	`30`	`->subject("You've been granted access to {$this->product->name}!")`
`31`		`- ->greeting('Great news!')`
`32`		`- ->line("You've been granted access to {$this->product->name}.")`
`33`		`- ->line('Thank you for being a NativePHP customer!');`
	`31`	`+ ->markdown('mail.product-granted', [`
	`32`	`+ 'product' => $this->product,`
	`33`	`+ 'url' => route('products.show', $this->product),`
	`34`	`+ ]);`
`34`	`35`	`}`
`35`	`36`
`36`	`37`	`/**`