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 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.

Parameters
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:
 * Sets the name of the property holding the name of the user to who the respective task was assigend to. Defaults to:
 * Sets the name of the property holding the name of the user to who the respective task was assigend to. Defaults to:


 * Sets the name of the property holding the name of the user who should get an infomation about the respective task. Defaults to:
 * Sets the name of the property holding the name of the user who should get an infomation about the respective task. Defaults to:


 * Sets the name of the property holding the target date on which respective task should be completed. Defaults to:
 * Sets the name of the property holding the target date on which respective task should be completed. Defaults to:


 * Sets the name of the property holding the date on which a reminder for the respective task should be sent. Defaults to:
 * Sets the name of the property holding the date on which a reminder for the respective task should be sent. Defaults to:


 * Sets the name of the property holding the status of the respective task. Defaults to:
 * Sets the name of the property holding the status of the respective task. Defaults to:


 * Sets the name of the property holding the name of the group of users to who the respective task was assigend to. Defaults to:
 * Sets the name of the property holding the name of the group of users to who the respective task was assigend to. Defaults to:


 * Sets the name of the property holding the name of the user to who the respective task was assigend to. Defaults to:
 * Sets the name of the property holding the name of the user to who the respective task was assigend to. Defaults to:

See also furhter infomation on minimum required properties.

This is another configuation paramter provided by this extension:
 * Sets if the users should be notified once unassigned from a task. Defaults to:
 * Sets if the users should be notified once unassigned from a task. Defaults to:

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:

Reminder emails are now sent by a cron job. The actual sending of the emails is evaluated as follows for all pages that have annotations to the Assigned to or Carbon copy properties: As soon as the current date is equal either to the "Reminder at" date or to the "Target date", a corresponding reminder will be sent through the email system used by MediaWiki. Thus only users who have set a valid email address in their preferences, and have confirmed it will receive emails.
 * 1) Reminder at value
 * 2) Target date value

Reminders

 * Notification emails are sent when a page is saved that has the following properties:
 * and/or
 * or
 * is set to the date in which the reminder is to be sent
 * is set to the current or to a future date
 * The Assigned to and Carbon copy properties must be of datatype "Page" (default for non-existing properties) and their values must be of the form: "User:&lt;username"
 * The Reminder at and Target date properties must be of datatype "Date"