PloneFormGen fields and content objects

« Return to page index

A guide to PloneFormGen's standard fields, adapters and other content objects.

1. PloneFormGen Form Fields

The basic form fields that PloneFormGen provides

Following are the basic form field content types that PloneFormGen provides:

 

Boolean Field
A true/false field, which will be rendered as a checkbox widget.
Date/Time Field
A field to store date/time values.  Will render with the standard Plone date/time widget.
File Field
Allows you to upload a file. Files will be e-mailed as attachments by the mail adapter.
Fixed-Point Field
Use this when you want a numeric response that might include a decimal point.
Integer Field
A field for storing a normal integer.  This is the best field to use for simple numerical responses.
Label Field
A simple label and help text with no data-entry field.
Lines Field
A field that allows the user to submit multiple lines of text.  The save-data adapter will separate lines with newline codes.
Multi-Select Field
A field that allows the user to choose one or more values from a list.  Can render using a multi-select box or as a list of checkboxes.  (The latter is generally more usable.)
Password Field
A field that displays "*" when the user types; good for submitting passwords or other sensitive data.
Rich Label Field
A field with no input, just a HTML-formatted label.  Useful for adding descriptive text to your form.
Selection Field
A field that lets a user choose a single value from a list.  Can render as a selection list, a dropdown menu or as a list of radio buttons.
String Field
A field that lets a user input a single line of text.  This is the standard general-purpose text field.
Text Field
A field that lets a user submit a longer chunk of text.  Renders as a multi-line text box.
 
 

 


 

2. Action Adapters

PloneFormGen action adapters

Custom Script Adapter
Allows you to write python scripts for simple form actions without having to use the Zope Management Interface.
Mailer Adapter
An adapter that emails form submissions to one or more users.  It can optionally encrypt the emails using GPG encryption, if it is installed on your system.
Save Data Adapter
An adapter that saves form submissions inside the form.  Lets you view the results on-screen, and download as Tab- or Comma-delimited text.

Programmers, please note that PloneFormGen action adapters are not the same as Zope 3 adapters. They are content objects.

3. Other content objects

Other miscellaneous PloneFormGen content objects

 

Fieldset Folder
Lets you render sets of fields on your form.  It's a folderish objects into which you can place fields.  Each Fieldset Folder will render as an HTML <fieldset> in the form.  This is useful for giving your forms different sections and structure.
Image
A normal Plone image, which you may want to reference in your form, perhaps in a Rich Label Field, a Page or a Thanks Page.
Page
A normal Plone page. You may use these as "thanks" pages if you don't need to display input.
Thanks Page
A page which will be displayed to the user after they submit the form.  You can create multiple Thanks Pages, and use logic to choose which one the user receives.