README.md
1# Todo Done Mover for DokuWiki
2
3Adds a page action named **Move tagged todos**. When clicked, it rewrites the current page source by moving whole-line todo items whose opening tag contains a hashtag token to a bottom `## done` section.
4
5## Example
6
7Before:
8
9```text
10<todo>first thing</todo>
11<todo #plopes>second thing</todo>
12<todo due:monday>third thing</todo>
13```
14
15After clicking **Move tagged todos**:
16
17```text
18<todo>first thing</todo>
19<todo due:monday>third thing</todo>
20
21## done
22<todo #plopes>second thing</todo>
23```
24
25## Install
26
27Copy this folder to:
28
29```text
30lib/plugins/todomover/
31```
32
33Then visit a DokuWiki page where you have edit permission and click **Move tagged todos** in the page tools/menu.
34
35## Notes
36
37- It only moves whole-line todo items, optionally preceded by a simple list marker such as `* ` or `- `.
38- It detects a hashtag token in the opening tag, e.g. `<todo #done>...</todo>`.
39- It does not move `<todo due:monday>...</todo>`.
40- It intentionally requires DokuWiki edit permission and a security token.
41- DokuWiki's native heading syntax is equals-sign based, not Markdown `##`. This plugin writes `## done` because that is the requested output. If your wiki does not use Markdown-style headings, change `DONE_HEADING` in `action.php` to something like `===== done =====` and adjust `finalLevelTwoSectionIsDone()` accordingly.
42
