wiki:TracFormsPlugin/Docs

Version 2 (modified by rharkins, 6 years ago) (diff)

--

Introduction

TODO: Pontificate on the merits of forms in wikis...

TracForm Configuration

TracForm Environment

Using the #!setenv command above, you can retrieve previously defined elements with %NAME% (case insensitive). Other environment variables are also defined by the system:

Variable Version Meaning
%USER% 0.1+ The currently active user
%NOW% 0.1+ The current date and time

TracForm Operations

Within the TracForm, you can use the following commands with [tf.OP:arg...] blocks:

Operation Version Argument(s) Meaning
tf.checkbox 0.1+ name [value] Put an HTML checkbox here. Use value only if specified (on is default).
tf.radio 0.1+ name value Put an HTML checkbox here. Use the name and value pair together.
tf.input 0.1+ name default Put an HTML form input field here.
tf.who 0.1+ name Show which user most recently affected the specified field. This requires track_fields to be set in the commands section.
tf.when 0.1+ name [strftime format string] Show when the most change was made on the specified field. This requires track_fields to be set in the commands section.
tf.form_updater 0.1+ Show the most recent updater of the form itself.
tf.form_updated_on 0.1+ [strftime format string] Show when the form was most recently updated.