PHPackages zynqa/filament-notifications - 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. zynqa/filament-notifications ActiveLibrary[Admin Panels](/categories/admin) zynqa/filament-notifications ============================ Admin notification management system for FilamentPHP 0.3.0(3w ago)058MITPHPPHP ^8.2 Since Feb 16Pushed 3w agoCompare [ Source](https://github.com/zynqa/filament-notifications)[ Packagist](https://packagist.org/packages/zynqa/filament-notifications)[ RSS](/packages/zynqa-filament-notifications/feed)WikiDiscussions main Synced today READMEChangelog (3)Dependencies (9)Versions (6)Used By (0) Filament Notifications ====================== [](#filament-notifications) [![Latest Version on Packagist](https://camo.githubusercontent.com/f41e7fc328fe5ac7d42ec2938ef11d8f15b089b022ee5f9e3db522584d0561b0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7a796e71612f66696c616d656e742d6e6f74696669636174696f6e732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/zynqa/filament-notifications)[![Total Downloads](https://camo.githubusercontent.com/3a996b8bb74743749ee21ea9f387909ee9dcc90ee3477e53ccc1b21c5c95bc16/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7a796e71612f66696c616d656e742d6e6f74696669636174696f6e732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/zynqa/filament-notifications) A FilamentPHP v3 package for creating and managing custom notifications sent to users through your admin panel. Send database and email notifications with read tracking, customizable templates, and full Shield integration. Features -------- [](#features) - **Database & Email Delivery** - Send notifications via database (notification bell) or email - **Custom Email Templates** - Create and manage custom email templates with full Blade support - **Draft & Send Workflow** - Save as draft, review, then send when ready - **Read Tracking** - Track which users have read each notification - **Multi-User Selection** - Send to one or multiple users at once - **Customizable Appearance** - Choose from 13+ heroicons and colors - **Shield Integration** - Full permission system integration - **Soft Deletes** - Complete audit trail with soft delete support Requirements ------------ [](#requirements) - PHP 8.2+ - Laravel 11.0+ - FilamentPHP 3.2+ Installation ------------ [](#installation) ### 1. Install via Composer [](#1-install-via-composer) ``` composer require zynqa/filament-notifications ``` ### 2. Run Migrations [](#2-run-migrations) ``` php artisan migrate ``` This creates: - `admin_notifications` - Notification content and metadata - `notification_recipients` - Recipient tracking with read status - `notification_settings` - Email template preferences ### 3. Register Plugin [](#3-register-plugin) Add to your Filament Panel Provider (e.g., `app/Providers/Filament/AppPanelProvider.php`): ``` use Zynqa\FilamentNotifications\FilamentNotificationsPlugin; public function panel(Panel $panel): Panel { return $panel ->plugins([ FilamentNotificationsPlugin::make(), ]) ->databaseNotifications(); // Required for notification bell } ``` ### 4. Add User Model Relationships [](#4-add-user-model-relationships) Add to `app/Models/User.php`: ``` use Zynqa\FilamentNotifications\Models\AdminNotification; public function adminNotifications(): \Illuminate\Database\Eloquent\Relations\BelongsToMany { return $this->belongsToMany(AdminNotification::class, 'notification_recipients') ->withPivot('read_at') ->withTimestamps() ->orderByPivot('created_at', 'desc'); } public function unreadAdminNotifications(): \Illuminate\Database\Eloquent\Relations\BelongsToMany { return $this->adminNotifications()->wherePivotNull('read_at'); } ``` ### 5. Configure Permissions (Optional) [](#5-configure-permissions-optional) If using Filament Shield: ``` php artisan shield:generate --all ``` Then assign `admin::notification` permissions to roles via the Shield UI. Usage ----- [](#usage) ### Creating and Sending Notifications [](#creating-and-sending-notifications) 1. Navigate to **Notifications** in your admin panel 2. Click **Create** 3. Fill in the form: - **Title** - Brief headline - **Body** - Detailed message - **Delivery Method** - Database (bell) or Email & Database - **Type** - Info, Success, Warning, or Danger - **Icon** & **Color** - Choose from available options - **Recipients** - Select one or more users 4. Click **Create** (saves as draft) 5. Review and click **Send Notification** Recipients will see the notification in their notification bell (database) or receive an email, depending on the delivery method selected. ### Email Templates [](#email-templates) #### Using Existing Templates [](#using-existing-templates) 1. Navigate to **Settings** → **General Settings** 2. Scroll to **Notification Settings** 3. Select your preferred template from the dropdown 4. Click **Save** #### Creating Custom Templates [](#creating-custom-templates) Email templates are stored in `storage/app/mail-templates/` and are automatically discovered. **Step 1:** Create a new Blade file in `storage/app/mail-templates/` Example: `storage/app/mail-templates/urgent-alert.blade.php` **Step 2:** Use the available variables in your template: ``` {{ $title }} body { font-family: Arial, sans-serif; } .container { max-width: 600px; margin: 0 auto; padding: 20px; } .alert { background-color: {{ $notification_type === 'danger' ? '#fee' : '#efe' }}; padding: 20px; border-radius: 8px; } {{ $title }} {!! nl2br(e($body)) !!} @if($url) View Details @endif {{ config('app.name') }} ``` **Available Variables:** - `$title` (string) - Notification title - `$body` (string) - Notification body text - `$url` (string|null) - Optional action URL - `$notification_type` (string) - 'info', 'success', 'warning', or 'danger' - `$icon` (string) - Heroicon name (e.g., 'heroicon-o-bell') - `$icon_color` (string) - 'primary', 'success', 'warning', 'danger', 'info', or 'gray' **Step 3:** Save the file The template will automatically appear in the General Settings dropdown with a formatted name (e.g., "Urgent Alert"). **Tips:** - Use inline CSS for best email client compatibility - Always escape user content with `e()` or `{!! nl2br(e($body)) !!}` - Test across different email clients - Keep designs simple and mobile-friendly Configuration ------------- [](#configuration) Optionally publish the config file: ``` php artisan vendor:publish --tag="filament-notifications-config" ``` Customize navigation, permissions, and icons in `config/filament-notifications.php`. Permissions ----------- [](#permissions) When using Filament Shield, these permissions are created: - `view_any_admin::notification` - View notifications list - `view_admin::notification` - View individual notification - `create_admin::notification` - Create new notifications - `update_admin::notification` - Edit drafts - `delete_admin::notification` - Delete drafts - `restore_admin::notification` - Restore soft-deleted notifications - `force_delete_admin::notification` - Permanently delete notifications **Note:** Sent notifications are read-only and cannot be edited or deleted. Support ------- [](#support) - **Issues:** [GitHub Issues](https://github.com/zynqa/filament-notifications/issues) - **Email:** License ------- [](#license) MIT License. See [LICENSE.md](../LICENSE.md) for details. ### Health Score 40 — FairBetter than 86% of packages Maintenance95 Actively maintained with recent releases Popularity11 Limited adoption so far Community6 Small or concentrated contributor base Maturity41 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% 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 ~38 days Total 4 Last Release 21d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/1080386?v=4)[Raul Watson](/maintainers/diazwatson)[@diazwatson](https://github.com/diazwatson) --- Top Contributors [![diazwatson](https://avatars.githubusercontent.com/u/1080386?v=4)](https://github.com/diazwatson "diazwatson (8 commits)") ### Embed Badge ![Health badge](/badges/zynqa-filament-notifications/health.svg) ``` [![Health](https://phpackages.com/badges/zynqa-filament-notifications/health.svg)](https://phpackages.com/packages/zynqa-filament-notifications) ``` ### Alternatives [bezhansalleh/filament-exceptions A Simple & Beautiful Pluggable Exception Viewer for FilamentPHP's Admin Panel 196223.8k15](/packages/bezhansalleh-filament-exceptions)[rawilk/profile-filament-plugin Profile & MFA starter kit for filament. 3914.6k](/packages/rawilk-profile-filament-plugin)[harris21/laravel-fuse Circuit breaker for Laravel queue jobs. Protect your workers from cascading failures. 44855.7k](/packages/harris21-laravel-fuse)[backstage/mails View logged mails and events in a beautiful Filament UI. 16120.0k](/packages/backstage-mails)[mradder/filament-logger Audit logging, activity tracking, exports, alerts, and dashboards for Filament admin panels. 2317.1k](/packages/mradder-filament-logger)[a2insights/filament-saas Filament Saas for A2Insights 171.7k](/packages/a2insights-filament-saas) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)