Notifications
Explanation
The Notifications Application decides which of the events recorded on the wiki reach which user, and on which channel. An administrator sets what every account starts from and how much work the feature is allowed to do.
Preferences are resolved from three levels, each overriding the one before it: the main wiki, the current wiki, then the user. What you set in the administration is therefore a default, which any user can change for themselves in their own profile. Configure the Default Notification Settings covers the administration section, and Create Global Notification Filters the filters copied into every new account.
The mail the feature sends is rendered from a wiki page, so its wording and layout are yours to change: see Customize the Notification Email Template. The settings UI itself is available as wiki macros, documented in Notification Settings Macros, which is how a wiki can expose part of it outside the profile.
Everything that is not a per-user preference lives in xwiki.properties, listed in Notification Configuration Properties; two of them switch the feature and its mail channel off, as Enable or Disable Notifications describes. Those defaults are deliberate: notifications cost a search per user and per request, and the number of filters grows quickly on a wiki where automatic page watching is left on, so changing the thread pools or the cache is a response to a measured problem rather than routine tuning.
FAQ
Will notification emails trigger out-of-office replies?
No. They carry the Auto-Submitted: auto-generated and X-Auto-Response-Suppress: All headers, which tell a well-behaved mail system not to answer them.
How does my own application send notifications?
By recording events in the event stream; the Notifications Module extension page documents the API.
Can I change the way a notification is displayed?
Yes, with a NotificationDisplayerClass object in a wiki page, which the Notifications Module extension page describes.
More
To find more about the current topic, you can search or use the table below and filter the columns to narrow your choices.
