Christian Ziemski's
wikidPad Page
The current stable version (2011-06-06): ToDoExtension.py.
I'm handling my development files with Mercurial, a free, distributed source control management tool.
For remote access and public download there is my repository on Bitbucket.
So all files, including the history, are available there as well:
Comments, suggestions and bug reports are welcome and can be placed in wikidPad Yahoo! Group
While trying wikidPad as ToDo-List-Helper I found the following extensions on the wikidPad Project Home Page:
Because these extensions still didn't exactly fit my needs I wrote my own, loosely based on the above.
I mainly added date calculations, date sorting, a separate calendar page and a configuration section.
(The formulas for 'date calculation from week number' I found somewhere in the WWW (link to be added later here).)
If a wikiWord beginning with "ToDo" is created or selected (viewed) it automatically
collects all 'todo' entries from all other pages and inserts them here (after a placemark).
Of course you can write your own text before that placemark. It wouldn't be touched by the extension.
If the wikiWord has additional characters after the "ToDo" like "ToDoPrivate" those characters "Private"
are used as filter (case insensitive).
If there are spaces or underlines between "ToDo" and the following characters (e.g "ToDo_Private")
these are ignored and so still the filter is "Private". (This may be better readable.)
Only Todos containing that filter string (in its name or in the full entry) are collected.
(Behavior depends on configuration option "filterTodos" below.)
Note: If the optional Calendar feature is enabled, it is "ToDoCalendar" and "ToDoCalendarPrivate" in the example below.
The todos are sorted by 'tag' the following way:
1.) Completely untagged e.g. 'todo: shopping' 2.) Tagged with special tags. e.g. 'todo.High: pay taxes' Sort order and display see config section below 3.) Tagged with a date e.g. 'todo.2006-10-31: Halloween 2006' Sorted by date (earliest first in list) Marked as 'GONE', 'TODAY', 'n hours left', 'n days left' dependent on dayrange below Displayed in different formats, dependent the same way. The following date formats are recognized: (**) = new as of 2010-01-10 (***) = new as of 2010-12-07 "yyyy-mm-dd" # standard date e.g. todo.2006-10-31: Halloween 2006 "mm/dd/yyyy" # GB/US date "dd.mm.yyyy" # European date "yyyy-mm-*" # complete month mm (every day) of year yyyy e.g. todo.2010-07-*: One month for summer vacations (**) "*-mm-*" # complete month mm (every day); every year e.g. todo.*-12-*: Buy Christmas gifts (**) "yyyy-Wnn-d" # DayOfWeek in given week+year (Mon=1,Sun=7) e.g. todo.2007-W03-2: Tuesday of 3rd week in 2007 "*-W*-d" # DayOfWeek in every week+year (Mon=1,Sun=7) e.g. todo.*-W*-1: go to work on Monday "yyyy-Wnn" # complete week in a given year e.g. todo.2008-W12: complete week 12 in 2008 "*-Wnn" # complete week, every year e.g. todo.*-W52: prepare end of year "CWnn" # same as above: Calendar Week "KWnn" # same as above: Calendar Week (German: Kalender Woche) "*-mm-dd" # a date every year e.g. todo.*-10-31: Halloween, in every year "*-*-dd" # a day every month, every year e.g. todo.*-*-01: Every month, the 1st day "*-*-*" # every day "*-mm-dd+d" # every DayOfWeek before(-)/after(+) dd'th day of month mm (**) "*-*-dd+d" # every DayOfWeek before(-)/after(+) dd'th day every month e.g. todo.*-*-31-1: Monthly report (last Monday of the month) (**) "*-E+ddd" # Easter +- ddd days (***) The dates with "*" are "optimistic" ones: if such a date is in the past it is assumed as "for next year" and not as "GONE this year". If there are subtags like the string "Peter" in "todo.Peter.2008-09-16: Birthday" the subtag is listed in parentheses on the todo page. 4.) otherwise tagged e.g. 'todo.family: holidays'
Note: Within the wikidPad help wiki this hook does nothing, even if you create a page ToDo there.
The following WikiDocumentAttributes will be added to that generated page
(If there isn't already a custom [icon: ...] set, see configuration below):
Since a few pictures are able to describe better than many words here an easy example.
(The hardcopies are taken from WikidPad 1.9 running under Linux/KDE.)
Imagine a Wiki with two wiki pages "CarAndMore" and "FamilyBusiness" with some data and todo tags on it:
Opening the wiki page "ToDo" now shows an info popup:
and then in edit mode:
The same in preview mode:
(In the standard lefthand tree view 'todo' the todo items are sorted alphabetically, on the ToDo page to the right they are sorted by date and/or tag.)
The extension is configurable in three levels.
'predefinedTags', [ ('UNTAGGED', '++++ Not yet tagged'), ('High', '+++ HIGH!'), ('Next', '++++ Next Actions'), ('ThisWeek', '++++ This Week'), ('SomeDay', '++++ SomeDay / Maybe'), ('TimeToTime', '++++ From time to time'), ('Low', '++++ Tagged as LOW'), ('VeryLow', '++++ Tagged as Very LOW') ],
On every opening of the page ToDoConfiguration a reminder will pop up...
... just before the page itself is shown: