This is an old revision of the document!

Do Plugin

Compatible with DokuWiki

2020-07-29 "Hogfather" unknown
2018-04-22 "Greebo" unknown
2017-02-19 "Frusterick Manners" yes
2016-06-26 "Elenor Of Tsort" no

The do plugin allows users to create simple tasks in wiki pages

Last updated on: 2017-05-30
Provides: Syntax, Helper, Action
Repository: Source
Requires: sqlite

Similar to agenda, todo

Tagged with list, task, todo

By Adrian Lang, Andreas Gohr, Dominik Eckelmann

The do plugin allows users to create simple tasks in wiki pages. Those tasks may be assigned to other users and have a due date. Tasks can be listed in pages as well.

Plugin documentation and download is available on ICKEwiki.de.

Syntax

There are two syntax elements.

Task

<do USER DATE>TEXT</do>

Create a new task TEXT, optionally assign it to USER or mark it as due on DATE; there is a toolbar button for this as well.

USER User id as accepted by current authentication backend + USER User id - bbi-Benutzername (rw, kw, tk, …) - DATE Date in format yyyy-mm-dd + DATE Datum im Format yyyy-mm-dd - TEXT Description of task. Task texts needs to be unique at a page. Duplicates are seen as same task.

Listing

{{dolist>NAMESPACE?id=ID&status=(DONE|UNDONE)&limit=COUNT&md5=MD5&user=ASSIGNEE&creator=CREATOR}}

List tasks in NAMESPACE with optional additional filtering

Part	Details
NAMESPACE	Namespace to search for tasks
`id`	Page to search for tasks
`status`	Can have value `DONE` or `UNDONE`. Case insensitive.
`limit`	Maximum number of items to display.
`md5`	Show only task with this MD5 value
`user`	User id of assigned person
`creator`	User id of creator

Show the user’s open tasks in template

You can show an icon with the current user's open tasks by adding the following code to your template:

/** @var helper_plugin_do $do */
$do = plugin_load('helper', 'do');
if ($do) {
    echo $do->tpl_getUserTasksIconHTML();
}

If the user has open tasks and they click on the icon, then a table with all their open tasks is shown as an overlay.

The toolbar button access a dialog for input of assignees and due date. Due date will show a date picker. If the Bureaucracy Plugin is installed, the toolbar dialog will give assignees suggestions as well.

Demo

See for demo at ICKEwiki.de.

Development

The source code of the plugin is available at GitHub: cosmocode/do.

Changes

Version upped (2021-03-16 23:50)
added date filter to show tasks of selected period (2021-03-16 14:58)
Version upped (2020-06-29 23:50)
Merge pull request #71 from cosmocode/hogfather (2020-06-29 12:44)
some updates for hogfather compatibility #68 (2020-06-03 00:10)
Merge pull request #63 from dokuwiki-translate/lang_update_1349_15705… (2019-10-09 09:00)
translation update (2019-10-08 20:00)
Version upped (2019-09-30 23:50)

Bug reports and feature requests

Please refer to the Issue Tracker for reporting issues.

Table of Contents