PHPackages backstage/announcements - 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. backstage/announcements ActiveLibrary[Utility & Helpers](/categories/utility) backstage/announcements ======================= This is my package backstage-announcements v4.0.1(1mo ago)15[2 PRs](https://github.com/backstagephp/announcements/pulls)MITPHPPHP ^8.3CI passing Since Oct 6Pushed 1mo agoCompare [ Source](https://github.com/backstagephp/announcements)[ Packagist](https://packagist.org/packages/backstage/announcements)[ Docs](https://github.com/backstagephp/announcements)[ GitHub Sponsors](https://github.com/Backstage)[ RSS](/packages/backstage-announcements/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (29)Versions (250)Used By (0) Backstage Announcements ======================= [](#backstage-announcements) [![Latest Version on Packagist](https://camo.githubusercontent.com/9b6508b098fe9bfe7534e41c4a6e6f48cba17771adaebadd5662eeb5ad2c9513/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6261636b73746167652f6261636b73746167652d616e6e6f756e63656d656e74732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/backstage/backstage-announcements)[![GitHub Tests Action Status](https://camo.githubusercontent.com/9f1355eb1eab7bc4711e2fb1845be6ba4d2df424dc0ea22f6674ce0bb8bd431e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6261636b73746167652f6261636b73746167652d616e6e6f756e63656d656e74732f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/backstage/backstage-announcements/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/e78930ea7e0901dcf336437aee304e7cd1117dc117afc50b4cda9d157e1e799b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6261636b73746167652f6261636b73746167652d616e6e6f756e63656d656e74732f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/backstage/backstage-announcements/actions?query=workflow%3A%22Fix+PHP+code+styling%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/9ed59314fce5f2a587d7775e43e782a3309e1622e7ee9748eb44d85af40706b8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6261636b73746167652f6261636b73746167652d616e6e6f756e63656d656e74732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/backstage/backstage-announcements) A powerful Filament plugin for managing announcements in your Laravel application. Create, manage, and display announcements with customizable scopes, colors, and navigation controls. Installation ------------ [](#installation) You can install the package via composer: ``` composer require backstage/announcements ``` Important If you have not set up a custom theme and are using Filament Panels follow the instructions in the [Filament Docs](https://filamentphp.com/docs/4.x/styling/overview#creating-a-custom-theme) first. After setting up a custom theme add the plugin's views to your theme css file or your app's css file if using the standalone packages. ``` @source '../../../../vendor/backstage/announcements/resources/**/*.blade.php'; ``` You can publish and run the migrations with: ``` php artisan vendor:publish --tag="backstage-announcements-migrations" php artisan migrate ``` Optionally, you can publish the views using ``` php artisan vendor:publish --tag="backstage-announcements-views" ``` This is the contents of the published config file: ``` return [ ]; ``` Usage ----- [](#usage) Add the plugin to your Filament panel provider: ``` use Backstage\Announcements\AnnouncementsPlugin; public function panel(Panel $panel): Panel { return $panel ->plugins([ AnnouncementsPlugin::make(), ]); } ``` ### Navigation Control [](#navigation-control) Control whether the announcements resource appears in the navigation menu: ``` AnnouncementsPlugin::make() ->canRegisterNavigation(false) // Hide from navigation ``` ``` AnnouncementsPlugin::make() ->canRegisterNavigation(true) // Show in navigation (default) ``` ### Forced Scopes [](#forced-scopes) Limit which scopes (resources/pages) are available when creating announcements. You can specify the full class names of resources or pages: ``` AnnouncementsPlugin::make() ->forceScopes([ 'App\\Filament\\Resources\\Users\\UserResource', 'App\\Filament\\Resources\\Products\\ProductResource', 'App\\Filament\\Pages\\Dashboard', ]) ``` The plugin will automatically match these class names to the formatted scope names that appear in the dropdown, so users will see friendly names like "Users (list)" instead of the full class names. The form automatically converts between class names (stored in database) and formatted names (displayed in UI) using the `formatStateUsing()` method. ### Creating Announcements [](#creating-announcements) Once configured, you can create announcements through the Filament interface: 1. **Title**: The announcement title 2. **Content**: The announcement content (supports HTML) 3. **Scopes**: Select which resources/pages the announcement should appear on 4. **Color**: Choose a color theme for the announcement ### Displaying Announcements [](#displaying-announcements) Announcements are automatically displayed on the selected scopes using the included Livewire component. The component handles: - Dismissal tracking per user - Color theming - Responsive design - Accessibility features 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](.github/SECURITY.md) on how to report security vulnerabilities. Credits ------- [](#credits) - [Manoj Hortulanus](https://github.com/arduinomaster22) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 46 — FairBetter than 93% of packages Maintenance90 Actively maintained with recent releases Popularity5 Limited adoption so far Community9 Small or concentrated contributor base Maturity70 Established project with proven stability Bus Factor1 Top contributor holds 57.1% 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 ~1 days Total 196 Last Release 54d ago Major Versions v1.1.39 → v2.0.0-beta12025-11-28 v1.1.40 → v2.0.0-beta312025-12-17 v1.1.45 → v2.0.0-beta522026-02-02 v2.0.26 → v4.0.02026-03-25 2.x-dev → 4.x-dev2026-03-25 PHP version history (2 changes)v0.0.1PHP ^8.2 v1.1.0PHP ^8.3 ### Community Maintainers ![](https://www.gravatar.com/avatar/7c6a425dc8645907a118a007438172d58c2016773f54ab3a834beff172632f13?d=identicon)[ux](/maintainers/ux) --- Top Contributors [![Casmo](https://avatars.githubusercontent.com/u/385764?v=4)](https://github.com/Casmo "Casmo (4 commits)")[![mhortulanus](https://avatars.githubusercontent.com/u/91618246?v=4)](https://github.com/mhortulanus "mhortulanus (2 commits)")[![Baspa](https://avatars.githubusercontent.com/u/10845460?v=4)](https://github.com/Baspa "Baspa (1 commits)") --- Tags laravelfilamentphpbackstagebackstage-announcements ### Code Quality TestsPest Static AnalysisPHPStan, Rector Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/backstage-announcements/health.svg) ``` [![Health](https://phpackages.com/badges/backstage-announcements/health.svg)](https://phpackages.com/packages/backstage-announcements) ``` ### 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)[jibaymcs/filament-tour Bring the power of DriverJs to your Filament panels and start a tour ! 12247.8k](/packages/jibaymcs-filament-tour)[codewithdennis/filament-lucide-icons A Filament plugin that integrates Lucide icons, allowing you to use them seamlessly across Filament forms, tables, actions, and more. 4529.4k2](/packages/codewithdennis-filament-lucide-icons)[lara-zeus/popover Zeus Popover is filamentphp component to show a Popover with custom content in tables and infolist 2968.2k3](/packages/lara-zeus-popover)[lara-zeus/inline-chart Zeus Inline Chart easily add a chart in filamentPHP table column 2139.9k](/packages/lara-zeus-inline-chart)[defstudio/filament-searchable-input A searchable autocomplete input for Filament forms 3212.4k](/packages/defstudio-filament-searchable-input) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)