Create a data form definition

See Data Form, specifically the section Defining a form

As an example we will create the topic "ReadingForm" with these contents:

| *Name*   | *Type* | *Size* | *Values* | *Tooltip message* | *Attributes* |
| Title    | text   | 80     |          | Book or article title | |
| Category | select | 1      | ,Interesting,Remarkable,So-so | How you rate this reading material | |
| Author   | text   | 50     |          | Author's last name | |

Enable the form

Add the form in the list of Web forms. This is done by setting the preference WEBFORMS in the Web's WebPreferences (a comma separated list).

If you create a topic, you can always add a form to the topic by choosing "Add form" in the edit screen.

Now we will create an HTML form that does this automatically.

Create an HTML form for easy topic creation

HTML forms have nothing to do with data forms, except that they are a way to create topics with pre-defined values.

Example HTML form:

<form action="%SCRIPTURLPATH{edit}%/%WEB%/" method="post">
Name of the new topic: %BR%
<input type="text" name="topic" class="foswikiInputField" size="32" />

Title of article or book: %BR%
<input type="text" name="Title" class="foswikiInputField" size="32" />

<input type="submit" class="foswikiSubmit" value="Create topic" />
<input type="hidden" name="onlywikiname" value="on" />
<input type="hidden" name="formtemplate" value="ReadingForm" />
<input type="hidden" name="topicparent" value="%TOPIC%" />
</form>

Create a query search

VarSEARCH has more information on creating searches.

To list all topics that have a form named ReadingForm:

%SEARCH{
type="query"
"TestForm"
nonoise="on"
format="   * [[$web.$topic][$formfield(Title)]]"
}%

To list all topics where the author is named "Auden":

%SEARCH{
type="query"
"TestForm[name='Author'].value='Auden'"
nonoise="on"
format="   * [[$web.$topic][$formfield(Title)]]"
}%