Version 25 (modified by 16 years ago) (diff) | ,
---|
Hey You! Don't use this yet!!!
Notice: This plugin is unmaintained and available for adoption.
Table of Contents
Provides forms anywhere there is a wiki
Description
This plugin aims to allow for forms anywhere there is a wiki. This is meant to supersede the previously limited-scope ChecklistPlugin.
Example
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 || || '''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:
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:
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. Now, for more fun, do the same thing in a ticket. Including a wiki form structure will work especially well with a PageTemplate.
There is much more planned for this plugin than simply checklists. See TracFormsPlugin/Docs for more information on the various ways to use this tool.
Bugs/Feature Requests
FOR NOW, PLEASE DON'T BOTHER SUBMITTING ANYTHING. THIS ISN'T TRULY RELEASED YET.
Existing bugs and feature requests for TracFormsPlugin are here.
If you have any issues, create a new ticket.
Download
Download the zipped source from [download:tracformsplugin here].
Source
You can check out TracFormsPlugin from here using Subversion, or 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):
cd tracformsplugin cd trunk 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):
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):
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...
trac-admin $TRACENV_DIR upgrade
Recent Changes
- 16960 by rjollos on 2017-11-06 23:38:37
-
TracForms 0.5dev: Remove debug
print
statement from r16386
Refs #13319.
- 16958 by rjollos on 2017-11-04 22:59:37
-
TracForms 0.5dev: Log exception from macro
Refs #13319.
- 16954 by rjollos on 2017-11-03 17:41:27
-
TracForms 0.5dev: Show traceback on exception
Refs #13319.
(more)
Author/Contributors
Author: rharkins
Contributors:
Attachments (2)
-
LaundryList.jpg (11.9 KB) - added by 16 years ago.
Example of blank laundry list
-
LaundryList2.jpg (15.3 KB) - added by 16 years ago.
Example after a few checks.
Download all attachments as: .zip