Setup notifications for events from task manager

[snazare]

Please setup notifications (in platform and email) for the following events in the Task Manager (Pro) application:

• status change
• due date change
• project assignment
• priority update

[KebabRonin]

Who should receive notifications

• Users should be able to receive notifications for a task they are not assigned to.
• Similarly, users should be able to ignore updates for a task they are assigned to.
• Users should stop receiving notifications when they are unassigned.
• Received notifications should use the 'watch page' feature in XWiki, respecting any other notification filters the user might have, like ignoring self or system events).
• NOTE - Users will not receive notifications for tasks they are already assigned to before upgrading to this version of TaskManager. This is so the upgrade process doesn't take too long if there are many tasks (would need to scan through all of them to determine who receives what).
  • If there is demand, we can publish a script which enables notifications for older tasks, to be run by admins if they want.

Notification messages

• There should be one notification for each modified field.
• The Notifications are only sent when the following properties are changed:
  • assignee (can be unset) | Different messages for current user assigned/unassigned or nobody assigned.
  • due date (can be unset) | Different messages if the new due date is later or earlier than the previous one.
  • project
  • status
  • priority
• The Notifications should contain the previous value of the changed field where possible.

Subscribing to a task

• The user must enable the TaskManager event notifications from the User Administration page.
  • TaskManager events are all part of only one 'category', as opposed to multiple like the pages app (where users can receive notifications only for page updated, deleted, created instead of getting all notifications).
• The user must also watch the pages of the tasks they wish to receive.
  • Watching the entire TaskManager space will implicitly watch all pages, and thus send notifications for all tasks, even where the user is not assigned.
  • The TaskManager space is watched by default for all users (can be disabled if the Admin adds a Custom Filter to ignore task events on TaskManager space-> all new users will not get task notifications).
  • To stop receiving notifications for some tasks in a common space, a user can unwatch the space the tasks are in.
• Users will automatically watch tasks when they are assigned.
  • Users can unwatch the page if they don't want notifications for that task.
    • When they are assigned again, the task will be added as watched again.
  • When a user is unassigned, they automatically unwatch the page.
• Task macros in a page:
  • If the page is non-terminal, then the tasks are children of the page. Unwatching the page with children will disable notifications for those tasks (the page can still be watched without children to get notifications for the page, without notifications for the tasks)
  • If the page is terminal this doesn't work, and the user must unwatch the 'Tasks' sibling page. If there are multiple terminal pages with task macros in a space then all tasks will belong to that space. If a user wants to unwatch just one page, they will have to unwatch each task manually.