To-do-Plugin für das Aufgabenmanagement

Das ist so cool. Immer wenn du was erledigen musst, mach ein <todo @KÜRZEL></todo> drum und du kannst es einfach abhaken.

Wichtige Konvention: Wenn du ein <todo> verwendest, um eine Checkliste aufzubauen, setze als Zuständigkeit @tpl¹⁾, um eine Vorlage zu kennzeichnen!

Aufgaben anlegen und zuordnen

Um eine Aufgabe anzulegen, umfasse den Aufgabentext mit <todo @KÜRZEL></todo>.

Beispiel:

  * <todo @KÜRZEL>Erstelle eine Google+ Seite für den Onlineshop</todo>, damit dieser in den [[abkuerzungen:serp|SERP]] auffälliger platziert ist.

Ausgabe:

[KÜRZEL]Erstelle eine Google+ Seite für den Onlineshop, damit dieser in den SERP auffälliger platziert ist.

Diese Aufgabe wird dem Mitarbeiter unter KÜRZEL zugeordnet und er sieht das in seinen To-do-Listen.

Du kannst eine Aufgabe auch mehreren Leuten zuordnen, dafür musst du mehrere @KÜRZEL mit Leerzeichen verwenden. Schreibe immer den Hauptzuständigen als erstes in die Liste, da nur er in der Ausgabe gezeigt wird. Das To-do-Element taucht aber bei allen Beteiligten auf.

Beispiel:

  * <todo @KÜRZEL @KÜRZEL2 @KÜRZEL3>Gemeinsame Aufgabe</todo>

Ausgabe:

[KÜRZEL, KÜRZEL2, KÜRZEL3]Gemeinsame Aufgabe

Hinweis: Du kannst ein To-do-Element mit der Raute (#) als erledigt markieren, das sieht dann so aus:

  * <todo # @KÜRZEL>Aufgabe 2</todo>

Ausgabe:

Aufgabe 2

Aufgabenlisten

Du kannst Aufgaben überall markieren, wo sie im Context Sinn machen. Manchmal musst du eine Aufgabenliste oder Checkliste erstellen. Verwende hierfür eine geordnete oder ungeordnete Liste, z. B.

[KÜRZEL]Nummerierter Listenpunkt
[KÜRZEL]Aufgabe 2

[KÜRZEL]Listenpunkt
[KÜRZEL]Aufgabe 2

Start- und Fälligkeitsdatum

Du kannst ein Start- und/oder Fälligkeitsdatum in deinen To-do-Elementen angeben. Das System färbt die Elemente dementsprechend. Achte auf das englische Datumssystem in der Form JAHR-MONAT-TAG, z. B. 5.6.2015 ⇒ 2015-06-05 mit 2-stelligen Tages- und Monatsangaben.

Beispiele:

  * <todo @KÜRZEL start:2015-06-05>Startdatum: 5.6.2015</todo>
  * <todo @KÜRZEL due:2015-06-05>Fälligkeitsdatum: 5.6.2015</todo>
  * <todo @KÜRZEL start:2020-06-05 due:2020-06-15>Start und Fälligkeit: 5.6.2020 / 15.6.2020</todo>

Ausgabe:

[KÜRZEL][2015-06-05 → ]Startdatum: 5.6.2015
[KÜRZEL][ → 2015-06-05]Fälligkeitsdatum: 5.6.2015
[KÜRZEL][2020-06-05 → 2020-06-15]Start und Fälligkeit: 5.6.2020 / 15.6.2020

— mw 16.10.2015 11:29 Bei der Übersetzung aufpassen, da sonst die To-do-Syntax greift.

Formatierungen

Innerhalb eines To-do-Elements sind keine Formatierungen erlaubt. Du kannst aber um das gesamte To-do-Element Wiki-Formatierungen anlegen.

Beispiel:

Fettes To-do-Element

Ich würde das allerdings nicht machen, es lenkt ab.

Notation von To-do-Elementen

Verwende die folgende Form, um ein To-do anzulegen. Es ist der User Story der Scrum Methode entlehnt, und hilft sowohl dem Ersteller als auch dem Bearbeiter der Aufgabe.

"<Rolle> soll <Ziel/Wunsch>, um/damit <Nutzen>

Fasse dabei nur den Teil vor dem Komma in ein Todo-Element. Durch die Definition des Nutzens einer Aufgabe wird der drang diese zu erledigen erhöht. Zudem muss der Aufgabensteller den Nutzen definieren.

Beispiel:

Für den Buchhalter die Liste von offenen Posten nach Fälligkeit sortieren, damit er säumige Zahler effizient und frühzeitig annmahnen kann.

Du findest in diesem Wiki weitere, echte Beispiele, die die Notation beschreiben.

Ausgabe von To-do-Listen

Noch nicht übersetzt:


===== Lightweight Task Management System =====

The new version (since version 2014-03-17) of the todo plugin allows to create an easy to use task management system to collect all todos from all pages on a single page. 

**First turn off caching**
   ~~NOCACHE~~

Display all open and closed todos from all pages
  ~~TODOLIST~~

=== Completion state ===

Filter the completion state, allowed values: ''yes'' or ''no''
  ~~TODOLIST completed:no~~
  ~~TODOLIST completed:yes~~
  
=== Assignments ===
Filter the assignments, allowed values: ''yes'', ''no'', usernames in format''@username'' or ''username'', or placeholders ''@@USER@@'' or ''@@MAIL@@'' which are replaced by username or e-mail of current logged in user.
  ~~TODOLIST assigned:yes~~ 
  ~~TODOLIST assigned:User1,User2~~ 
  ~~TODOLIST assigned:@User1,@User2~~
  ~~TODOLIST assigned:@@USER@@~~
  ~~TODOLIST assigned:@@MAIL@@~~ finds tasks assigned using someones email.
  
=== Show/Hide checkbox ===
Do (not) show the checkbox, allowed values: ''yes'' or ''no''
  ~~TODOLIST checkbox:no~~
  
=== Render username===

Render the username as id, full name or not at all, allowed values: ''user'' or ''real'' or ''none''
  ~~TODOLIST username:real~~
  
=== Render header ===

Render the header as pageID, as the first header of the page or not at all, allowed values: ''id'' or ''firstheader'' or ''none''
  ~~TODOLIST header:firstheader~~

=== Show/Hide Start/Due Date ===
Do (not) show the Start/Due date, allowed values: ''yes'' or ''no''

  ~~TODOLIST showdate:yes~~
  
=== Completed Data Filter===
Filter by date completed.

  ~~TODOLIST completedbefore:<date>~~
  ~~TODOLIST completedafter:<date>~~

=== Start/Due Date Filter===
Filter the TODOLIST by Start/Due Date. Absolute and relative Dates are possible.
Not yet in the stable Version. Download: [[https://github.com/runout-at/dokuwiki-plugin-todo/archive/78f3be84a8fc4f6fb44a51dc23644e8fe7014b16.zip|ZIP by Markus]]

  ~~TODOLIST startbefore:<date>~~
  ~~TODOLIST startafter:<date>~~
  ~~TODOLIST duebefore:<date>~~
  ~~TODOLIST dueafter:<date>~~

<date> can be:

  Y-m-d like 2014-06-12
  or a value like +10 or -10 or 0
  
invalid values will be substituted with todays date

=== Combined options ===

  ~~TODOLIST assigned:@@USER@@ completed:yes ~~
  ~~TODOLIST assigned:Gerrit,leo completed:no ~~

Some default values for these options can be set in the Configuration Manager

=== Filter the namespace of the task list ===
[[https://github.com/leibler/dokuwiki-plugin-todo/pull/32#issue-36869358|I've added]] the following option to the ''~~TODOLIST~~'' tag: ''ns'':

If omitted it uses ''ns:all''.

It can be used with the following parameters:
  * ''all'' - displays todo's from everywhere (the current default behaviour)
  * ''/'' - only displays todo's from pages containing in the ROOT namespace
  * ''<string>'' - Where string can be any text. It checks the page-id if it starts with this string and then returns the pages with todo's that do; for example:

  ~~TODOLIST ns:todo~~

returns all todo's from the page todo in the root of the wiki, or from the namespaces starting with todo or from the page todo and the namespaces starting with todo.

  ~~TODOLIST ns:todo:~~

returns all todo's from the namespace todo.

  ~~TODOLIST ns:todo:r~~ 

returns all todo's from the namespaces or pages under todo, starting with an r.

¹⁾

template