====== Task Plugin ======  

Integrates a simple [[doku>plugin:task|task]] management tool into your wiki. 

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

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]}}

^ [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 |
** Flags**
^ ''noform'' | Don't show the new task form |