Extension:Semantic Tasks

The Semantic Tasks extension works in conjunction with another extension, Semantic MediaWiki, to provide email task notifications and reminders.

Semantic Tasks was originally developed for the Creative Commons internal task- and project-tracking system ccTeamspace. Development was sponsored by KDZ - Centre for Public Administration Research and is currently sponsored by KM-A Knowledge Management Associates.

Description

 * After a task creation, users assigned to the task and following the task receive a "New Task" mail containing the task text.
 * After a task is modified, users assigned to the task and following the task receive a "Task Updated" mail containing a diff of the modification.
 * The editor of the task doesn't receive a mail after his edit.
 * If the edit is a null or minor edit, no mail is sent.

Basic usage
The extension sends email notifications to the assigned users of a page as soon as the page is modified or created with a non null and non minor edit and it contains one or more  properties.

(note multiple  users)

Notify a group
The extension also supports the assignment of task pages to groups. In order to assign a task page to a group create a page named for instance "ST group" and list in that page the assignees of that group in the following form,  , etc., as follows:



Then set the task page as follows



Note that the properties,   and   must be of type page.

Status
The behavior of the Status has changed since version 2.1.0. Now the status of the task can be set to closed, as follows, to disable notifications and reminders. Other values for the  property, will not be evaluated by the extension.

Reminders
Reminders (i.e. background email notifications) will be sent to the assignees of a task whenever a  or   properties are set in a given day, as follows:



Note that  must be a future or current day date, and   must not be set to "Closed" in order to work.

See section below for the server set-up.

Configuration
The following variables are to be set in the LocalSettings.php file of your wiki. None of them are required, if not set the default values are used.

i18n
The following configuration parameters allow to set the names of the properties used by the extension to localized names suitable for the wiki instance's language or to different names suitable to the needs specific to your wiki:

Cron job
Finally run a cron job once a day to execute the reminder script. To do so edit your crontab file: And add the following line to execute the script every day at 12:

The actual sending of the emails is performed when a task has valid assignees (,  , or   properties),   or   are set to the same day in which the script runs, and   is not set to "Closed". Finally, only users who have set a valid email address in their preferences, and have confirmed it will receive emails.