Hi all,
We’re excited to share that the MediaWiki Platform team has released a major improvement to how notifications are handled across MediaWiki and Echo.
As part of MediaWiki 1.44 https://www.mediawiki.org/wiki/MediaWiki_1.44 we’ve introduced a unified Built-in Notifications https://www.mediawiki.org/wiki/Manual:Notifications system that replaces the current complex mix of hooks and other patterns with a more consistent interface. This makes it easier to send, manage, and customize notifications across the platform.
What’s changing There is a new way to trigger notifications through the new system and an easier way to manage notification overrides through the new NotificationsMiddleware. We are also deprecating several hooks as part of this work.
The new framework doesn’t deliver or display notifications directly, instead relying on pluggable handlers defined by extensions. Echo has been updated to become a handler and Enotif has been reimplemented on top of the new built-in notifications.
Migrating notifications Check out the updated documentation at Manual:Notifications https://www.mediawiki.org/wiki/Manual:Notifications to:
-
Start using NotificationService::notify() instead of Event::create() -
Switch from notification-related hooks to the new NotificationMiddleware system
You can also find further information on Phabriactor: T388663 https://phabricator.wikimedia.org/T388663
Deprecated hooks
If your extension uses any of the following hooks please check the relevant Phabricator tasks and migration examples:
-
AbortEmailNotification (https://phabricator.wikimedia.org/T389618) -
SendWatchlistEmailNotification (https://phabricator.wikimedia.org/T388003 ) -
AbortTalkPageEmailNotification (https://phabricator.wikimedia.org/T388004 ) -
Echo\EventInsertComplete (https://phabricator.wikimedia.org/T395913) -
UpdateUserMailerFormattedPageStatus ( https://phabricator.wikimedia.org/T395050)
There is a parent task for all deprecation activities: T389624 https://phabricator.wikimedia.org/T389624
This work is part of our broader effort to simplify feature development through iterative improvements to platform architecture https://www.mediawiki.org/wiki/MediaWiki_Product_Insights/Artifacts/Simplifying_feature_development_through_iterative_platform_architecture. We really appreciate all your help and feedback as we continue to improve MediaWiki.
Thanks! MediaWiki Platform