Task List
-
handler
check tasklist macro
1:p32_n1974831321 check tasklist macro HIGH 1218437549500 false 0 false dschlegel -
handler
Guillermo
1:p32_p163547498 Guillermo MEDIUM 1225479293749 false 0 false gchutrau -
handler
Vote
1:p32_p2672394 Vote LOW 1225861686844 false 0 false gchutrau
Overview:
The {tasklist} macro adds interactive task lists to your pages allowing users to easily add and alter items...
There are many times when you need a quick task (or "to-do") list and this macro is the perfect choice!
It takes only a second to add it to the page (or just about anywhere else) and it's easy to add tasks, set the status of tasks (complete or incomplete), reorder tasks (to set priority) and delete tasks.
Parameters:
Add the macro to your page as follows:
{dynamictasklist:listTitle}
| Parameter | Required | Notes |
|---|---|---|
| default |  |
The "listTitle" default parameter is used not only to display a title for your list (eg. "Shopping List") but also to define where the data is stored in our database. |
Examples:
Simple Use
Add a single task list to a page, without a title:
{dynamictasklist}
The result is shown below (we've added some tasks to it):
Task List
-
handler
whoohoo
2:p32_p1322108471 whoohoo MEDIUM 0 true 0 false mathewnitin -
handler
tet
2:p32_p114723 tet MEDIUM 0 true 0 false -
handler
Test
2:p32_p2603186 Test MEDIUM 0 true 0 false -
handler
ccc
2:p32_p98307 ccc MEDIUM 0 true 0 false -
handler
adsfadsf
2:p32_n800493460 adsfadsf MEDIUM 0 false 0 false -
handler
howdiwho
2:p32_n200191287 howdiwho MEDIUM 0 false 0 false -
handler
foo
2:p32_p101574 foo MEDIUM 0 false 0 false -
handler
cup of tea
2:p32_p235936361 cup of tea MEDIUM 0 true 0 false -
handler
bold test
2:p32_n177588185 *bold test* MEDIUM 0 true 0 false -
handler
dddd
2:p32_p3078400 dddd MEDIUM 0 true 0 false -
handler
zzxcx
2:p32_p116422573 zzxcx MEDIUM 0 true 0 false -
handler
あ
2:p32_p12354 あ MEDIUM 0 true 0 false -
handler
afiyet olsun
2:p32_n1258657869 afiyet olsun MEDIUM 0 true 0 false -
handler
test task
2:p32_n1238307757 test task MEDIUM 0 true 0 false -
handler
task 1
2:p32_n880874410 task 1 MEDIUM 0 true 0 false -
handler
create
2:p32_n1352294148 create MEDIUM 0 true 0 false -
handler
kylla tamakin pitaisi ihmisten osata
2:p32_p1397085396 kylla tamakin pitaisi ihmisten osata MEDIUM 0 true 0 false -
handler
hello
2:p32_p99162322 hello MEDIUM 0 true 0 false -
handler
go get change
2:p32_p260557298 go get change MEDIUM 0 true 0 false -
handler
sasa
2:p32_p3522844 sasa MEDIUM 0 true 0 false -
handler
ssasa
2:p32_p109727759 ssasa MEDIUM 0 true 0 false -
handler
task
2:p32_p110132027 task MEDIUM 0 false 0 false -
handler
whoolæ
2:p32_n788635093 whoolæ MEDIUM 0 false 0 false -
handler
åh abe
2:p32_n1936763161 åh abe MEDIUM 0 false 0 false -
handler
ønsketænkning
2:p32_p878693690 ønsketænkning MEDIUM 0 false 0 false -
handler
remember the milk
2:p32_p373684893 remember the milk MEDIUM 0 false 0 false -
handler
aaa
2:p32_p96321 aaa MEDIUM 0 false 0 false -
handler2:p32_p0 MEDIUM 0 false 0 false
-
handler
Testing
2:p32_p242207216 Testing MEDIUM 0 true 0 false
Standard Use
Add a single task list to a page, eg. a shopping list:
{dynamictasklist:Shopping List}
The result is shown below (we've added some tasks to it):
Shopping List
-
handler
bread
1:n908790698_p94001400 bread MEDIUM 0 false 0 false -
handler
test
1:n908790698_p3556498 test MEDIUM 0 false 0 false -
handler
test
1:n908790698_p3556498_1 test MEDIUM 0 false 0 false -
handler
Milk
1:n908790698_p2398267 Milk MEDIUM 0 false 0 false -
handler
yfgnxfgn
1:n908790698_n483185911 yfgnxfgn MEDIUM 0 false 0 false -
handler
fggb
1:n908790698_p3140956 fggb MEDIUM 0 false 0 false -
handler
fggb
1:n908790698_p32 MEDIUM 0 false 0 false -
handler
eggs
1:n908790698_p3111182 eggs MEDIUM 0 false 0 false -
handler
testing testing
1:n908790698_n846663680 testing testing MEDIUM 0 false 0 false -
handler
1
1:n908790698_p49 1 MEDIUM 0 false 0 false -
handler
sdfsdfsdf
1:n908790698_p207460437 sdfsdfsdf MEDIUM 0 false 0 false -
handler
zz
1:n908790698_p3904 zz MEDIUM 0 false 0 false -
handler
d
1:n908790698_p100 d MEDIUM 0 false 0 false -
handler
d
1:n908790698_p32_1 MEDIUM 0 false 0 false -
handler
rrr
1:n908790698_p113202 rrr MEDIUM 0 false 0 false -
handler
rrr
1:n908790698_p113202_1 rrr MEDIUM 0 false 0 false -
handler
rrr
1:n908790698_p32_2 MEDIUM 0 false 0 false -
handler
lll
1:n908790698_p107244 lll MEDIUM 0 false 0 false -
handler
test
1:n908790698_p3556498_2 test MEDIUM 0 false 0 false -
handler
s
1:n908790698_p115 s MEDIUM 0 false 0 false -
handler
s
1:n908790698_p32_3 MEDIUM 0 false 0 false -
handler
taqsk
1:n908790698_p110130428 taqsk MEDIUM 0 false 0 false -
handler
sdfsdfsdf
1:n908790698_p207460437_1 sdfsdfsdf MEDIUM 0 false 0 false -
handler
sdfsdfsdf
1:n908790698_p32_4 MEDIUM 0 false 0 false -
handler
test task
1:n908790698_n1238307757 test task MEDIUM 0 false 0 false -
handler
shampoo
1:n908790698_p2054079855 shampoo MEDIUM 0 false 0 false -
handler
111d1d
1:n908790698_p1449638406 111d1d MEDIUM 0 false 0 false -
handler
f
1:n908790698_p102 f MEDIUM 0 false 0 false -
handler
atweq
1:n908790698_p93154896 atweq MEDIUM 0 false 0 false -
handler
atweq
1:n908790698_p32_5 MEDIUM 0 false 0 false -
handler
hii
1:n908790698_p103304 hii MEDIUM 0 false 0 false -
handler
hii
1:n908790698_p32_6 MEDIUM 0 false 0 false -
handler
hii
1:n908790698_p32_7 MEDIUM 0 false 0 false -
handler
hii
1:n908790698_p32_8 MEDIUM 0 false 0 false -
handler
b
1:n908790698_p98 b MEDIUM 0 false 0 false -
handler
b
1:n908790698_p32_9 MEDIUM 0 false 0 false -
handler
milk
1:n908790698_p3351579 milk MEDIUM 0 false 0 false -
handler
aaaa
1:n908790698_p2986048 aaaa MEDIUM 0 false 0 false -
handler
sdfsdfsdf
1:n908790698_p207460437_2 sdfsdfsdf MEDIUM 0 false 0 false -
handler
test
1:n908790698_p3556498_3 test MEDIUM 0 false 0 false -
handler
new
1:n908790698_p108960 new MEDIUM 0 false 0 false -
handler
item
1:n908790698_p3242771 item MEDIUM 0 false 0 false -
handler
item
1:n908790698_p32_11 MEDIUM 0 false 0 false -
handler
juice
1:n908790698_p101482848 juice MEDIUM 0 false 0 false -
handler
test
1:n908790698_p3556498_4 test MEDIUM 0 false 0 false -
handler
test
1:n908790698_p32_12 MEDIUM 0 false 0 false -
handler
asd
1:n908790698_p96882 asd MEDIUM 0 false 0 false -
handler
asd
1:n908790698_p32_13 MEDIUM 0 false 0 false -
handler
454
1:n908790698_p51667 454 MEDIUM 0 false 0 false -
handler
apple
1:n908790698_p93029210 apple MEDIUM 0 false 0 false -
handler
bananas
1:n908790698_n337338962 bananas MEDIUM 0 false 0 false
Adding two or more task lists to a page
If you add more than one task list to a page, you must give each a seperate title:
{dynamictasklist:Second Shopping List}
{dynamictasklist:My Tasks}
Which results in the following (again, we've added some items):
Second Shopping List
-
handler
exemples
1:p1202963914_p2052095685 exemples MEDIUM 0 false 0 false -
handler
j
1:p1202963914_p106 j MEDIUM 0 false 0 false -
handler
jhjhj
1:p1202963914_p101096686 jhjhj MEDIUM 0 false 0 false -
handler
nick
1:p1202963914_p3381091 nick MEDIUM 0 false 0 false -
handler
a
1:p1202963914_p97 a MEDIUM 0 false 0 false -
handler
test
1:p1202963914_p3556498 test MEDIUM 0 false 0 false -
handler
test
1:p1202963914_p32 MEDIUM 0 false 0 false -
handler
test
1:p1202963914_p3556498_1 test MEDIUM 0 false 0 false -
handler
nn
1:p1202963914_p3520 nn MEDIUM 0 false 0 false -
handler
nn
1:p1202963914_p32_1 MEDIUM 0 false 0 false -
handler
aaa
1:p1202963914_p96321 aaa MEDIUM 0 false 0 false -
handler
Task1
1:p1202963914_p80579372 Task1 MEDIUM 0 false 0 false -
handler
Task1
1:p1202963914_p32_2 MEDIUM 0 false 0 false -
handler
AA
1:p1202963914_p2080 AA MEDIUM 0 false 0 false -
handler
k
1:p1202963914_p107 k MEDIUM 0 false 0 false -
handler
test
1:p1202963914_p3556498_2 test MEDIUM 0 false 0 false -
handler
test
1:p1202963914_p3556498_3 test MEDIUM 0 false 0 false -
handler
test
1:p1202963914_p3556498_4 test MEDIUM 0 false 0 false -
handler
test
1:p1202963914_p3556498_5 test MEDIUM 0 false 0 false -
handler
test
1:p1202963914_p3556498_6 test MEDIUM 0 false 0 false -
handler
test
1:p1202963914_p3556498_7 test MEDIUM 0 false 0 false -
handler
test
1:p1202963914_p3556498_8 test MEDIUM 0 false 0 false -
handler
test
1:p1202963914_p3556498_9 test MEDIUM 0 false 0 false -
handler
test
1:p1202963914_p3556498_10 test MEDIUM 0 false 0 false -
handler
test
1:p1202963914_p3556498_11 test MEDIUM 0 false 0 false -
handler
d
1:p1202963914_p100 d MEDIUM 0 false 0 false -
handler
some item
1:p1202963914_n642421057 some item MEDIUM 0 false 0 false -
handler
some item
1:p1202963914_p32_3 MEDIUM 0 false 0 false -
handler
noijiopp
1:p1202963914_p1271461704 noijiopp MEDIUM 0 false 0 false -
handler
Wave
1:p1202963914_p2688793 Wave MEDIUM 0 false 0 false -
handler
Tim
1:p1202963914_p84088 Tim MEDIUM 0 false 0 false -
handler
test
1:p1202963914_p3556498_12 test MEDIUM 0 false 0 false
My Tasks
-
handler
jkl
1:p2062884890_p105291 jkl MEDIUM 0 false 0 false -
handler
Add
1:p2062884890_p65665 Add MEDIUM 0 false 0 false -
handler
a
1:p2062884890_p97 a MEDIUM 0 false 0 false -
handler
test
1:p2062884890_p3556498 test MEDIUM 0 false 0 false -
handler
help
1:p2062884890_p3198785 help MEDIUM 0 false 0 false -
handler
help
1:p2062884890_p3198785_1 help MEDIUM 0 false 0 false -
handler
help
1:p2062884890_p32 MEDIUM 0 false 0 false -
handler
aa
1:p2062884890_p3104 aa MEDIUM 0 false 0 false
As you can see, we had to change the title of our shopping list as we've already used a shopping list in the previous example. If there are two task lists on the page with the same title, they may fail to work.
Adding tasks to the list
To add a task, just enter the task description in the text box and click the "Add" button:
Your new task will then be added to the bottom of the list:
Prioritising tasks
To set the priority of items in the list, use the mouse to drag them up or down the list:
As the item is moved, you'll see the other items make room for it:
Just drop the item (release the mouse button) when you are happy with it's new location in the list:
or incomplete 
Hints and Tips:
You should always try to specify a title for your task list, even though the parameter is optional.
To make your task list look nicer on-screen, use the center macro to center it horizontally.
Frequently Asked Questions:
| Q | My task list is broken - why? |
|---|---|
| A | Two common reasons:
|
| Q | I've marked all tasks as complete, but the progress bar doesn't show 100% green - why? |
|---|---|
| Q | The progress bar doesn't correctly show the percentage of complete and incomplete tasks - why? |
| A | It's a very rare problem. Just refresh the page you are looking at and it should sort itself out. |
| Q | Can I add sub-tasks? |
|---|---|
| A | No. |
| Q | How do I stop anonymous users from editing my task list? |
|---|---|
| A | Hide it from them. Use the show-to macro with the "user=confluence-users" parameter - that will only show the task list to logged in users. |
Comments (5)
Jul 31, 2006
Anonymous says:
How do I stop the task ordering from changing randomly when the page is refreshe...How do I stop the task ordering from changing randomly when the page is refreshed?
Aug 21, 2006
Anonymous says:
Is there a possibility of allow only certain users or groups to modify the task ...Is there a possibility of allow only certain users or groups to modify the task list?
Feb 13, 2007
Anonymous says:
Is it possible to have a task have a hyperlink to a more detailed task descripti...Is it possible to have a task have a hyperlink to a more detailed task description page?
Mar 07, 2007
Anonymous says:
This macro doesn't work when embedded into a table. The first line appears but i...This macro doesn't work when embedded into a table. The first line appears but it won't let you add new tasks, probably because it cannot redraw the table to accomodate the growing list.
Jan 22, 2008
john futcher says:
There is a more uptodate version of this macro as described on... http://conflu...There is a more uptodate version of this macro as described on...
http://confluence.atlassian.com/display/CONFEXT/Dynamic+Tasklist+2
though note that you have to disable the current versions of 2 plugins - tasklist and dynamictasklist.