Extension:SimpleTasks

MediaWiki extensions manual

SimpleTasks Release status: stable
Description	Tasks are checklist items that can be checked on or off to indicate if the task is open or completed.
Author(s)	Hallo Welt! GmbH
Maintainer(s)	Hallo Welt! GmbH
Latest version	4.5
Compatibility policy	For every MediaWiki release that is a Long Term Support release there is a corresponding branch in the extension.
MediaWiki	1.39 (LTS)
License	GNU General Public License 3.0 only
Download	Download extension Git [?]: Download Git master browse repository (GitHub) commit history repository contributors (GitHub) code review
Translate the SimpleTasks extension if it is available at translatewiki.net

Community Forum

Tasks are checklist items that can be checked on or off to indicate if the task is open or completed.

Usage

SimpleTasks provides checkboxes with labels that can be marked completed in view mode. The changes are logged in the page history.

Simple tasks

Simple tasks show a checkbox with a task description.

To add a simple task:

1. Click the Content Droplet icon in the editor toolbar.
2. Select the Tasklist droplet. This inserts a checkbox.
3. Add the task description next to the checkbox.
4. Repeat steps 2 and 3 to add more tasks. Alternatively, copy the first task line and paste it onto new lines. Then change the individual task descriptions.

You can now check the items of your list. Everytime a checkbox is checked or unchecked, the version history of the page creates an entry.

Combined tasks

Tasks can have three elements: (1) A task checkbox with label, (2) an assignee, and (3) an optional date. When these elements are added to the page consecutively (the order of these elements is flexible), a single task item is created.

To add a combined task item:

1. Add your task list item as described above.
2. Add a mention (as described above) immediately after the task description to assign the task to a user.
3. Add a Date Content Droplet immediately after the user mention (optional).
4. Copy the entire task line and paste it on a new line to create the next task item.

My Tasks

Users can see all their open tasks on their task list.

Querying tasks

If you are familiar with Semantic MediaWiki, you can query the task items. They are added as semantic subobjects with the following properties:

• Property:Task/Desc
• Property:Task/Due date
• Property:Task/User

• 
  Task Item
• 
  Checkbox changes in the page history
• 
  Finished task list

Installation

• Download and move the extracted SimpleTasks folder to your extensions/ directory.
  Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/SimpleTasks
• Only when installing from Git, run Composer to install PHP dependencies, by issuing composer install --no-dev in the extension directory. (See task T173141 for potential complications.)
• Add the following code at the bottom of your LocalSettings.php file:

  wfLoadExtension( 'SimpleTasks' );
  

• Run the update script which will automatically create the necessary database tables that this extension needs.
•  Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Requirements

The following other installations are required to install SimpleTask:

• Extension:AtMentions (which requires Extension:OOJSPlus )
• Extension:DateTimeTools
• Extension:Checklists

External links

• Extension reference for SimpleTasks
• Extension user help

See also

• Semantic Tasks
• Semantic Watchlist