PHPackages rupadana/filament-announce - 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. [Utility & Helpers](/categories/utility) 4. / 5. rupadana/filament-announce ActiveLibrary[Utility & Helpers](/categories/utility) rupadana/filament-announce ========================== An easy way to shout your exceptional offerings to the potential users 3.2.6(1y ago)5712.4k↓37.5%17[5 PRs](https://github.com/rupadana/filament-announce/pulls)1MITPHPPHP ^8.1CI passing Since Jan 28Pushed 2mo ago1 watchersCompare [ Source](https://github.com/rupadana/filament-announce)[ Packagist](https://packagist.org/packages/rupadana/filament-announce)[ Docs](https://github.com/rupadana/filament-announce)[ GitHub Sponsors](https://github.com/rupadana)[ RSS](/packages/rupadana-filament-announce/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (10)Versions (22)Used By (1) Filament Announce ================= [](#filament-announce) [![Latest Version on Packagist](https://camo.githubusercontent.com/f8ce7c4a86e86a65a7da4befe5282dc55d83d385c010edcb7f44254fd8f39e87/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7275706164616e612f66696c616d656e742d616e6e6f756e63652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/rupadana/filament-announce)[![GitHub Tests Action Status](https://camo.githubusercontent.com/bf0937748166543cdbf927359a12bfb6410ec430812abc00c45630fb47aba96d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f7275706164616e612f66696c616d656e742d616e6e6f756e63652f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/rupadana/filament-announce/actions?query=workflow%3Arun-tests+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/9e693f92961ae3c0f511622d20a4043dce42da014d1c1331f940c29e9429629f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7275706164616e612f66696c616d656e742d616e6e6f756e63652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/rupadana/filament-announce) The easiest way to shout announcements in filament! [![](https://camo.githubusercontent.com/11b69be0193c252162c231553a5a3b2b7a5118abbe3a009568be6510412413db/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f7275706164616e612f696d6167652f75706c6f61642f76313730363130303136332f53637265656e73686f745f323032342d30312d32345f61745f32302e31342e34335f666f637868662e706e67)](https://camo.githubusercontent.com/11b69be0193c252162c231553a5a3b2b7a5118abbe3a009568be6510412413db/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f7275706164616e612f696d6167652f75706c6f61642f76313730363130303136332f53637265656e73686f745f323032342d30312d32345f61745f32302e31342e34335f666f637868662e706e67) Installation ------------ [](#installation) You can install the package via composer: ``` composer require rupadana/filament-announce ``` ``` # Laravel 11 and higher php artisan make:notifications-table # Laravel 10 php artisan notifications:table ``` Run migration ``` php artisan migrate ``` Optionally, you can publish the views using ``` php artisan vendor:publish --tag="filament-announce-views" ``` publish config ``` php artisan vendor:publish --tag="filament-announce-config" ``` ``` return [ 'navigation' => [ 'group' => '', 'sort' => 1 ], 'can_access' => [ 'role' => ['super_admin'] ] ]; ``` Usage ----- [](#usage) You must enable Announce by adding `FilamentAnnouncePlugin` class to your Filament Panel's plugin() or plugins(\[\]) method: ``` use Rupadana\FilamentAnnounce\FilamentAnnouncePlugin; use Filament\Support\Colors\Color; class CustomersPanelProvider extends PanelProvider { public function panel(Panel $panel): Panel { return $panel ... ->plugin( FilamentAnnouncePlugin::make() ->pollingInterval('30s') // optional, by default it is set to null ->defaultColor(Color::Blue) // optional, by default it is set to "primary" ) } } ``` To override the plugins announcementResource with your own custom resource, you should append `usingResource` method when registering the plugin: ``` use Rupadana\FilamentAnnounce\FilamentAnnouncePlugin; use Filament\Support\Colors\Color; class CustomersPanelProvider extends PanelProvider { public function panel(Panel $panel): Panel { return $panel ... ->plugin( FilamentAnnouncePlugin::make() ->usingResource(MyCustomAnnouncementResource::class) ->pollingInterval('30s') // optional, by default it is set to null ->defaultColor(Color::Blue) // optional, by default it is set to "primary" ) } } ``` Now you can announce whatever to users: ``` use App\Models\User; use Rupadana\FilamentAnnounce\Announce; Announce::make() ->title('Big News!') ->icon('heroicon-o-megaphone') ->body('Filament can now show very important message to specific users!') ->disableCloseButton() // Optional, if you want ur announcement discloseable ->announceTo(User::all()); ``` Title and Body Alignment ------------------------ [](#title-and-body-alignment) By default, the alignments will be `start` and you might want to adjust them: ``` use App\Models\User; use Filament\Support\Enums\Alignment; use Rupadana\FilamentAnnounce\Announce; Announce::make() ->title('Big News!') ->icon('heroicon-o-megaphone') ->body('Filament can now show very important message to specific users!') ->alignment(Alignment::Center) // this will set both title and body alignments (common alignment) ->titleAlignment(Alignment::Start) // this will set title alignment and take precedence over common alignment methods ->bodyAlignment(Alignment::Start) // this will set body alignment and take precedence over common alignment methods ->actions([ Action::make('view') ->button(), Action::make('undo') ->color('gray'), ]) ->announceTo(User::all()); ``` You can also use `alignStart()`, `alignCenter()`, `alignEnd()`, `alignJustify()`, `alignBetween()`, `alignLeft()` and `alignRight()` for your convenience. Add Actions to Announce ----------------------- [](#add-actions-to-announce) [![](https://private-user-images.githubusercontent.com/26832856/300244433-61677a79-9706-41c4-be86-19173484f943.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MDY0Mzc3MzEsIm5iZiI6MTcwNjQzNzQzMSwicGF0aCI6Ii8yNjgzMjg1Ni8zMDAyNDQ0MzMtNjE2NzdhNzktOTcwNi00MWM0LWJlODYtMTkxNzM0ODRmOTQzLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDAxMjglMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwMTI4VDEwMjM1MVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWU2NTRjZjIyYjA3NjcwMDExODJjZTJjYzQwMTVmMDU2OTk4YWM0N2EyMWY4MjI1MjA4MmNmZmQzNTE2NWU2ZjImWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.x16B1wDTY2klrlWWdeWo6LK3O82E3_3i89uetbiRYl4)](https://private-user-images.githubusercontent.com/26832856/300244433-61677a79-9706-41c4-be86-19173484f943.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MDY0Mzc3MzEsIm5iZiI6MTcwNjQzNzQzMSwicGF0aCI6Ii8yNjgzMjg1Ni8zMDAyNDQ0MzMtNjE2NzdhNzktOTcwNi00MWM0LWJlODYtMTkxNzM0ODRmOTQzLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDAxMjglMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwMTI4VDEwMjM1MVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWU2NTRjZjIyYjA3NjcwMDExODJjZTJjYzQwMTVmMDU2OTk4YWM0N2EyMWY4MjI1MjA4MmNmZmQzNTE2NWU2ZjImWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.x16B1wDTY2klrlWWdeWo6LK3O82E3_3i89uetbiRYl4) Since Announce extends Filament Notification, you can add Filament Notification Actions to your announcements: ``` use App\Models\User; use Rupadana\FilamentAnnounce\Announce; Announce::make() ->title('Big News!') ->icon('heroicon-o-megaphone') ->body('Filament can now show very important message to specific users!') ->actions([ Action::make('view') ->button(), Action::make('undo') ->color('gray'), ]) ->announceTo(User::all()); ``` Read more about [Notification Action](https://filamentphp.com/docs/3.x/notifications/sending-notifications#adding-actions-to-notifications). Announcement Resource --------------------- [](#announcement-resource) [![](https://private-user-images.githubusercontent.com/34137674/300265322-af4e43a3-0093-49ab-b493-504d7607fb2b.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzQ3MzQ5MzAsIm5iZiI6MTc3NDczNDYzMCwicGF0aCI6Ii8zNDEzNzY3NC8zMDAyNjUzMjItYWY0ZTQzYTMtMDA5My00OWFiLWI0OTMtNTA0ZDc2MDdmYjJiLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjAzMjglMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwMzI4VDIxNTAzMFomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTdkYmQ0ZmMyNzZjNTgxNTI2NTYyZDJlYTg3MGI2MDRmNWMwYTVhNTAwYjI1ZmFmZjY1OWFjOThiYjYxYzNjNGYmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.dOQYYBHCawNKkKuigCTMlIselmPQl9Z74puzzjrghi0)](https://private-user-images.githubusercontent.com/34137674/300265322-af4e43a3-0093-49ab-b493-504d7607fb2b.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzQ3MzQ5MzAsIm5iZiI6MTc3NDczNDYzMCwicGF0aCI6Ii8zNDEzNzY3NC8zMDAyNjUzMjItYWY0ZTQzYTMtMDA5My00OWFiLWI0OTMtNTA0ZDc2MDdmYjJiLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjAzMjglMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwMzI4VDIxNTAzMFomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTdkYmQ0ZmMyNzZjNTgxNTI2NTYyZDJlYTg3MGI2MDRmNWMwYTVhNTAwYjI1ZmFmZjY1OWFjOThiYjYxYzNjNGYmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.dOQYYBHCawNKkKuigCTMlIselmPQl9Z74puzzjrghi0) Todo ---- [](#todo) - Can add actions to every announcement - Provide a resource/action to send announcement - Add banner-like implementations for global announcement - Set end date or time so it will disapear automaticly Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](../../security/policy) on how to report security vulnerabilities. Credits ------- [](#credits) - [Rupadana](https://github.com/rupadana) - [margarizaldi](https://github.com/margarizaldi) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 50 — FairBetter than 96% of packages Maintenance68 Regular maintenance activity Popularity39 Limited adoption so far Community22 Small or concentrated contributor base Maturity60 Established project with proven stability Bus Factor1 Top contributor holds 62.4% 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 ~30 days Recently: every ~86 days Total 14 Last Release 445d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/29f8343484c8567d8f24dcf1e4fb4978f2ac8442e90448c6405a32ba511ee246?d=identicon)[rupadana](/maintainers/rupadana) --- Top Contributors [![rupadana](https://avatars.githubusercontent.com/u/34137674?v=4)](https://github.com/rupadana "rupadana (68 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (13 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (11 commits)")[![margarizaldi](https://avatars.githubusercontent.com/u/26832856?v=4)](https://github.com/margarizaldi "margarizaldi (8 commits)")[![CharlieEtienne](https://avatars.githubusercontent.com/u/9772943?v=4)](https://github.com/CharlieEtienne "CharlieEtienne (3 commits)")[![NicholasMartens](https://avatars.githubusercontent.com/u/92103611?v=4)](https://github.com/NicholasMartens "NicholasMartens (2 commits)")[![ziming](https://avatars.githubusercontent.com/u/679513?v=4)](https://github.com/ziming "ziming (1 commits)")[![hussain4real](https://avatars.githubusercontent.com/u/45605752?v=4)](https://github.com/hussain4real "hussain4real (1 commits)")[![marcogermani87](https://avatars.githubusercontent.com/u/998645?v=4)](https://github.com/marcogermani87 "marcogermani87 (1 commits)")[![cenksen](https://avatars.githubusercontent.com/u/14984639?v=4)](https://github.com/cenksen "cenksen (1 commits)") --- Tags laravelfilamentfilamentphprupadanafilament-announce ### Code Quality TestsPest ### Embed Badge ![Health badge](/badges/rupadana-filament-announce/health.svg) ``` [![Health](https://phpackages.com/badges/rupadana-filament-announce/health.svg)](https://phpackages.com/packages/rupadana-filament-announce) ``` ### Alternatives [dotswan/filament-map-picker Easily pick and retrieve geo-coordinates using a map-based interface in your Filament applications. 124139.3k2](/packages/dotswan-filament-map-picker)[pboivin/filament-peek Full-screen page preview modal for Filament 253319.6k12](/packages/pboivin-filament-peek)[creagia/filament-code-field A Filamentphp input field to edit or view code data. 58289.3k3](/packages/creagia-filament-code-field)[jibaymcs/filament-tour Bring the power of DriverJs to your Filament panels and start a tour ! 12247.8k](/packages/jibaymcs-filament-tour)[swisnl/filament-backgrounds Beautiful backgrounds for Filament auth pages 54149.2k6](/packages/swisnl-filament-backgrounds)[tapp/filament-google-autocomplete-field Filament plugin that provides a Google Autocomplete field 3098.1k](/packages/tapp-filament-google-autocomplete-field) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)