= Add database-backed checklists anywhere there's a wiki. =

-------------
= -- IMPORTANT!!! -- IMPORTANT!!! -- IMPORTANT!!! -- =

This plugin is now deprecated in favor of the better (and more flexible) TracFormsPlugin, which aims for general form support instead of just checklists.  Unfortunately, I don't have a conversion script (yet), but might build one if folks need it.  For now, if you're about to install the ChecklistPlugin, use TracFormsPlugin instead...
-------------

== Description ==

Place a checklist into any wiki entry area.  The checklist will automatically associate the page (if desired), a subsection, and the current values with the database.  As items get checked, the associated user and date/time are also recorded.

== Bugs/Feature Requests == 

Existing bugs and feature requests for ChecklistPlugin are [query:status!=closed&component=ChecklistPlugin&order=priority here].

If you have any issues, create a 
[/newticket?component=ChecklistPlugin&owner=rharkins new ticket].

== Download and Source ==

Download the [download:checklistplugin zipped source], check out [/svn/checklistplugin using Subversion], or [source:checklistplugin browse the source] with Trac.

== Example ==

Here's the theory (we'll see how this works):

{{{
 {{{
 #!Checklist
 #
 #   Make sure commits are done
 #
 -section=svn

 || [cl:{tagged}] || [cl:who{tagged}] || [cl:when{tagged}] || Code is tagged
 || [cl:{merged}] || [cl:who{merged}] || [cl:when{merged}] || Code is merged, version {[cl:req:5{merged:version}]}
 || [cl:{installed}] || [cl:who{installed}] || [cl:when{installed}] || Code is installed
 }}}
}}}

== Installation ==

Do the normal package installation steps (python setup.py bdist_egg or python setup.py install) and add to your trac.ini: 

 trac_checklist.* = enabled


== Permissions ==

'''Permissions are still pretty green yet'''

Controlling who can set/unset specific checkboxes is controlled by the '''[cl:can-set:RIGHT{FIELD}]''', '''[cl:can-get:RIGHT{FIELD}]''', and '''[cl:can-change:RIGHT{FIELD}]''' markers.  Defaults can be provided to the entire checklist by using '''-can-set=RIGHT''', '''-can-get=RIGHT''', and '''-can-change=RIGHT''' options in the header area.  RIGHT is any Trac permission and defaults to anyone.

== What's NOT done ==

 * See that cl:req thing up there?  That's not done.
 * It'd be nice to have more control over cl:when.
 * Maybe some easy way to generate these table rows someday...

== Recent Changes ==

[[ChangeLog(checklistplugin, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:rharkins] [[BR]]
'''Contributors:'''