====== Task Plugin ======  
 
---- plugin ----
description: Integrates a simple task management tool into your wiki
author     : Dokufreaks (previous author: Gina Häußge, Michael Klier, Esther Brunner)
email      : freaks@dokuwiki.org
type       : syntax, action, helper
lastupdate : 2020-09-26
compatible : Hrun, Detritus, Elenor of Tsort, Frusterick Manners, Greebo
depends    : feed, pagelist
conflicts  :
similar    : gtd
tags       : todo task

downloadurl: https://github.com/dokufreaks/plugin-task/archive/master.zip
bugtracker : https://github.com/dokufreaks/plugin-task/issues
sourcerepo : https://github.com/dokufreaks/plugin-task/
screenshot_img : https://github.com/dokufreaks/plugin-task/raw/master/screenshots/TaskPlugin.png
----

===== Usage / Components =====

==== Task ====

  ~~TASK:[user]?[due date][priority]~~

^ [user]     | person responsible for this task -- either user or full name | optional; default is unassigned |
^ [due date] | date the task should be completed in YYYY-MM-DD form; if only year or year and month are given, the last day is assumed | optional; default is without due date |
^ [priority] | low, medium ''!'', high ''%%!!%%'' or critical ''%%!!!%%'' expressed with 0 to 3 exclamation marks | optional; default is low priority |

Place ''%%~~TASK~~%%'' on any page to mark it as a task. The title (first heading) is considered to be the summary of the task, the contents its description. For every task, there is a new page needed. 

If a task is unassigned, any registered user of the wiki can accept it. Once a task is taken, the user to whom it is assigned to can change the status of the task to one of these values:

  * rejected -- task is not worthwhile or not accepted by user
  * new -- reassign task so somebody else can take it
  * accepted -- user took over task but did not yet start the work
  * started -- work on task started
  * done -- work on task completed

If the task is done, other users can verify whether it's really done. If yes, the status can be set to verified.

The priority is reflected by the intensity of the orange shade of the task box.

Next to the title of the task box is an icon. It links to download an .ics file for the task. That can be imported by almost any calendar application that understands the VTODO component of the iCalendar standard.

==== Tasks (Overview) ====

  {{tasks>[namespace]?[view]&[flags]}}
  {{tasks>[path:]?open&noform&nouser&nocomments&nodesc&nodate}}

^ [namespace] | the namespace to look for tasks                           | required                       |
^ [view]      | one of the views, see [[#views|here]]                     | optional; default is ''open''  |
^ [flags]     | pagelist flags delimited by ''&'', see [[pagelist#flags]] | optional                       |

=== Views === 

^ ''all''      | all tasks                                                                                                            |
^ ''open''     | all task that are new, not yet done (or rejected) if assigned to me or not yet verified if assigned to someone else  |
^ ''my''       | only my open tasks                                                                                                   |
^ ''new''      | new tasks not yet assigned to anybody                                                                                |
^ ''done''     | completed but not yet verified tasks                                                                                 |
^ ''due''      | all open tasks with a due date of today                                                                              |
^ ''overdue''  | all open tasks with a due date in the past                                                                           |
^ ''select''   | adds a combo box which lets the user select the status from a drop down list                                         |
** Flags**
^ ''noform''      | Don't show the new task form                              |
^ ''nouser''      | Don't show the user                                       |
^ ''nocomments''  | Don't show the Discussions (from Discussion plugin)       |
^ ''nodesc''      | Don't show the descriptions, the content inside the page  |
^ ''nodate''      | Don't show the date                                       |
^ ''notags''      | Don't show the tags                                       |

===== Demo & Screenshots =====

==== Demo ====

Try this plugin at [[http://chimeric.de/_demo/plugin:task|here]] FIXME

==== Screenshots ====

{{https://github.com/dokufreaks/plugin-task/raw/master/screenshots/TasksOverview.png?300}}
{{https://github.com/dokufreaks/plugin-task/raw/master/screenshots/TaskGarbishPageView.png?300}}
{{https://github.com/dokufreaks/plugin-task/raw/master/screenshots/TaskBirthdayPresentEditorView.png?300}}
{{https://github.com/dokufreaks/plugin-task/raw/master/screenshots/TaskPlugin.png?300}}

===== Development =====

==== Changelog ====

{{rss>https://github.com/dokufreaks/plugin-task/commits/master.atom date}}


==== Bugs / Feature Requests ====

Please report bugs and feature requests at the [[https://github.com/dokufreaks/plugin-task/issues|Bug Tracker]].


===== Hacks/Mods & Discussions =====

Please refer to the external page [[:plugin:task:hacks_discussions|Hacks/Mods & Discussions]].