redFORM:Creating and managing fields

From redWIKI
Jump to: navigation, search

Contents

Adding fields to forms

Once the form has been created and its basic details filled out, the next step is to create the fields that will appear in the form for people to fill out. redFORM can display up to 17 different types of fields, and it is a simple process to assign fields to forms.

NEW in redFORM 3: Fields are no longer locked to a specific form. You can now re-use fields in multiple forms. In our earlier versions of redFORM for joomla 1.5 and 2.5 the fields had to be created for each form.
In redFORM 3 we have changed that behaviour and fields now live on their own.

3redform fields overview.png

This new approach Means that you can create your fields first, and later on add the fields to a from.
So when you have created the fields you want to use you can go to Forms and enter the specific form where you at the fields tab can add new fields.

3redform fields assign to form.png

Available field types

When adding a new field or editing an existing one, there are several options available to configure its function and presentation. To start with the field needs a name or label, as it will be displayed on the form. Adding a "Field header" is optional, "this will be used in tables instead of the full field text".

3redform field new.png

You can then choose the type of field this will be. There are 17 types and some have additional parameters unique to them. redFORM reloads the "Edit Field" screen whenever the field type changes, in order to make sure that those additional parameters are available. As such, the field name must be filled in and the form selected in order to update the field type.

Settings shared by all fields include:

Other settings shared by all fields include (shown when adding field to form):

Note: when using redFORM to collect payments, you can assign price values to the options of specific field types. These include Select, Multi-Select, Checkbox, Radio, Price, Info, and Recipients. In essence, you can use these field types to present options worth different amounts of money, and add together the sum of all selected options. If the "show total price" setting has been enabled, the value for the total price will update with every option selected.

3redform fields shared addtoform2.png


Text-based fields

Text Field

Displays a text area box, similar to the input box, whose size is controlled by the number of "columns" and "rows"

RedFORM---Field-type,-textfield.jpg

Text Area

Displays a simple input box where visitors can type in the details; you can change the width of the box and the maximum number of characters that can be stored

RedFORM---Field-type,-textarea.jpg

WYSIWYG

Displays a text area box with a WYSIWYG control panel; useful when people need extra formatting options or linking facilities when filling in their answer.

RedFORM---Field-type,-wysiwyg.jpg



Selection fields

Checkbox

Presents a set of options with checkboxes for visitors to pick; multiple-choice

RedFORM---Field-type,-checkbox.jpg

Radio buttons

Presents a set of options as radio buttons for visitors to pick from; single choice

RedFORM---Field-type,-radio.jpg

Select Dropdown

Presents a set of options as a drop-down; single choice

RedFORM---Field-type,-select.jpg

Multi-Select

Presents a set of options within a multi-select panel; multiple-choice

RedFORM---Field-type,-multiselect.jpg



User information fields

If the user has an account on the site and is logged in prior to filling the form, these three field types will be auto-populated with the account email address, username and full name respectively. You can change the width of the box and the maximum number of characters that can be stored for each.

Full Name

Displays an input box where visitors can type in their full name

RedFORM---Field-type,-fullname.jpg

Username

Displays an input box where visitors can type in their username

RedFORM---Field-type,-username.jpg

E-Mail Address

Displays an input box where visitors can type in their e-mail address

RedFORM---Field-type,-emailaddress.jpg

The "E-mail" field type can also take advantage of any redFORM newsletter integration plugins that have been installed. As of latest release, redFORM has four available newsletter plugins: AcyMailing, CCNewsletter, jNews and the open source mailing list PHPList. These plugins have no special parameters to configure, except for the PHPList plugin which simply needs the path to the folder where PHPList is installed.

Each "E-mail" field can offer the option to sign-up to one or more newsletter mailing lists for one of the available plugins. Simply select the newsletter component and add the label for each mailing list, exactly as it is written. You can add and remove lists one at a time using the appropriately labeled links. Note that separate "E-mail" fields will be required to displays lists for each newsletter component.

Finally, the "E-mail" field can be configured to automatically subscribe the user's email address to the newsletter mailing lists instead of offering them the choice, In addition, a notification email can be sent to the address if need be.



Special purpose fields

Date

Displays an input box and a calendar from which to pick a date; the format in which the date is displayed can be changed using the "Date format" field and the %Y-%m-%d variables.

RedFORM---Field-type,-date.jpg


File Upload

Displays an input box with a "Browse" button that will allow visitors to upload files and attach them to their submissions. File attachments are stored in the {root}/images/redform folder, although this path can be changed in redFORM's configuration settings. You can also add a filter for the types of files that are allowed to be uploaded and attached; simply enter a comma-separated list of allowed file extensions (for example "ini, doc, xls, csv") or leave empty to disable filtering.

RedFORM---Field-type,-fileupload.jpg


Recipient

Displays a dropdown list with the names of people or departments who should receive a copy of this form; you can add people and email addresses as field options by filling in their name or department as the "label" and the email address as the "value".

RedFORM---Field-type,-recipient.jpg


Price

Info

Integer list

redMEMBER integration

If redMEMBER is installed on your Joomla! website, you can assign the contents of a redMEMBER field to the corresponding or equivalent redFORM field.



Back to overview

Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox