[[%TOPIC%ChecklistItemState]]If you have installed the Foswiki:Extensions.SpreadSheetPlugin you can find a statistics on this item state topic. And if you have installed the Foswiki:Extensions.EditTablePlugin you can edit the states directly on this topic.
You type: | You get: (simulated) |
Example 1: Create a simple checklist:
| |
%CHECKLISTSTART% 1 first step 1 second step 1 last step %CHECKLISTEND% |
|
Example 2: Create a simple freehand checklist:
| |
1 first step %CLI% 1 second step %CLI% 1 last step %CLI% |
|
Example 3: Create a checklist with three states and own icons:
| |
%CHECKLISTSTART{states="todo|doing|done" stateicons=":no:|:-I|8-)"}% 1 first step 1 second step 1 third step %CHECKLISTEND% |
|
Example 4: Create two checklists on a topic:
( every %CHECKLIST% and every %CLI% tag needs a name attribute) | |
%CHECKLISTSTART{name="first checklist"}% 1 first step 1 second step %CHECKLISTEND% %CHECKLIST{name="second checklist"}% 1 first step %CLI{name="second checklist"}% 1 next step %CLI{name="second checklist"}% |
|
Example 5: Create a checklist in a table: | |
| *state* | *todo* | | %CLI% | first step | | %CLI% | second step | |
|
Example 6: Create multiple lists with tables and hard linked item states to allow add/insert/remove items:
The %EDITTABLE% and %CHECKLISTSTART% tag have to stay in the same line.
| |
%EDITTABLE{changerows="on" format="|label,0,#%SERVERTIME{$year$month$day$hour$min$sec}%|text,50|"}%%CHECKLISTSTART{name="list1"}% | *STATUS<br/>(click to change)* | *Item* | | #2007Feb07093710 | testitem | %CHECKLISTEND% %EDITTABLE{changerows="on" format="|label,0,#%SERVERTIME{$year$month$day$hour$min$sec}%|text,50|"}%%CHECKLISTSTART{name="list2"}% | *STATUS<br/>(click to change)* | *Item* | | #2007Feb07093712 | second | %CHECKLISTEND% |
|
Example 7: Create a legend and a reset button:
| |
%CHECKLISTSTART{showlegend="on" reset=":-I Reset"}% 1 first step 1 next step %CHECKLISTEND% |
|
Example 8: Create a button to set all states in a checklist to done :
| |
1 first step %CLI% 1 next step %CLI% %CHECKLIST{reset=":ok: set all done @done"}% |
|
Example 9: Insert new items in an existing checklist without state lost:
| |
%CHECKLISTSTART% 1 first step 1 first new inserted item #MyFirstInsertedItem 1 second step 1 second new inserted item %CLI{id="MySecondInsertedItem"}% %CHECKLISTEND% |
|
%CHECKLIST{showlegend="on" reset=":-I Reset checklist"}% %CLI{id="i1"}%
%<plugin>_<setting>%
, i.e. %CHECKLISTPLUGIN_STATES%
working/logs/debug.log
) todo¦done
and :-I¦:ok:
; remove # for setup): off
) on
) %RED% Sorry, some parameters are unknown: %UNKNOWNPARAMSLIST% %ENDCOLOR% <br/> Allowed parameters are (see System.ChecklistPlugin topic for more details): %KNOWNPARAMSLIST%
) off
; old bevavior: on
) off
): Set TEMPLATE_template name_attribute name = attribute value
Template Usage: %CLI{template="template name"}%
(the same for %CHECKLISTSTART%
, %CHECKLIST%
).
Examples:
cd /path/to/foswiki perl tools/extension_installer <NameOfExtension> installIf you have any problems, or if the extension isn't available in
configure
, then you can still install manually from the command-line. See https://foswiki.org/Support/ManuallyInstallingExtensions for more help.