[[TOC]] = Provides forms anywhere there is a wiki = || [download:tracformsplugin Download] || [wiki:TracFormsPlugin/Docs Documentation] || [source:tracformsplugin Browse Source] || [report:9?COMPONENT=TracFormsPlugin Features & Bugs] || [http://trac-hacks.org/newticket?component=TracFormsPlugin&owner=rharkins Report an Issue] || [wiki:TracFormsPlugin/Guestbook Guestbook] == Description == This plugin aims to allow for forms anywhere there is a wiki. This is meant to supersede the previously limited-scope ChecklistPlugin. ''If you're using TracFormsPlugin, why not stop in and sign the [wiki:TracFormsPlugin/Guestbook Guestbook] and tell us how you're using it?'' == Release Status == || Stable Version || tags/tracforms-0.1.2 || || Under Development || branches/tracforms-0.2 || [[source:tracformsplugin/trunk trunk]] will always mirror the current stable version. == Example and [wiki:TracFormsPlugin/Docs Documentation] == '''''Also consider viewing the online [wiki:TracFormsPlugin/Tutorial tutorial] or the [wiki:TracFormsPlugin/Docs documentation] (docs still under development)''''' Let's start by looking at a simple laundry list. This list will be automatically bound to whatever page it appears in by default (this can be configured). Once the plugin is installed, simply edit a new wiki resource called Sandbox/LaundryList and chuck this in: {{{ == Laundry list example == {{{ #!TracForm # # An example of a TracForm. The first lines can be commentary or #! commands. # #! track_fields || || '''Who''' || '''When''' || '''What''' || || [tf:wash] || [tf.who:wash] || [tf.when:wash] || Wash Clothes || || [tf:dry] || [tf.who:dry] || [tf.when:dry] || Dry Clothes || || [tf:fold] || [tf.who:fold] || [tf.when:fold] || Fold Clothes || }}} }}} Once saved, you should get something looking like this: [[Image(LaundryList.jpg)]] From here, you can check some things and click "Submit Query" you'll see the fields change. After a few clicks it might look like this: [[Image(LaundryList2.jpg)]] Now, if you thought that was neat, make sure you have the IncludeMacro installed and fire up a new wiki page Sandbox/LaundryListUser with the following: {{{ [[Include(Sandbox/LaundryList)]] }}} Note that the form is blank and you can play with the results again. This is because the default context for the form is the page URL itself! That means that as long as a form is included on a different page (and the default context is not overridden), then each page including gets its '''own''' version of the form's results. This works particularly well with PageTemplates. Now, for more fun, do the same thing in a ticket. Once submitted, every ticket including the template will contain it's own checklist. One obvious use for this is when creating a svn commit checklist. Simply put the checklist in the appropriate wiki location, create tickets that include the location, and voila, instant commit step-by-step. Once enough of the form becomes exposed, we should be able to work this into the workflow too (no resolving before at least paying lip service to the checklist). There is much more planned for this plugin than simply checklists. See [wiki:TracFormsPlugin/Docs] for more information on the various ways to use this tool. == Bugs/Feature Requests == Existing bugs and feature requests for TracFormsPlugin are [report:9?COMPONENT=TracFormsPlugin here]. If you have any issues, create a [http://trac-hacks.org/newticket?component=TracFormsPlugin&owner=rharkins new ticket]. == Download == Download the zipped source from [download:tracformsplugin here]. == Source == You can check out TracFormsPlugin from [http://trac-hacks.org/svn/tracformsplugin here] using Subversion, or [source:tracformsplugin browse the source] with Trac. == Installation == Once you have downloaded the source, do the following (your mileage may vary on the actual directory names depending on what you downloaded): {{{ #!sh cd tracformsplugin cd trunk cd 0.11 }}} For older versions or ones still in development, cd into tags and then into the desired version. For example, to use the 0.1 version: {{{ #!sh cd tracformsplugin cd tags cd release-0.1 cd 0.11 }}} === Method 1: Lay an egg === From here, you can do one of two things. The first is building an egg to drop into your project's plugins directory or your master project's plugins directory (replace or define $TRACENV_DIR with your project's base directory): {{{ #!sh python setup.py bdist_egg cp dist/TracForms-0.1-*.egg $TRACENV_DIR/plugins/ }}} === Method 2: Full install === Or, you can build and install and enable the right bit in the configuration file (replace or define $TRACENV_DIR with your project's base directory): {{{ #!sh python setup.py install vi $TRACENV_DIR/conf/trac.ini }}} Within here, locate (or create) your [components] section and add the following: {{{ [components] tracforms.* = enabled }}} === Upgrading the database === Either of the above methods require a database upgrade... {{{ #!sh trac-admin $TRACENV_DIR upgrade }}} == Recent Changes == [[ChangeLog(tracformsplugin, 3)]] == Author/Contributors == '''Author:''' [wiki:rharkins] [[BR]] '''Contributors:'''